man SoRotor () - animated rotation node

NAME

SoRotor - animated rotation node

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoTransformation > SoRotation > SoRotor

SYNOPSIS

#include <Inventor/nodes/SoRotor.h> Fields from class SoRotor: c } c } speed

c } c } on Fields from class SoRotation: c } c } rotation Methods from class SoRotor: c } c } SoRotor()

c } c } getClassTypeId() Methods from class SoNode: c } c } setOverride(SbBool state)

c } c } isOverride() const

c } c } copy(SbBool copyConnections = FALSE) const

c } c } affectsState() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoNodeList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

The SoRotor class is derived from SoRotation, so it applies a rotation to the current transformation. Using engines connected to the realTime global field, the rotation value is animated over time, achieving a spinning effect. The period of the rotation can be adjusted by changing the speed field. The current rotation at any time is available in the rotation field, inherited from SoRotation. This field can also be set to specify the axis of rotation. Note that unless a non-zero rotation is specified for the rotation, the node will not know which axis to use. For example, to set a rotor to spin about the y-axis, use the following:

rotor->rotation.setValue(axis, 0.1);

where axis is a vector containing (0,1,0). Any non-zero angle can be used in this code.

FIELDS

c } c } speed

Defines the speed of the rotor, in revolutions per second. c } c } on

Allows applications to enable or disable the motion easily.

METHODS

c } c } SoRotor()

Creates a rotor node with default settings. c } c } getClassTypeId()

Returns type identifier for this class.

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction

Concatenates current rotation value with the current transformation matrix. SoGetMatrixAction

Returns transformation matrix specified by the rotation.

FILE FORMAT/DEFAULTS

Rotor {
rotation	0 0 1  0
speed	1
on	TRUE
}

SEE ALSO

SoPendulum, SoShuttle