GPHIGS C FUNCTIONS - INQUIRE WINDOW PARAMETERS

INQUIRE WINDOW PARAMETERS

PXINQ_WINDOW_PARAMS

CALL SEQUENCE

void pxinq_window_params(

Pint	ws_id,	/* workstation identifier	*/
Pint	ws_type, 	/* workstation type	*/
Display	*display,	/* pointer to the X Display structure	*/
Pint	*error_ind, 	/* error indicator	*/
Pint	*depth,	/* depth to use to create the window	*/
Visual	**visual,	/* visual type to use to create the window	*/
Colormap	*colormap	/* colormap to use to create the window	*/

PHIGS STATE

(PHOP,WSOP,*,*)

EFFECT

Depending on the workstation type and the X11 server capabilities, GPHIGS selects the best X11 attributes when it creates a X11 window during OPEN WORKSTATION. For example 3D drivers need often a 24 bits depth window with a TrueColor visual whereas X11 outputs are realized in 8 bits PseudoColor windows.

This choice is realized automatically by GPHIGS if it creates its own window.

When an application wants to create its own window and ask GPHIGS to draw inside using SET X-WINDOW IDENTIFIER, this function can be used to get the X-Window information corresponding to the workstation type and the display.

If the inquired information is available, the depth, visual and colormap attributes necessary to create a X-Window usable by GPHIGS are returned and the error indicator error_ind is returned as 0.

This information is available only if the workstation type is one of X11, PEX, GLX, XGL.

NOTE: In the special case of GLX (7177)on Silicon Graphics workstations, this function must be called before creating the window and the information must be used for the window creation otherwise GLX returns an error.

The GPHIGS Motif Widget uses this function and creates the window according to the returned information.

The C types Display , Visual and Window are defined in X11/Xlib.h.

ERRORS