com.openinventor.inventor.nodes

Class SoRotor

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoTransformation

com.openinventor.inventor.nodes.SoRotation

com.openinventor.inventor.nodes.SoRotor

All Implemented Interfaces:

SafeDisposable

public class SoRotor
extends SoRotation

Animated rotation node. 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:

 SoRotor rotor = new SoRotor();
 rotor.rotation.setValue( new SbVec3f(0,1,0), 0.1f );

Any non-zero value can be used for the angle.

File format/default:

Rotor {

rotation	0 0 1 0
speed	1
on	true

}

Action behavior:

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction
Concatenates current rotation value with the current transformation matrix.

SoGetMatrixAction
Returns transformation matrix specified by the rotation.

See also:

SoPendulum, SoShuttle

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFBool	on Allows applications to enable or disable the motion easily.
SoSFFloat	speed Defines the speed of the rotor, in revolutions per second.

Fields inherited from class com.openinventor.inventor.nodes.SoRotation

rotation

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoRotor() Creates a rotor node with default settings.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

speed

public final SoSFFloat speed

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

on

public final SoSFBool on

Allows applications to enable or disable the motion easily.

Constructor Detail

SoRotor

public SoRotor()

Creates a rotor node with default settings.