|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.media.j3d.SceneGraphObject
javax.media.j3d.Node
javax.media.j3d.Leaf
javax.media.j3d.Behavior
javax.media.j3d.Interpolator
javax.media.j3d.TransformInterpolator
javax.media.j3d.PathInterpolator
public abstract class PathInterpolator
PathInterpolator behavior. This class defines the base class for all Path Interpolators. Subclasses have access to the computePathInterpolation() method, which computes the currentInterpolationValue given the current time and alpha. The method also computes the currentKnotIndex, which is based on the currentInterpolationValue. The currentInterpolationValue is calculated by linearly interpolating among a series of predefined knots (using the value generated by the specified Alpha object). The first knot must have a value of 0.0 and the last knot must have a value of 1.0. An intermediate knot with index k must have a value strictly greater than any knot with index less than k.
Field Summary | |
---|---|
protected float |
currentInterpolationValue
This value is the ratio between knot values indicated by the currentKnotIndex variable. |
protected int |
currentKnotIndex
This value is the index of the current base knot value, as determined by the alpha function. |
private float[] |
knots
|
Fields inherited from class javax.media.j3d.TransformInterpolator |
---|
axis, axisInverse, target |
Fields inherited from class javax.media.j3d.Interpolator |
---|
alpha, defaultWakeupCriterion |
Fields inherited from class javax.media.j3d.SceneGraphObject |
---|
nodeHashtable, retained |
Constructor Summary | |
---|---|
PathInterpolator()
Constructs a PathInterpolator node with a null alpha value and a null target of TransformGroup since Java 3D 1.3 |
|
PathInterpolator(Alpha alpha,
float[] knots)
Deprecated. As of Java 3D version 1.3, replaced by PathInterpolator(Alpha, TransformGroup, float[]) |
|
PathInterpolator(Alpha alpha,
TransformGroup target,
float[] knots)
Constructs a new PathInterpolator object that interpolates between the knot values in the knots array. |
|
PathInterpolator(Alpha alpha,
TransformGroup target,
Transform3D axisOfTransform,
float[] knots)
Constructs a new PathInterpolator object that interpolates between the knot values in the knots array. |
Method Summary | |
---|---|
protected void |
computePathInterpolation()
Deprecated. As of Java 3D version 1.3, replaced by computePathInterpolation(float) |
protected void |
computePathInterpolation(float alphaValue)
Computes the base knot index and interpolation value given the specified value of alpha and the knots[] array. |
(package private) void |
duplicateAttributes(Node originalNode,
boolean forceDuplicate)
Copies all PathInterpolator information from originalNode into
the current node. |
int |
getArrayLengths()
Retrieves the length of the knots array. |
float |
getKnot(int index)
Retrieves the knot at the specified index. |
void |
getKnots(float[] knots)
Copies the array of knots from this interpolator into the specified array. |
void |
setKnot(int index,
float knot)
Sets the knot at the specified index for this interpolator. |
protected void |
setKnots(float[] knots)
Replaces the existing array of knot values with the specified array. |
Methods inherited from class javax.media.j3d.TransformInterpolator |
---|
computeTransform, getTarget, getTransformAxis, processStimulus, setTarget, setTransformAxis, updateNodeReferences |
Methods inherited from class javax.media.j3d.Interpolator |
---|
getAlpha, initialize, setAlpha |
Methods inherited from class javax.media.j3d.Behavior |
---|
createRetained, getEnable, getNumSchedulingIntervals, getSchedulingBoundingLeaf, getSchedulingBounds, getSchedulingInterval, getView, getWakeupCondition, postId, setEnable, setSchedulingBoundingLeaf, setSchedulingBounds, setSchedulingInterval, wakeupOn |
Methods inherited from class javax.media.j3d.Node |
---|
checkDuplicateNode, checkForCycle, cloneNode, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, cloneTree, duplicateNode, getBounds, getBoundsAutoCompute, getCollidable, getLocale, getLocalToVworld, getLocalToVworld, getParent, getPickable, setBounds, setBoundsAutoCompute, setCollidable, setPickable |
Methods inherited from class javax.media.j3d.SceneGraphObject |
---|
capabilityBitsEmpty, checkForLiveOrCompiled, clearCapability, clearCapabilityIsFrequent, clearLive, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getNamePrefix, getNodeComponent, getUserData, isCompiled, isLive, isLiveOrCompiled, setCapability, setCapabilityIsFrequent, setCompiled, setDefaultReadCapabilities, setLive, setName, setUserData, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
private float[] knots
protected float currentInterpolationValue
computePathInterpolation(alphaValue)
method from the subclass's
computeTransform() method. Then this variable will hold a valid
value which can be used in further calculations by the subclass.
protected int currentKnotIndex
computePathInterpolation(alphaValue)
method from the subclass's
computeTransform() method. Then this variable will hold a valid
value which can be used in further calculations by the subclass.
Constructor Detail |
---|
PathInterpolator()
public PathInterpolator(Alpha alpha, float[] knots)
PathInterpolator(Alpha, TransformGroup, float[])
alpha
- the alpha object for this interpolator.knots
- an array of knot values that specify interpolation
points.public PathInterpolator(Alpha alpha, TransformGroup target, float[] knots)
alpha
- the alpha object for this interpolator.target
- the transformgroup node effected by this pathInterpolatorknots
- an array of knot values that specify interpolation
points.public PathInterpolator(Alpha alpha, TransformGroup target, Transform3D axisOfTransform, float[] knots)
alpha
- the alpha object for this interpolator.target
- the transform node effected by this positionInterpolatoraxisOfTransform
- the transform that defines the local coordinateknots
- an array of knot values that specify interpolation
points.Method Detail |
---|
public int getArrayLengths()
public void setKnot(int index, float knot)
index
- the index to be changedknot
- the new knot valuepublic float getKnot(int index)
index
- the index of the value requested
protected void setKnots(float[] knots)
knots
- a new array of knot values that specify
interpolation points.public void getKnots(float[] knots)
knots
- array that will receive the knots.protected void computePathInterpolation(float alphaValue)
alphaValue
- alpha value between 0.0 and 1.0protected void computePathInterpolation()
computePathInterpolation(float)
void duplicateAttributes(Node originalNode, boolean forceDuplicate)
originalNode
into
the current node. This method is called from the
cloneNode
method which is, in turn, called by the
cloneTree
method.
duplicateAttributes
in class TransformInterpolator
originalNode
- the original node to duplicate.forceDuplicate
- when set to true
, causes the
duplicateOnCloneTree
flag to be ignored. When
false
, the value of each node's
duplicateOnCloneTree
variable determines whether
NodeComponent data is duplicated or copied.
RestrictedAccessException
- if this object is part of a live
or compiled scenegraph.Node.duplicateNode(javax.media.j3d.Node, boolean)
,
Node.cloneTree()
,
NodeComponent.setDuplicateOnCloneTree(boolean)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |