.\" @(#)PEXTransformPoints4D.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXTransformPoints4D 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXTransformPoints4D - utility function
.SH SYNTAX
.HP
void PEXTransformPoints4D\^(\^PEXMatrix \fItransform\fP, int \fIcount\fP, PEXCoord4D *\fIpoints\fP, PEXCoord4D *\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 4D 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 PEXTransformPoints4D
.LP
This function applies the specified homogeneous transformation
matrix to the list of 3D homogeneous
.I points
(P = x, y, z, 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', z', 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 PEXTransformPoints2DH (3)
.fi