20 Transforming Points and Vectors

20 Q3Point3D_To4DTransformArray

You can use the Q3Point3D_To4DTransformArray function to apply a transform to each point in an array of three-dimensional points, while changing the dimension of each point from three to four dimensions.

TQ3Status Q3Point3D_To4DTransformArray (
const TQ3Point3D *inVertex, 
const TQ3Matrix4x4 *matrix, 
TQ3RationalPoint4D *outVertex, 
long numVertices, 
unsigned long inStructSize, 
unsigned long outStructSize);
inVertex A pointer to an array of three-dimensional points. This is the source array.
matrix A 4-by-4 matrix.
outVertex A pointer to an array of four-dimensional points. This is the destination array.
numVertices The number of vertices.
inStructSize The size of an element in the source array. Effectively, this is the distance, in bytes, between successive points in the source array.
outStructSize
The size of an element in the destination array. Effectively, this is the distance, in bytes, between successive points in the destination array.

DESCRIPTION


The Q3Point3D_To4DTransformArray function returns, in the outVertex parameter, an array of four-dimensional points, each of which is the result of changing the dimensionality of a point in the inVertex array from three to four and multiplying by the matrix transform matrix. The outVertex array contains the same number of points (that is, vertices) as the inVertex array, as specified by the numVertices parameter. The inStructSize and outStructSize parameters specify the sizes of an element in the inVertex and outVertex arrays, respectively.

DESCRIPTION

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker