GetMatrix

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODTransform

GetMatrix
The GetMatrix method copies this transform's matrix into the specified structure.
void GetMatrix (out ODMatrix matrix);
matrix
The structure in which to return the matrix.

DISCUSSION
If you use transforms of the class ODTransform and you have also created a subclass of ODTransform that applies complex transformation effects that cannot be represented by matrices, your part needs to check whether a given transform has a matrix before calling this method. To do so, you should call the transform's HasMatrix method; only if that method returns true should you call the transform's GetMatrix method.

OVERRIDING
If you subclass ODTransform to create a nonlinear transform class, you must override this method. Your override method must not call its inherited method. Instead, it should raise a kODErrTransformErr exception. You can detect that a transform of your class has no matrix by calling its HasMatrix method.

EXCEPTION

kODErrTransformErr
This transform object does not use a matrix.

SEE ALSO
The ODMatrix type (page 888).
The ODTransform::HasMatrix method (page 772).
The ODTransform::SetMatrix method (page 783).
"Custom Transform Objects" on page 450 in OpenDoc Programmer's Guide.