GPHIGS C FUNCTIONS - INQUIRE DEPTH CUE REPRESENTATION

INQUIRE DEPTH CUE REPRESENTATION

PINQ_DEPTH_CUE_REP

CALL SEQUENCE

void pinq_depth_cue_rep(

Pint	ws_id,	/* workstation identifier	*/
Pint	index,	/* depth cue index	*/
Pinq_type	type,	/* type of returned values	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pdepth_cue_rep	*rep	/* (out) depth cue representation	*/

TYPES

typedef enum {
	PINQ_SET,
	PINQ_REALIZED
} Pinq_type ;

typedef struct{
	Pdepth_cue_mode	mode;	/* depth cue mode */
	Pfloat	ref_planes[2];	/* reference planes */
	Pfloat	scale[2];	/* scale factors */
	Pgcolr	colr;	/* colour */
} Pdepth_cue_rep;

PHIGS STATE

(PHOP, WSOP,*,*)

EFFECT

Returns the components contained in the depth cue representation of the depth cue table in workstation ws_id's workstation state list. If the data is available, error indicator is returned as 0.

If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters.

If the specified depth cue index is not present in the depth cue table, and the specified type of returned value is REALIZED, the representation for depth cue index 1 is returned.

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
54: Ignoring function, the specified workstation is not open
59: Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)
101: Ignoring function, the specified representation has not been defined
119: Ignoring function, the specified depth cue mode is not available on the workstation