Package javax.media.j3d
Class WakeupOnElapsedFrames
java.lang.Object
javax.media.j3d.WakeupCondition
javax.media.j3d.WakeupCriterion
javax.media.j3d.WakeupOnElapsedFrames
Class specifying a wakeup when a specific number of frames have
elapsed. The wakeup criterion can either be passive or
non-passive. If any behavior uses a non-passive
WakeupOnElapsedFrames, the rendering system will run continuously.
In general, applications cannot count on behavior execution being
synchronized with rendering. Behaviors that use
WakeupOnElapsedFrames with a frame count of 0 are an exception to
this general rule. Such behaviors will be executed every frame.
Further, all modifications to scene graph objects (not including
geometry by-reference or texture by-reference) made from the
processStimulus
methods of such behaviors are
guaranteed to take effect in the same rendering frame.
-
Constructor Summary
ConstructorsConstructorDescriptionWakeupOnElapsedFrames
(int frameCount) Constructs a non-passive WakeupOnElapsedFrames criterion.WakeupOnElapsedFrames
(int frameCount, boolean passive) Constructs a WakeupOnElapsedFrames criterion. -
Method Summary
Modifier and TypeMethodDescriptionint
Retrieves the elapsed frame count that was used when constructing this object.boolean
Retrieves the state of the passive flag that was used when constructing this object.Methods inherited from class javax.media.j3d.WakeupCriterion
hasTriggered
Methods inherited from class javax.media.j3d.WakeupCondition
allElements, triggeredElements
-
Constructor Details
-
WakeupOnElapsedFrames
public WakeupOnElapsedFrames(int frameCount) Constructs a non-passive WakeupOnElapsedFrames criterion.- Parameters:
frameCount
- the number of frames that Java 3D should draw before awakening this behavior object; a value of N means wakeup at the end of frame N, where the current frame is zero, a value of zero means wakeup at the end of the current frame.- Throws:
IllegalArgumentException
- if frameCount is less than zero
-
WakeupOnElapsedFrames
public WakeupOnElapsedFrames(int frameCount, boolean passive) Constructs a WakeupOnElapsedFrames criterion.- Parameters:
frameCount
- the number of frames that Java 3D should draw before awakening this behavior object; a value of N means wakeup at the end of frame N, where the current frame is zero, a value of zero means wakeup at the end of the current frame.passive
- flag indicating whether this behavior is passive; a non-passive behavior will cause the rendering system to run continuously, while a passive behavior will only run when some other event causes a frame to be run.- Throws:
IllegalArgumentException
- if frameCount is less than zero- Since:
- Java 3D 1.2
-
-
Method Details
-
getElapsedFrameCount
public int getElapsedFrameCount()Retrieves the elapsed frame count that was used when constructing this object.- Returns:
- the elapsed frame count specified when constructing this object
-
isPassive
public boolean isPassive()Retrieves the state of the passive flag that was used when constructing this object.- Returns:
- true if this wakeup criterion is passive, false otherwise
- Since:
- Java 3D 1.2
-