com.jme.curve
Class CatmullRomCurve

java.lang.Object
  com.jme.scene.Spatial
      com.jme.scene.Geometry
          com.jme.curve.Curve
              com.jme.curve.CatmullRomCurve

All Implemented Interfaces:

Savable, java.io.Serializable

public class CatmullRomCurve
extends Curve

CatmullRomCurve

Author:

Frederik Bülthoff, (bugfix) Andreas Grabner

See Also:

Catmull-Rom Splines< /a>, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.jme.scene.Spatial

Spatial.CullHint, Spatial.LightCombineMode, Spatial.NormalsMode, Spatial.TextureCombineMode

Field Summary

Fields inherited from class com.jme.curve.Curve

steps

Fields inherited from class com.jme.scene.Geometry

binormalBuf, bound, castsShadows, colorBuf, compVect, defaultColor, displayListID, enabled, fogBuf, hasDirtyVertices, normBuf, states, tangentBuf, texBuf, vboInfo, vertBuf, vertQuantity

Fields inherited from class com.jme.scene.Spatial

collisionBits, cullHint, frustrumIntersects, geometricalControllers, lightCombineMode, localRotation, localScale, localTranslation, LOCKED_BOUNDS, LOCKED_BRANCH, LOCKED_MESH_DATA, LOCKED_NONE, LOCKED_SHADOWS, LOCKED_TRANSFORMS, lockedMode, name, normalsMode, parent, queueDistance, renderQueueMode, renderStateList, textureCombineMode, worldBound, worldRotation, worldScale, worldTranslation, zOrder

Constructor Summary

CatmullRomCurve()

CatmullRomCurve(java.lang.String name)
Constructor instantiates a new CatmullRomCurve object.

CatmullRomCurve(java.lang.String name, Vector3f[] controlPoints)
Constructor instantiates a new CatmullRomCurve object.

Method Summary

void	findCollisions(Spatial scene, CollisionResults results, int requiredOnBits) checks this spatial against a second spatial, any collisions are stored in the results object.
void	findPick(Ray toTest, PickResults results, int requiredOnBits) Check if this geometry intersects the ray if yes add it to the results.
Matrix3f	getOrientation(float time, float precision) getOrientation calculates the rotation matrix for any given point along to the line to still be facing in the direction of the line.
Matrix3f	getOrientation(float time, float precision, Vector3f up) getOrientation calculates the rotation matrix for any given point along to the line to still be facing in the direction of the line.
Vector3f	getPoint(float time) getPoint calculates a point on the curve based on the time, where time is [0, 1].
Vector3f	getPoint(float time, Vector3f point) getPoint calculates a point on a Catmull-Rom curve from a given time value within the interval [0, 1].
boolean	hasCollision(Spatial scene, boolean checkTriangles, int requiredOnBits) Checks this spatial against a second spatial for collisions.

Methods inherited from class com.jme.curve.Curve

applyRenderState, draw, getSteps, read, setSteps, write

Methods inherited from class com.jme.scene.Geometry

addTextureCoordinates, addTextureCoordinates, checkTextureCoordinates, clearBuffers, clearTextureBuffers, copyTextureCoordinates, copyTextureCoordinates, getBinormalBuffer, getColorBuffer, getDefaultColor, getDisplayListID, getFogBuffer, getLightState, getModelBound, getNormalBuffer, getNumberOfUnits, getTangentBuffer, getTextureCoords, getTextureCoords, getTriangleCount, getVBOInfo, getVertexBuffer, getVertexCount, getWorldCoords, getWorldNormals, hasDirtyVertices, isCastsShadows, lockMeshes, postdraw, predraw, randomVertex, reconstruct, resizeTextureIds, rotateNormals, rotatePoints, scaleTextureCoordinates, scaleTextureCoordinates, setBinormalBuffer, setCastsShadows, setColorBuffer, setDefaultColor, setDisplayListID, setFogCoordBuffer, setHasDirtyVertices, setLightState, setModelBound, setNormalBuffer, setRandomColors, setSolidColor, setTangentBuffer, setTextureCoords, setTextureCoords, setTextureCoords, setVBOInfo, setVertexBuffer, setVertexCount, sortLights, translatePoints, translatePoints, unlockMeshes, updateModelBound, updateWorldBound

Methods inherited from class com.jme.scene.Spatial

addController, calculateCollisions, calculateCollisions, calculatePick, calculatePick, clearControllers, clearRenderState, clearRenderState, findCollisions, findPick, getClassTag, getCollisionMask, getController, getControllerCount, getControllers, getCullHint, getLastFrustumIntersection, getLightCombineMode, getLocalCullHint, getLocalLightCombineMode, getLocalNormalsMode, getLocalRenderQueueMode, getLocalRotation, getLocalScale, getLocalTextureCombineMode, getLocalToWorldMatrix, getLocalTranslation, getLocks, getName, getNormalsMode, getParent, getRenderQueueMode, getRenderState, getRenderState, getTextureCombineMode, getUserData, getWorldBound, getWorldRotation, getWorldScale, getWorldTranslation, getZOrder, hasAncestor, hasCollision, isCollidable, isCollidable, localToWorld, lock, lock, lockBounds, lockBranch, lockMeshes, lockShadows, lockTransforms, lookAt, matches, matches, onDraw, propagateBoundToRoot, propagateStatesFromRoot, removeController, removeController, removeFromParent, removeUserData, rotateUpTo, setCollisionMask, setCullHint, setIsCollidable, setLastFrustumIntersection, setLightCombineMode, setLocalRotation, setLocalRotation, setLocalScale, setLocalScale, setLocalTranslation, setLocalTranslation, setLocks, setLocks, setName, setNormalsMode, setParent, setRenderQueueMode, setRenderState, setTextureCombineMode, setUserData, setZOrder, setZOrder, toString, unlock, unlock, unlockBounds, unlockBranch, unlockMeshes, unlockShadows, unlockTransforms, updateGeometricState, updateRenderState, updateRenderState, updateWorldData, updateWorldRotation, updateWorldScale, updateWorldTranslation, updateWorldVectors, updateWorldVectors, worldToLocal

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.jme.util.export.Savable

getClassTag

Constructor Detail

CatmullRomCurve

public CatmullRomCurve()

CatmullRomCurve

public CatmullRomCurve(java.lang.String name)

Constructor instantiates a new CatmullRomCurve object.

Parameters:

name - the name of the scene element. This is required for identification and comparision purposes.

CatmullRomCurve

public CatmullRomCurve(java.lang.String name,
                       Vector3f[] controlPoints)

Constructor instantiates a new CatmullRomCurve object. The control points that define the curve are supplied.

Parameters:

name - the name of the scene element. This is required for identification and comparision purposes.

controlPoints - the points that define the curve.

Method Detail

getOrientation

public Matrix3f getOrientation(float time,
                               float precision)

getOrientation calculates the rotation matrix for any given point along to the line to still be facing in the direction of the line.

Specified by:

getOrientation in class Curve

Parameters:

time - the current time (between 0 and 1)

precision - how accurate to (i.e. the next time) to check against.

Returns:

the rotation matrix.

See Also:

Curve.getOrientation(float, float)

getOrientation

public Matrix3f getOrientation(float time,
                               float precision,
                               Vector3f up)

getOrientation calculates the rotation matrix for any given point along to the line to still be facing in the direction of the line. A up vector is supplied, this keep the rotation matrix following the line, but insures the object's up vector is not drastically changed.

Specified by:

getOrientation in class Curve

Parameters:

time - the current time (between 0 and 1)

precision - how accurate to (i.e. the next time) to check against.

up - the up vector to lock.

Returns:

the rotation matrix.

See Also:

Curve.getOrientation(float, float)

getPoint

public Vector3f getPoint(float time)

Description copied from class: Curve

getPoint calculates a point on the curve based on the time, where time is [0, 1]. How the point is calculated is defined by the subclass.

Specified by:

getPoint in class Curve

Parameters:

time - the time frame on the curve, [0, 1].

Returns:

the point on the curve at a specified time.

getPoint

public Vector3f getPoint(float time,
                         Vector3f point)

getPoint calculates a point on a Catmull-Rom curve from a given time value within the interval [0, 1]. If the value is zero or less, the first control point is returned. If the value is one or more, the last control point is returned. Using the equation of a Catmull-Rom Curve, the point at the interval is calculated and returned.

Specified by:

getPoint in class Curve

Parameters:

time - the time frame on the curve: [0, 1].

point - the vector3f object to store the point in.

Returns:

store, after receiving the result.

See Also:

Curve.getPoint(float)

findCollisions

public void findCollisions(Spatial scene,
                           CollisionResults results,
                           int requiredOnBits)

Description copied from class: Spatial

checks this spatial against a second spatial, any collisions are stored in the results object.

Specified by:

findCollisions in class Spatial

Parameters:

scene - the scene to test against.

results - the results of the collisions.

requiredOnBits - considered a collision only if these bits are 'on' in both 'this' and the 'scene' spatial.

hasCollision

public boolean hasCollision(Spatial scene,
                            boolean checkTriangles,
                            int requiredOnBits)

Description copied from class: Spatial

Checks this spatial against a second spatial for collisions.

Specified by:

hasCollision in class Spatial

Parameters:

scene - the scene to test against.

checkTriangles - check for collisions on triangle accuracy level

requiredOnBits - considered a collision only if these bits are 'on' in both 'this' and the 'scene' spatial.

Returns:

true if any collision were found

findPick

public void findPick(Ray toTest,
                     PickResults results,
                     int requiredOnBits)

Description copied from class: Geometry

Check if this geometry intersects the ray if yes add it to the results.

Overrides:

findPick in class Geometry

Parameters:

toTest - ray to check intersection with. The direction of the ray must be normalized (length 1).

results - result list

requiredOnBits - Collision will only be considered if 'this' has these bits of its collision mask set.