INQUIRE VIEW REPRESENTATION

PXINQ_VIEW_REP

CALLING SEQUENCE

pxinq_view_rep (

Pint	ws_id	/*workstation identifier	*/
Pint	index	/*view index	*/
Pint	*error_ind	/*error indicator	*/
Pupd_st	*update_state	/*viewing transformation update state	*/

PUPD_NOT_PEND	not pending
PUPD_PEND	pending

Pxview_rep3	*cur_rep	/*current extended view representation	*/
Pxview_rep3	*req_rep	/*requested extended view representation	*/

)

TYPES

typedef struct {
	Pmatrix3		ori_matrix;	/* view orientation matrix	*/
	Pmatrix3		map_matrix;	/* view mapping matrix	*/
	Plimit3		clip_limit;	/* view clipping limits in NPC	*/
	Pclip_ind		xy_clip;	/* X-Y clipping indicator	*/
	Pclip_ind		back_clip;	/* back clipping indicator	*/
	Pclip_ind		front_clip;	/* front clipping indicator	*/
	Pxopacity	opacity;	/* view shield indicator	*/
	Pint			back_colr;	/* view shield color index	*/
	Pxoutline		outline;	/* viewport outline indicator	*/
	Pint			out_colr;	/* outline color index	*/
	Pxtemporary	temporary;	/* temporary view indicator (reserved)	*/
	Pxview_ind	active;	/* view active indicator	*/
} Pxview_rep3 ;

typedef enum {
	PIND_NO_CLIP,		/* no clipping	*/
	PIND_CLIP		/* clipping	*/
} Pclip_ind;

typedef enum {
	PXOPACITY_ON,		/* view shield on (opaque)	*/
	PXOPACITY_OFF		/* view shield off (transparent)	*/
} Pxopacity;

typedef enum {
	PXOUTLINE_OFF,		/* no outline	*/
	PXOUTLINE_ON 		/* outline	*/
} Pxoutline;

typedef enum {
	PXPERMANENT,		/* permanent	*/
	PXTEMPORARY		/* temporary	*/
} Pxtemporary;
typedef enum {
	PXVIEW_ACTIVE,		/* active	*/
	PXVIEW_INACTIVE		/* inactive	*/
} Pxview_ind;

EFFECT

This inquiry function returns the specified extended view representation from the workstation state list. Viewing Transformation Update State indicates whether a pending view definition exists for the specified view index. If no view definition is pending, then the current and requested view representations contain identical information.

ERRORS

3

Ignoring function, function requires state WSOP.

54

Ignoring function, the specified workstation is not open.

150

Ignoring function, setting this view table entry would exceed the maximum number of entries allowed in the workstation's view table.

SEE ALSO

View display priority, see pxset_view_disp_pri

View index, see pset_view_ind

View mapping matrix, see peval_view_map_matrix, peval_view_map_matrix3

View orientation matrix, see peval_view_ori_matrix, peval_view_ori_matrix3

View representation, see pset_view_rep, pset_view_rep3

View transformation input priority, see pset_view_tran_in_pri

Inquire view index, see , pinq_list_view_inds

Inquire view representation, see pinq_view_rep

Inquire viewing facilities, see pinq_view_facs