swinopen(3G)

NAME
     swinopen - creates a graphics subwindow

C SPECIFICATION
     long swinopen(parent)
     long parent;

PARAMETERS
     parent   expects the GID (graphics window identifier) of the window (or
              subwindow) in which you want to open a subwindow.  The GID is
              the returned function  value of a previous call to either
              swinopen or winopen.

FUNCTION RETURN VALUE
     The returned value of this function is either a -1 or the graphics window
     identifier for the subwindow just created.  Use this value to identify
     this subwindow to other graphics routines.

     A returned function value of -1 indicates that the system cannot create
     any more graphics windows.

DESCRIPTION
     swinopen creates a graphics subwindow. The graphics state of the new
     subwindow is initialized to its defaults (see greset) and it becomes the
     current window.

     Subwindows have no window borders or window manager function buttons.
     Window constraints do not apply to subwindows.  A subwindow is
     repositioned automatically when its parent is moved, so that its origin
     with respect to the parent's origin remains constant.  Resizing the
     parent does not automatically resize a subwindow, but keeps the distance
     between the upper left hand corners constant.  Imaging in a subwindow is
     limited (clipped) to the area of the parent window.

     After calling swinopen, the application must call winposition to specify
     the location of the subwindow's boundaries with respect to the origin of
     its parent window.

     If parent is the GID of a subwindow, the parent of that subwindow becomes
     the parent of the new subwindow for the purpose of positioning the
     subwindow.

     When using the DGL (Distributed Graphics Library), the graphics window
     identifier also identifies the graphics server associated with the
     window.

     swinopen queues the pseudo devices INPUTCHANGE and REDRAW.

SEE ALSO
     greset, winclose, winget, winopen, winposition, winset