swinop(3G)

NAME
     swinop - creates a graphics subwindow

FORTRAN SPECIFICATION
     integer*4 function swinop(parent)
     integer*4 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 swinop
              or winope.

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
     swinop 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 swinop, the application must call winpos 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.

     swinop queues the pseudo devices INPTCH and REDRAW.

SEE ALSO
     greset, winclo, winget, winope, winpos, winset