.\" @(#)PEXTransformPoints2DH.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXTransformPoints2DH 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXTransformPoints2DH - utility function
.SH SYNTAX
.HP
void PEXTransformPoints2DH\^(\^PEXMatrix3x3 \fItransform\fP, int \fIcount\fP, PEXCoord *\fIpoints\fP, PEXCoord *\fIpoints_return\fP\^)
.SH PARAMETERS
.IP \fItransform\fP 1i
The transformation matrix to apply to the points.
.IP \fIcount\fP 1i
The number of points to transform.
.IP \fIpoints\fP 1i
A pointer to an array of 2D homogeneous points to transform.
.IP \fIpoints_return\fP 1i
A pointer to an array in which to store the transformed points.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXTransformPoints2DH
.LP
This function applies the specified homogeneous transformation
matrix to the list of 2D homogeneous
.I points
(P = x, y, w). The transformation is applied:
.LP
.RS
P' = TxP
.RE
.LP
Where P is the point, treated as a column vector, and T is the
transformation matrix.  The function returns P' = (x', y', w').
.LP
If the return array is the same as the input array, the function will
overwrite the input values with the transformed values.
.SH ERRORS
.LP
None
.SH SEE ALSO
.LP
.nf
.BR PEXTransformPoints (3)
.BR PEXTransformPoints2D (3)
.BR PEXTransformPoints4D (3)
.fi