scrnselect(3G)							scrnselect(3G)

NAME    [Toc]    [Back]

     scrnselect	- selects the screen upon which	new windows are	placed

C SPECIFICATION    [Toc]    [Back]

     long scrnselect(gsnr)
     long gsnr;

PARAMETERS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

     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