SoTransformVec3f(3IV)

NAME
     SoTransformVec3f (SoXfV3f) - transforms a 3D vector by a 4x4 matrix

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoTransformVec3f

SYNOPSIS
     #include <Inventor_c/engines/SoTransformVec3f.h>

     typedef SoTransformVec3f  SoXfV3f

          Inputs from class SoTransformVec3f:

     SoMFVec3f           vector
     SoMFMatrix          matrix

          Outputs from class SoTransformVec3f:

     (SoMFVec3f)         point
     (SoMFVec3f)         direction
     (SoMFVec3f)         normalDirection

          Functions from class SoTransformVec3f:

     SoTransformVec3f *  SoXfV3fCreate()

          Functions from class SoEngine:

     SoType              SoXfV3fGetTypeId()
     int                 SoXfV3fGetOuts(const SoXfV3f *this,
                              SoEngineOutputList *list)
     SoEngineOutput *    SoXfV3fGetOut(const SoXfV3f *this, const char
                              *outputName)
     SbBool              SoXfV3fGetOutName(const SoXfV3f *this, const
                              SoEngineOutput *output, SbName *outputName)
     SoEngine *          SoXfV3fCopy(const SoXfV3f *this)
     SoEngine *          SoXfV3fGetByName(const char *name)
     int                 SoXfV3fGetByNameList(const char *name, SoEngineList
                              *list)

          Functions from class SoFieldContainer:

     SoType              SoXfV3fGetClassTypeId()
     void                SoXfV3fSetToDflts(SoXfV3f *this)
     SbBool              SoXfV3fHasDfltVals(const SoXfV3f *this)
     SbBool              SoXfV3fFldsAreEq(const SoXfV3f *this, const
                              SoFieldContainer *fc)
     void                SoXfV3fCopyFieldVals(SoXfV3f *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoXfV3fSet(SoXfV3f *this, const char
                              *fieldDataString)
     void                SoXfV3fGet(SoXfV3f *this, SbString *fieldDataString)
     int                 SoXfV3fGetFields(const SoXfV3f *this, SoFieldList
                              *resultList)
     SoField *           SoXfV3fGetField(const SoXfV3f *this, const char
                              *fieldName)
     SbBool              SoXfV3fGetFieldName(const SoXfV3f *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoXfV3fIsNotifyEnabled(const SoXfV3f *this)
     SbBool              SoXfV3fEnableNotify(SoXfV3f *this, SbBool flag)

          Functions from class SoBase:

     void                SoXfV3fRef(SoXfV3f *this)
     void                SoXfV3fUnref(const SoXfV3f *this)
     void                SoXfV3fUnrefNoDelete(const SoXfV3f *this)
     void                SoXfV3fTouch(SoXfV3f *this)
     SbBool              SoXfV3fIsOfType(const SoXfV3f *this, SoType type)
     void                SoXfV3fSetName(SoXfV3f *this, const char *name)
     SbName              SoXfV3fGetName(const SoXfV3f *this)


DESCRIPTION
     This engine takes as input a three dimensional floating-point vector and
     a transformation matrix. The vector is assumed to be a row vector.

     The engine multiplies the vector by the matrix and returns the result in
     the output point. The output direction contains the result when the
     matrix multiplication assumes the vector is a direction, and therefore
     ignores the translation part of the matrix. The output normalDirection
     contains the normalized direction

INPUTS
     SoMFVec3f           vector
          Input row vector.

     SoMFMatrix          matrix
          Input transformation matrix.


OUTPUTS
     (SoMFVec3f)         point
          Vector transformed by matrix.

     (SoMFVec3f)         direction
          Vector transformed by matrix, ignoring translation.

     (SoMFVec3f)         normalDirection
          Normalized direction.

FUNCTIONS
     SoTransformVec3f *  SoXfV3fCreate()
          Constructor


FILE FORMAT/DEFAULTS
     TransformVec3f {
          vector  0 0 0
          matrix  1 0 0 0
                  0 1 0 0
                  0 0 1 0
                  0 0 0 1
     }

SEE ALSO
     SoEngineOutput