scrnselect(3G)scrnselect(3G)NAMEscrnselect - 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).
DESCRIPTIONscrnselect 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.
Page 1