SoSFMatrix(3IV)

NAME
     SoSFMatrix (SoSMatrix) - field containing a 4x4 matrix

INHERITS FROM
     SoField > SoSField > SoSFMatrix

SYNOPSIS
     #include <Inventor_c/fields/SoSFMatrix.h>

     typedef SoSFMatrix  SoSMatrix

          Functions from class SoSFMatrix:

     void                SoSMatrixSetMx(SoSMatrix *this, float a11, float a12,
                              float a13, float a14, float a21, float a22,
                              float a23, float a24, float a31, float a32,
                              float a33, float a34, float a41, float a42,
                              float a43, float a44)
     SoType              SoSMatrixGetClassTypeId()
     void                SoSMatrixGetTypeId(const SoSMatrix *this)
     const SbMatrix *    SoSMatrixGet(const SoSMatrix *this)
     void                SoSMatrixSet(SoSMatrix *this, const SbMatrix *
                              newValue)
     int                 SoSMatrixIsEq(const SoSMatrix *this, const SoSFMatrix
                              *f)
     int                 SoSMatrixIsNEq(const SoSMatrix *this, const
                              SoSFMatrix *f)

          Functions from class SoField:

     void                SoSMatrixSetIgnored(SoSMatrix *this, SbBool ignore)
     SbBool              SoSMatrixIsIgnored(const SoSMatrix *this)
     SbBool              SoSMatrixIsDflt(const SoSMatrix *this)
     SbBool              SoSMatrixIsOfType(const SoSMatrix *this, SoType type)
     SbBool              SoSMatrixSetFromStr(SoSMatrix *this, const char
                              *valueString)
     void                SoSMatrixGetIntoStr(SoSMatrix *this, SbString
                              *valueString)
     void                SoSMatrixTouch(SoSMatrix *this)
     SbBool              SoSMatrixConnFromField(SoSMatrix *this, SoField
                              *fromField)
     SbBool              SoSMatrixConnFrom(SoSMatrix *this, SoEngineOutput
                              *fromEngine)
     void                SoSMatrixDisconn(SoSMatrix *this)
     SbBool              SoSMatrixIsConn(const SoSMatrix *this)
     SbBool              SoSMatrixIsConnFromField(const SoSMatrix *this)
     SbBool              SoSMatrixGetConnField(const SoSMatrix *this, SoField
                              **writingField)
     SbBool              SoSMatrixIsConnFromEngine(const SoSMatrix *this)
     SbBool              SoSMatrixGetConnEngine(const SoSMatrix *this,
                              SoEngineOutput **engineOutput)
     void                SoSMatrixEnableConn(SoSMatrix *this, SbBool flag)
     SbBool              SoSMatrixIsConnEnabled(const SoSMatrix *this)
     int                 SoSMatrixGetForwardConn(const SoSMatrix *this,
                              SoFieldList *list)
     SoFieldContainer *  SoSMatrixGetContainer(const SoSMatrix *this)


DESCRIPTION
     A field containing a transformation matrix (an SbMatrix).

     SoSFMatrices are written to file as 16 floating point numbers separated
     by whitespace. For example, an identity matrix is written as:

          1 0 0 0  0 1 0 0  0 0 1 0  0 0 0 1



FUNCTIONS
     void                SoSMatrixSetMx(SoSMatrix *this, float a11, float a12,
                              float a13, float a14, float a21, float a22,
                              float a23, float a24, float a31, float a32,
                              float a33, float a34, float a41, float a42,
                              float a43, float a44)
          Sets this field to contain the matrix given by the 16 values. For a
          translation matrix, the x, y and z translations should be in the
          a41, a42, and a43 arguments.

     SoType              SoSMatrixGetClassTypeId()
     void                SoSMatrixGetTypeId(const SoSMatrix *this)
          Returns the type for this class or a particular object of this
          class.

     const SbMatrix *    SoSMatrixGet(const SoSMatrix *this)
          Returns this field's value.

     void                SoSMatrixSet(SoSMatrix *this, const SbMatrix *
                              newValue)
          Sets this field to newValue.

     int                 SoSMatrixIsEq(const SoSMatrix *this, const SoSFMatrix
                              *f)
     int                 SoSMatrixIsNEq(const SoSMatrix *this, const
                              SoSFMatrix *f)
          Returns TRUE if f is of the same type and has the same value as this
          field.


SEE ALSO
     SoField, SoSField, SoMFMatrix, SbMatrix