scrnselect - selects the screen upon which new windows are placed
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).
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.
dglopen, getgdesc, ginit, gversion, scrnattach, winopen, xdpyinfo(1)
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.
PPPPaaaaggggeeee 1111 [ Back ]