scrnselect(3G)

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

C SPECIFICATION
     long scrnselect(gsnr)
     long 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
     scrnselect selects the screen upon which a subsequent winopen, ginit,
     gbegin, creates a window.  It also selects the screen to which getgdesc
     and gversion 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, scrnselect leaves the current screen selection unchanged.

     You can call scrnselect prior to graphics initialization.

SEE ALSO
     dglopen, getgdesc, ginit, gversion, scrnattach, winopen, xdpyinfo(1)

NOTES
     This routine is available only in immediate mode.

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