scrnse(3G)

NAME
     scrnse - selects the screen upon which new windows are placed

FORTRAN 77 SPECIFICATION
     integer*4 function scrnse(gsnr)
     integer*4 gsnr

PARAMETERS
     gsnr   expects the number of a screen controlled by the currently
            selected graphics server.

FUNCTION RETURN VALUE
     The function returns the previously selected screen, or -1 if there was
     an error (e.g., gsnr is not a valid screen number).

DESCRIPTION
     scrnse selects the screen upon which a subsequent winope, ginit, gbegin,
     creates a window.  It also selects the screen to which getgde and gversi
     inquiries refer.  The screen number must correspond to a window
     controlled by the currently selected graphics server.  The default is
     screen number zero.  If set, the environment variables DISPLAY,
     DGLSERVER, and REMOTEHOST are checked (except when using the DGL library)
     in that order, to override this default.

     On error, scrnse leaves the current screen selection unchanged.

     You can call scrnse prior to graphics initialization.

SEE ALSO
     dglope, getgde, getwsc, ginit, gversi, winope, scrnat, xdpyinfo(1)

NOTES
     This routine is available only in immediate mode.

     Use getgde(GDNSCR) to determine the number of screens available on the
     currently selected graphics server.