Contact
Impressum
Why this name?
pdf

SoRotor(3IV)

NAME

SoRotor — animated rotation node

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoTransformation > SoRotation > SoRotor

SYNOPSIS

#include <Inventor/nodes/SoRotor.h>

Fields from class SoRotor:

SoSFFloat

speed

SoSFBool

on

Fields from class SoRotation:

SoSFRotation

rotation

Methods from class SoRotor:

SoRotor()

static SoType

getClassTypeId()

Methods from class SoNode:

void

setOverride(SbBool state)

SbBool

isOverride() const

SoNode *

copy(SbBool copyConnections = FALSE) const

virtual SbBool

affectsState() const

static SoNode *

getByName(const SbName &name)

static int

getByName(const SbName &name, SoNodeList &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

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

SoSFFloat

speed

Defines the speed of the rotor, in revolutions per second.

SoSFBool

on

Allows applications to enable or disable the motion easily.

METHODS

SoRotor()

Creates a rotor node with default settings.

static SoType

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

pdf
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       

NO to software patents