NAME

       SoComposeRotationFromTo — composes a rotation that rotates from one vector into another

INHERITS FROM

       SoBase > SoFieldContainer > SoEngine > SoComposeRotationFromTo

SYNOPSIS

       #include <Inventor/engines/SoCompose.h>

          Inputs from class SoComposeRotationFromTo:

     SoMFVec3f           from
     SoMFVec3f           to

          Outputs from class SoComposeRotationFromTo:

     (SoMFRotation)      rotation

          Methods from class SoComposeRotationFromTo:

                         SoComposeRotationFromTo()

          Methods from class SoEngine:

     static SoType       getClassTypeId()
     virtual int         getOutputs(SoEngineOutputList &list) const
     SoEngineOutput *    getOutput(const SbName &outputName) const
     SbBool              getOutputName(const SoEngineOutput *output, SbName &outputName) const
     SoEngine *          copy() const
     static SoEngine *   getByName(const SbName &name)
     static int          getByName(const SbName &name, SoEngineList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool  copyConnections =
                              FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName) const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const

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.

METHODS

                         SoComposeRotationFromTo()
          Constructor

FILE FORMAT/DEFAULTS

       ComposeRotationFromTo {
          from  0 0 1
          to    0 0 1
     }

SEE ALSO

       SoComposeRotation, SoDecomposeRotationFromTo, SoEngineOutput

                                                                   SoComposeRotationFromTo(3IV)()