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.
