NAME

       SoSFRotation — field containing a rotation

INHERITS FROM

       SoField > SoSField > SoSFRotation

SYNOPSIS

       #include <Inventor/fields/SoSFRotation.h>

          Methods from class SoSFRotation:

     void                getValue(const SbVec3f &axis, float &angle) const
     void                setValue(float q0, float q1, float q2, float q3)
                         setValue(float q[4])
     void                setValue(const SbVec3f &axis, float angle)
     static SoType       getClassTypeId()
     virtual void        getTypeId() const
     const SbRotation &  getValue() const
     const SbRotation &  operator =(const SbRotation & newValue)
     void                setValue(const SbRotation & newValue)
     int                 operator ==(const SoSFRotation &f) const
     int                 operator !=(const SoSFRotation &f) const

          Methods from class SoField:

     void                setIgnored(SbBool ignore)
     SbBool              isIgnored() const
     SbBool              isDefault() const
     virtual SbBool      isOfType(SoType type) const
     SbBool              set(const char *valueString)
     void                get(SbString &valueString)
     void                touch()
     SbBool              connectFrom(SoField *fromField)
     SbBool              connectFrom(SoEngineOutput *fromEngine)
     void                disconnect()
     SbBool              isConnected() const
     SbBool              isConnectedFromField() const
     SbBool              getConnectedField(SoField *&writingField) const
     SbBool              isConnectedFromEngine() const
     SbBool              getConnectedEngine(SoEngineOutput *&engineOutput) const
     void                enableConnection(SbBool flag)
     SbBool              isConnectionEnabled() const
     int                 getForwardConnections(SoFieldList &list) const
     SoFieldContainer *  getContainer() const

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

METHODS

     void                getValue(const SbVec3f &axis, float &angle) const
          Gets the value of the field as an axis/angle.

     void                setValue(float q0, float q1, float q2, float q3)
                         setValue(float q[4])
          Set the field to the given quaternion.

     void                setValue(const SbVec3f &axis, float angle)
          Set the field to the rotation given by axis/angle.

     static SoType       getClassTypeId()
     virtual void        getTypeId() const
          Returns the type for this class or a particular object of this class.

     const SbRotation &  getValue() const
          Returns this field's value.

     const SbRotation &  operator =(const SbRotation & newValue)
     void                setValue(const SbRotation & newValue)
          Sets this field to newValue.

     int                 operator ==(const SoSFRotation &f) const
     int                 operator !=(const SoSFRotation &f) const
          Returns TRUE if f is of the same type and has the same value as this field.

SEE ALSO

       SbRotation, SoField, SoSField, SoMFRotation

                                                                              SoSFRotation(3IV)()