SoMatrixTransform(3IV)

NAME
     SoMatrixTransform (SoMx) - node that specifies a 3D geometric
     transformation as a matrix

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTransformation > SoMatrixTransform

SYNOPSIS
     #include <Inventor_c/nodes/SoMatrixTransform.h>

     typedef SoMatrixTransform  SoMx

          Fields from class SoMatrixTransform:

     SoSFMatrix          matrix

          Functions from class SoMatrixTransform:

     SoMatrixTransform *  SoMxCreate()
     SoType               SoMxGetClassTypeId()

          Functions from class SoNode:

     void                SoMxSetOverride(SoMx *this, SbBool state)
     SbBool              SoMxIsOverride(const SoMx *this)
     SoNode *            SoMxCopy(const SoMx *this, SbBool copyConnections =
                              FALSE)
     SbBool              SoMxAffectsState(const SoMx *this)
     SoNode *            SoMxGetByName(const char *name)
     int                 SoMxGetByNameList(const char *name, SoNodeList *list)

          Functions from class SoFieldContainer:

     void                SoMxSetToDflts(SoMx *this)
     SbBool              SoMxHasDfltVals(const SoMx *this)
     SbBool              SoMxFldsAreEq(const SoMx *this, const
                              SoFieldContainer *fc)
     void                SoMxCopyFieldVals(SoMx *this, const SoFieldContainer
                              *fc, SbBool copyConnections = FALSE)
     SbBool              SoMxSet(SoMx *this, const char *fieldDataString)
     void                SoMxGet(SoMx *this, SbString *fieldDataString)
     int                 SoMxGetFields(const SoMx *this, SoFieldList
                              *resultList)
     SoField *           SoMxGetField(const SoMx *this, const char *fieldName)
     SbBool              SoMxGetFieldName(const SoMx *this, const SoField
                              *field, SbName *fieldName)
     SbBool              SoMxIsNotifyEnabled(const SoMx *this)
     SbBool              SoMxEnableNotify(SoMx *this, SbBool flag)

          Functions from class SoBase:
     void                SoMxRef(SoMx *this)
     void                SoMxUnref(const SoMx *this)
     void                SoMxUnrefNoDelete(const SoMx *this)
     void                SoMxTouch(SoMx *this)
     SoType              SoMxGetTypeId(const SoMx *this)
     SbBool              SoMxIsOfType(const SoMx *this, SoType type)
     void                SoMxSetName(SoMx *this, const char *name)
     SbName              SoMxGetName(const SoMx *this)


DESCRIPTION
     This node defines a geometric 3D transformation with a single SbMatrix.
     Note that some matrices (such as singular ones) may result in errors in
     bounding boxes, picking, and lighting.

FIELDS
     SoSFMatrix          matrix
          Transformation matrix.


FUNCTIONS
     SoMatrixTransform *  SoMxCreate()
          Creates a matrix transformation node with default settings.

     SoType               SoMxGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction,
     SoRayPickAction
          Concatenates matrix given in the matrix field with the current
          transformation matrix.

     SoGetMatrixAction
          Returns transformation matrix specified in the matrix field.


FILE FORMAT/DEFAULTS
     MatrixTransform {
          matrix  1 0 0 0
                  0 1 0 0
                  0 0 1 0
                  0 0 0 1
     }

SEE ALSO
     SoTransform, SoMultipleCopy