Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 7 - Transform Objects / Transform Objects Reference

Transform Objects Routines / Creating and Manipulating Matrix Transforms

Q3MatrixTransform_New

You can use the Q3MatrixTransform_New function to create a new matrix transform.

TQ3TransformObject Q3MatrixTransform_New (
const TQ3Matrix4x4 *matrix);

matrix

On entry, a pointer to a 4-by-4 matrix that defines the desired new transform.

DESCRIPTION

The Q3MatrixTransform_New function returns, as its function result, a reference to a new transform object of type kQ3TransformTypeMatrix using the data passed in the matrix parameter. The data you pass in the matrix parameter is copied into internal QuickDraw 3D data structures. If QuickDraw 3D cannot allocate memory for those structures, Q3MatrixTransform_New returns the value NULL.

It is your responsibility to ensure that the matrix specified by the matrix parameter is affine and invertible. QuickDraw 3D does not check for these qualities.