.\" @(#)PEXViewMappingMatrix2D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXViewMappingMatrix2D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXViewMappingMatrix2D - utility function
.SH SYNTAX
.HP
int PEXViewMappingMatrix2D\^(\^PEXCoord2D *\fIframe\fP, PEXCoord2D *\fIviewport\fP, PEXMatrix3x3 \fImatrix_return\fP\^)
.SH PARAMETERS
.IP \fIframe\fP 1i
Array of 2 2D VRC locations which mark a rectangle to be mapped into the NPC
subvolume.
.IP \fIviewport\fP 1i
Array of 2 2D NPC coordinates with z = 0 specifying lower left and upper right
of the
.I viewport.
.IP \fImatrix_return\fP 1i
Matrix in which result is stored.
.SH RETURNS
.LP
Zero if successful; otherwise, one of the following:
.LP
.RS
.nf
\fBPEXBadLimits\fP
\fBPEXBadViewport\fP
.RE
.fi
.SH DESCRIPTION
.\" indexing
.IX PEXViewMappingMatrix2D
.LP
This function is a 2D shorthand version of
.BR PEXViewMappingMatrix (3)
with the following parameters assumed:
.LP
.RS
.nf
front plane distance = 1
back plane distance = 0
view plane distance = 0
viewport z range = [0,1]
projection type = parallel
x-y coordinates of projection reference point = center of view window,
.br
z coordinate = 1.0.
.RE
.fi
.LP
When specifying NPC, the X, Y and Z limits must be as follows:
.LP
.RS
xmin < xmax ,  ymin < ymax , zmin <= zmax
.RE
.SH ERRORS
.LP
None
.SH SEE ALSO
.LP
.nf
.BR PEXViewMappingMatrix (3)
.BR PEXViewOrientationMatrix (3)
.BR PEXViewOrientationMatrix2D (3)
.fi