.\" @(#)PEXGetWorkstationViewRep.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetWorkstationViewRep 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetWorkstationViewRep - Get Workstation View Representation
.SH SYNTAX
.HP
Status PEXGetWorkstationViewRep\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, unsigned int \fIindex\fP\^, int *\fIupdate_return\fP\^, PEXViewRep *\fIreq_view_return\fP\^, PEXViewRep *\fIcur_view_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIworkstation\fP 1i
The resource identifier of the workstation.
.IP \fIindex\fP 1i
The view table index.
.IP \fIupdate_return\fP 1i
Returns the update status of the view table index.
.IP \fIreq_view_return\fP 1i
Returns the requested value of the view table index.
.IP \fIcur_view_return\fP 1i
Returns the current value of the view table index.
.SH RETURNS
.LP
Zero if unsuccessful, non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXGetWorkstationViewRep
.IX "Workstation" "PEXGetWorkstationViewRep"
.LP
The function returns the update state, and the requested and current
values for the specified view index of the specified workstation.
The update will be
.B PEXPending
if a view change has been requested but not established; otherwise it will be
.B PEXNotPending .
If the specified
view index is not defined, an error will be generated and the contents of the
reply parameters will be undefined.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.sp
typedef struct {
	PEXTableIndex		index;
	unsigned short		reserved;
	PEXViewEntry		view;
.br
} PEXViewRep;
.sp
typedef  unsigned short	PEXTableIndex;
.sp
typedef struct {
	unsigned short		clip_flags;
	unsigned short		reserved;
	PEXNPCSubVolume	clip_limits;
	PEXMatrix		orientation;
	PEXMatrix		mapping;
.br
} PEXViewEntry;
.sp
typedef struct {
	PEXCoord	min;
	PEXCoord	max;
.br
} PEXNPCSubVolume;
.sp
typedef struct {
	float	x;
	float	y;
	float	z;
.br
} PEXCoord;
.sp
typedef  float	PEXMatrix[4][4];
.fi
.SH ERRORS
.TP
.SB BadPEXWorkstation
The specified \fIworkstation\fP resource identifier is invalid.
.TP
.SB BadValue
The specified view table entry is not defined.
.SH SEE ALSO
.LP
.nf
.BR PEXSetWorkstationViewRep (3)
.fi