SoSFRotation(3IV)

NAME
     SoSFRotation (SoSRotation) - field containing a rotation

INHERITS FROM
     SoField > SoSField > SoSFRotation

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

     typedef SoSFRotation  SoSRotation

          Functions from class SoSFRotation:

     void                SoSRotationGetAxisAngle(const SoSRotation *this,
                              const SbVec3f *axis, float *angle)
     void                SoSRotationSetQ_U_A_T(SoSRotation *this, float q0,
                              float q1, float q2, float q3)
                         SoSRotationSetQuat(SoSRotation *this, float q[4])
     void                SoSRotationSetAxisAngle(SoSRotation *this, const
                              SbVec3f *axis, float angle)
     SoType              SoSRotationGetClassTypeId()
     void                SoSRotationGetTypeId(const SoSRotation *this)
     const SbRotation *  SoSRotationGet(const SoSRotation *this)
     void                SoSRotationSet(SoSRotation *this, const SbRotation *
                              newValue)
     int                 SoSRotationIsEq(const SoSRotation *this, const
                              SoSFRotation *f)
     int                 SoSRotationIsNEq(const SoSRotation *this, const
                              SoSFRotation *f)

          Functions from class SoField:

     void                SoSRotationSetIgnored(SoSRotation *this, SbBool
                              ignore)
     SbBool              SoSRotationIsIgnored(const SoSRotation *this)
     SbBool              SoSRotationIsDflt(const SoSRotation *this)
     SbBool              SoSRotationIsOfType(const SoSRotation *this, SoType
                              type)
     SbBool              SoSRotationSetFromStr(SoSRotation *this, const char
                              *valueString)
     void                SoSRotationGetIntoStr(SoSRotation *this, SbString
                              *valueString)
     void                SoSRotationTouch(SoSRotation *this)
     SbBool              SoSRotationConnFromField(SoSRotation *this, SoField
                              *fromField)
     SbBool              SoSRotationConnFrom(SoSRotation *this, SoEngineOutput
                              *fromEngine)
     void                SoSRotationDisconn(SoSRotation *this)
     SbBool              SoSRotationIsConn(const SoSRotation *this)
     SbBool              SoSRotationIsConnFromField(const SoSRotation *this)
     SbBool              SoSRotationGetConnField(const SoSRotation *this,
                              SoField **writingField)
     SbBool              SoSRotationIsConnFromEngine(const SoSRotation *this)
     SbBool              SoSRotationGetConnEngine(const SoSRotation *this,
                              SoEngineOutput **engineOutput)
     void                SoSRotationEnableConn(SoSRotation *this, SbBool flag)
     SbBool              SoSRotationIsConnEnabled(const SoSRotation *this)
     int                 SoSRotationGetForwardConn(const SoSRotation *this,
                              SoFieldList *list)
     SoFieldContainer *  SoSRotationGetContainer(const SoSRotation *this)


DESCRIPTION
     A field containing a single SbRotation (an arbitrary rotation).

     SoSFRotations are written to file as four floating point values separated
     by whitespace. The 4 values represent an axis of rotation followed by the
     amount of right-handed rotation about that axis, in radians. For example,
     a 180 degree rotation about the Y axis is:

          0 1 0  3.14159265



FUNCTIONS
     void                SoSRotationGetAxisAngle(const SoSRotation *this,
                              const SbVec3f *axis, float *angle)
          Gets the value of the field as an axis/angle.

     void                SoSRotationSetQ_U_A_T(SoSRotation *this, float q0,
                              float q1, float q2, float q3)
                         SoSRotationSetQuat(SoSRotation *this, float q[4])
          Set the field to the given quaternion.

     void                SoSRotationSetAxisAngle(SoSRotation *this, const
                              SbVec3f *axis, float angle)
          Set the field to the rotation given by axis/angle.

     SoType              SoSRotationGetClassTypeId()
     void                SoSRotationGetTypeId(const SoSRotation *this)
          Returns the type for this class or a particular object of this
          class.

     const SbRotation *  SoSRotationGet(const SoSRotation *this)
          Returns this field's value.

     void                SoSRotationSet(SoSRotation *this, const SbRotation *
                              newValue)
          Sets this field to newValue.

     int                 SoSRotationIsEq(const SoSRotation *this, const
                              SoSFRotation *f)
     int                 SoSRotationIsNEq(const SoSRotation *this, const
                              SoSFRotation *f)
          Returns TRUE if f is of the same type and has the same value as this
          field.


SEE ALSO
     SbRotation, SoField, SoSField, SoMFRotation