SoRotationXYZ(3IV)

NAME
     SoRotationXYZ (SoRotXYZ) - node representing a 3D rotation about the x-,
     y-, or z-axis

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTransformation > SoRotationXYZ

SYNOPSIS
     #include <Inventor_c/nodes/SoRotationXYZ.h>

     typedef SoRotationXYZ  SoRotXYZ

     enum SoRotationXYZAxis {
          SO_ROT_XYZ_X        The x-axis
          SO_ROT_XYZ_Y        The y-axis
          SO_ROT_XYZ_Z        The z-axis
     }

          Fields from class SoRotationXYZ:

     SoSFEnum            axis
     SoSFFloat           angle

          Functions from class SoRotationXYZ:

     SoRotationXYZ *     SoRotXYZCreate()
     SbRotation          SoRotXYZGetRotation(const SoRotXYZ *this)
     SoType              SoRotXYZGetClassTypeId()

          Functions from class SoNode:

     void                SoRotXYZSetOverride(SoRotXYZ *this, SbBool state)
     SbBool              SoRotXYZIsOverride(const SoRotXYZ *this)
     SoNode *            SoRotXYZCopy(const SoRotXYZ *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoRotXYZAffectsState(const SoRotXYZ *this)
     SoNode *            SoRotXYZGetByName(const char *name)
     int                 SoRotXYZGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoRotXYZSetToDflts(SoRotXYZ *this)
     SbBool              SoRotXYZHasDfltVals(const SoRotXYZ *this)
     SbBool              SoRotXYZFldsAreEq(const SoRotXYZ *this, const
                              SoFieldContainer *fc)
     void                SoRotXYZCopyFieldVals(SoRotXYZ *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoRotXYZSet(SoRotXYZ *this, const char
                              *fieldDataString)
     void                SoRotXYZGet(SoRotXYZ *this, SbString
                              *fieldDataString)
     int                 SoRotXYZGetFields(const SoRotXYZ *this, SoFieldList
                              *resultList)
     SoField *           SoRotXYZGetField(const SoRotXYZ *this, const char
                              *fieldName)
     SbBool              SoRotXYZGetFieldName(const SoRotXYZ *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoRotXYZIsNotifyEnabled(const SoRotXYZ *this)
     SbBool              SoRotXYZEnableNotify(SoRotXYZ *this, SbBool flag)

          Functions from class SoBase:

     void                SoRotXYZRef(SoRotXYZ *this)
     void                SoRotXYZUnref(const SoRotXYZ *this)
     void                SoRotXYZUnrefNoDelete(const SoRotXYZ *this)
     void                SoRotXYZTouch(SoRotXYZ *this)
     SoType              SoRotXYZGetTypeId(const SoRotXYZ *this)
     SbBool              SoRotXYZIsOfType(const SoRotXYZ *this, SoType type)
     void                SoRotXYZSetName(SoRotXYZ *this, const char *name)
     SbName              SoRotXYZGetName(const SoRotXYZ *this)


DESCRIPTION
     This node defines a 3D rotation about one of the three principal axes.
     The rotation is accumulated into the current transformation, which is
     applied to subsequent shapes.

FIELDS
     SoSFEnum            axis
          Rotation axis.

     SoSFFloat           angle
          Rotation angle (in radians), using the right-hand rule.


FUNCTIONS
     SoRotationXYZ *     SoRotXYZCreate()
          Creates a rotation node with default settings.

     SbRotation          SoRotXYZGetRotation(const SoRotXYZ *this)
          Returns an SbRotation equivalent to the specified rotation.

     SoType              SoRotXYZGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction,
     SoRayPickAction
          Accumulates rotation transformation into the current transformation.
     SoGetMatrixAction
          Returns the matrix corresponding to the rotation.


FILE FORMAT/DEFAULTS
     RotationXYZ {
          axis   X
          angle  0
     }

SEE ALSO
     SoRotation, SoTransform