SoComposeRotationFromTo(3IV)

NAME
     SoComposeRotationFromTo (SoCmpsRotFromTo) - composes a rotation that
     rotates from one vector into another

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoComposeRotationFromTo

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

     typedef SoComposeRotationFromTo
                         SoCmpsRotFromTo

          Inputs from class SoComposeRotationFromTo:

     SoMFVec3f           from
     SoMFVec3f           to

          Outputs from class SoComposeRotationFromTo:

     (SoMFRotation)      rotation

          Functions from class SoComposeRotationFromTo:

     SoComposeRotationFromTo *  SoCmpsRotFromToCreate()

          Functions from class SoEngine:

     SoType              SoCmpsRotFromToGetTypeId()
     int                 SoCmpsRotFromToGetOuts(const SoCmpsRotFromTo *this,
                              SoEngineOutputList *list)
     SoEngineOutput *    SoCmpsRotFromToGetOut(const SoCmpsRotFromTo *this,
                              const char *outputName)
     SbBool              SoCmpsRotFromToGetOutName(const SoCmpsRotFromTo
                              *this, const SoEngineOutput *output, SbName
                              *outputName)
     SoEngine *          SoCmpsRotFromToCopy(const SoCmpsRotFromTo *this)
     SoEngine *          SoCmpsRotFromToGetByName(const char *name)
     int                 SoCmpsRotFromToGetByNameList(const char *name,
                              SoEngineList *list)

          Functions from class SoFieldContainer:

     SoType              SoCmpsRotFromToGetClassTypeId()
     void                SoCmpsRotFromToSetToDflts(SoCmpsRotFromTo *this)
     SbBool              SoCmpsRotFromToHasDfltVals(const SoCmpsRotFromTo
                              *this)
     SbBool              SoCmpsRotFromToFldsAreEq(const SoCmpsRotFromTo *this,
                              const SoFieldContainer *fc)
     void                SoCmpsRotFromToCopyFieldVals(SoCmpsRotFromTo *this,
                              const SoFieldContainer *fc, SbBool
                              copyConnections = FALSE)
     SbBool              SoCmpsRotFromToSet(SoCmpsRotFromTo *this, const char
                              *fieldDataString)
     void                SoCmpsRotFromToGet(SoCmpsRotFromTo *this, SbString
                              *fieldDataString)
     int                 SoCmpsRotFromToGetFields(const SoCmpsRotFromTo *this,
                              SoFieldList *resultList)
     SoField *           SoCmpsRotFromToGetField(const SoCmpsRotFromTo *this,
                              const char *fieldName)
     SbBool              SoCmpsRotFromToGetFieldName(const SoCmpsRotFromTo
                              *this, const SoField *field, SbName *fieldName)
     SbBool              SoCmpsRotFromToIsNotifyEnabled(const SoCmpsRotFromTo
                              *this)
     SbBool              SoCmpsRotFromToEnableNotify(SoCmpsRotFromTo *this,
                              SbBool flag)

          Functions from class SoBase:

     void                SoCmpsRotFromToRef(SoCmpsRotFromTo *this)
     void                SoCmpsRotFromToUnref(const SoCmpsRotFromTo *this)
     void                SoCmpsRotFromToUnrefNoDelete(const SoCmpsRotFromTo
                              *this)
     void                SoCmpsRotFromToTouch(SoCmpsRotFromTo *this)
     SbBool              SoCmpsRotFromToIsOfType(const SoCmpsRotFromTo *this,
                              SoType type)
     void                SoCmpsRotFromToSetName(SoCmpsRotFromTo *this, const
                              char *name)
     SbName              SoCmpsRotFromToGetName(const SoCmpsRotFromTo *this)


DESCRIPTION
     This engine takes two inputs, representing a vector before and after a
     rotation has been applied. As output, it produces the rotation value that
     would cause the first vector to transform into the other.

     The input fields can have multiple values, allowing the engine to compose
     several rotations in parallel. Some inputs may have more values than
     others. In such cases, the last value of the shorter inputs will be
     repeated as necessary.

INPUTS
     SoMFVec3f           from
          Vector before the rotation.

     SoMFVec3f           to
          Vector after the rotation.


OUTPUTS
     (SoMFRotation)      rotation
          A rotation that transforms one vector into another.

FUNCTIONS
     SoComposeRotationFromTo *  SoCmpsRotFromToCreate()
          Constructor


FILE FORMAT/DEFAULTS
     ComposeRotationFromTo {
          from  0 0 1
          to    0 0 1
     }

SEE ALSO
     SoComposeRotation, SoDecomposeRotationFromTo, SoEngineOutput