artisynth.core.mechmodels

Class SliderJoint

java.lang.Object

artisynth.core.modelbase.ModelComponentBase

artisynth.core.modelbase.RenderableComponentBase

artisynth.core.mechmodels.BodyConnector

artisynth.core.mechmodels.JointBase

artisynth.core.mechmodels.SliderJoint

All Implemented Interfaces:

Constrainer, CopyableComponent, HasCoordinateFrame, HasNumericState, ModelComponent, PostScannable, RenderableComponent, TransformableGeometry, ScalableUnits, java.lang.Cloneable, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Scannable

public class SliderJoint
extends JointBase
implements CopyableComponent

Implements a 1 DOF prismatic joint, in which frame C translates along the z axis of frame D by a distance z.

The z value is available as a property which can be read and also, under appropriate circumstances, set. Setting this value causes an adjustment in the positions of one or both bodies connected to this joint, along with adjacent bodies connected to them, with preference given to bodies that are not attached to ``ground''. If this is done during simulation, and particularly if one or both of the bodies connected to this joint are moving dynamically, the results will be unpredictable and will likely conflict with the simulation.

Nested Class Summary

Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent

ModelComponent.NavpanelVisibility

Field Summary

Fields

Modifier and Type	Field and Description
static PropertyList	myProps
static int	Z_IDX

Fields inherited from class artisynth.core.mechmodels.JointBase

DEFAULT_SHAFT_LENGTH, DEFAULT_SHAFT_RADIUS

Fields inherited from class artisynth.core.mechmodels.BodyConnector

debug, useOldDerivativeMethod

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames

Fields inherited from interface artisynth.core.modelbase.CopyableComponent

COPY_REFERENCES, REST_POSITION

Fields inherited from interface artisynth.core.modelbase.TransformableGeometry

TG_ARTICULATED, TG_DRAGGER, TG_PRESERVE_ORIENTATION, TG_SIMULATING

Fields inherited from interface maspack.render.IsRenderable

TRANSPARENT, TWO_DIMENSIONAL

Constructor Summary

Constructors

Constructor and Description
SliderJoint() Creates a PrismaticJoint which is not attached to any bodies.
SliderJoint(ConnectableBody bodyA, ConnectableBody bodyB, RigidTransform3d TDW) Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB.
SliderJoint(ConnectableBody bodyA, ConnectableBody bodyB, RigidTransform3d TCW, RigidTransform3d TDW) Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB.
SliderJoint(ConnectableBody bodyA, RigidTransform3d TDW) Creates a PrismaticJoint connecting a single connectable body, bodyA, to ground.
SliderJoint(RigidBody bodyA, ConnectableBody bodyB, Point3d originD, Vector3d zaxis) Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB.
SliderJoint(RigidBody bodyA, RigidTransform3d TCA, RigidBody bodyB, RigidTransform3d TDB) Creates a PrismaticJoint connecting two rigid bodies, bodyA and bodyB.

Method Summary

Modifier and Type	Method and Description
PropertyList	getAllPropertyInfo() Returns a list giving static information about all properties exported by this object.
double	getMaxZ() Queries the upper z range limit for this joint, in degrees.
double	getMinZ() Queries the lower z range limit for this joint, in degrees.
double	getZ() Queries this joint's z value.
DoubleInterval	getZRange() Queries the z range limits for this joint.
boolean	isZLocked() Queries whether the z coordinate for this joint is locked.
void	render(Renderer renderer, int flags) Render this object using the functionality of the supplied Renderer.
void	setMaxZ(double max) Sets the upper z range limit for this joint.
void	setMinZ(double min) Sets the lower z range limit for this joint.
void	setZ(double z) Sets this joint's z value.
void	setZLocked(boolean locked) Set whether the z coordinate for this joint is locked.
void	setZRange(double min, double max) Sets the z range limits for this joint.
void	setZRange(DoubleInterval range) Sets the z range limits for this joint.
void	updateBounds(Vector3d pmin, Vector3d pmax) Update the minimum and maximum points for this object.

Methods inherited from class artisynth.core.mechmodels.JointBase

addCoordinateSolveBlocks, addCoordinateVelJacobian, applyCoordinateForce, coordinatesToTCD, getCoordinate, getCoordinateDeg, getCoordinateIndex, getCoordinateMotionType, getCoordinateName, getCoordinateRange, getCoordinateRangeDeg, getCoordinates, getCoordinateSpeed, getCoordinateValue, getMaxCoordinate, getMaxCoordinateDeg, getMinCoordinate, getMinCoordinateDeg, getPosition, getShaftLength, getShaftRadius, getStoredCoordinates, getStoredTCD, getStoredTCD, isCoordinateLocked, numCoordinates, setCoordinate, setCoordinateDeg, setCoordinateLocked, setCoordinateName, setCoordinateRange, setCoordinateRangeDeg, setCoordinates, setShaftLength, setShaftRadius

Methods inherited from class artisynth.core.mechmodels.BodyConnector

addBilateralConstraints, addFrictionConstraints, addMasterBlocks, addTransformableDependencies, addUnilateralConstraints, computeConstraintMatrixA, computeConstraintMatrixB, connectToHierarchy, copy, disconnectFromHierarchy, findAttachedBodies, getActivation, getAxisLength, getBilateralForceInA, getBilateralForceInA, getBilateralForceInB, getBilateralForceInB, getBilateralForceInC, getBilateralForceInC, getBilateralForces, getBilateralInfo, getBilateralSizes, getBodyA, getBodyB, getCompliance, getConstrainedComponents, getConstraint, getConstraintFlags, getConstraintForce, getCopyReferences, getCoupling, getCurrentTCD, getCurrentTCW, getCurrentTCW, getCurrentTDW, getCurrentTDW, getDamping, getDrawFrameC, getDrawFrameD, getFrameAttachmentA, getFrameAttachmentB, getFrictionForces, getFrictionState, getHardReferences, getLinearCompliance, getPenetrationTol, getPenetrationTolMode, getPose, getRenderFrame, getRotaryCompliance, getRotaryLimitTol, getRotaryLimitTolMode, getState, getStateVersion, getTransformDGeometryOnly, getTransformPositionOnly, getUnilateralForceInA, getUnilateralForceInA, getUnilateralForceInB, getUnilateralForceInB, getUnilateralForceInC, getUnilateralForceInC, getUnilateralForces, getUnilateralInfo, getUnilateralSizes, getUnilateralState, hasState, isActive, isConnectedToBodies, isDuplicatable, isEnabled, isNotAttached, maxFrictionConstraintSets, numBilateralConstraints, numConstraints, numEngagedUnilateralConstraints, numUnilateralConstraints, prerender, printConnectedBodies, printConstraintInfo, scaleDistance, scaleMass, setAlwaysAdjustBodyA, setAxisLength, setBilateralForces, setBodies, setBodies, setBodies, setBodies, setCompliance, setCurrentTCW, setCurrentTDW, setDamping, setDrawFrameC, setDrawFrameD, setEnabled, setFrictionForces, setFrictionState, setLinearCompliance, setPenetrationTol, setPenetrationTolMode, setRotaryCompliance, setRotaryLimitTol, setRotaryLimitTolMode, setState, setTransformDGeometryOnly, setTransformPositionOnly, setUnilateralForces, setUnilateralState, transformGeometry, transformGeometry, updateAttachments, updateConstraints, zeroForces

Methods inherited from class artisynth.core.modelbase.RenderableComponentBase

createRenderProps, defaultRenderPropsAreNull, getRenderHints, getRenderProps, getSelection, isSelectable, isVisible, numSelectionQueriesNeeded, setRenderProps, setVisible, updateRenderProps

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

checkFlag, checkName, checkNameUniqueness, clearFlag, clone, createTempFlag, getChildren, getGrandParent, getName, getNameRange, getNavpanelVisibility, getNavpanelVisibility, getNumber, getParent, getProperty, getSoftReferences, hasChildren, isFixed, isMarked, isScanning, isSelected, isWritable, makeValidName, makeValidName, notifyParentOfChange, postscan, printReferences, recursivelyContained, recursivelyContains, removeTempFlag, scan, setFixed, setFlag, setMarked, setName, setNavpanelVisibility, setNavpanelVisibility, setNumber, setParent, setScanning, setSelected, setWritable, updateReferences, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface artisynth.core.modelbase.CopyableComponent

copy, getCopyReferences, isDuplicatable

Methods inherited from interface artisynth.core.modelbase.ModelComponent

connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, hasState, isFixed, isMarked, isSelected, notifyParentOfChange, scan, setFixed, setMarked, setName, setNumber, setParent, setSelected, setWritable, updateReferences

Methods inherited from interface maspack.properties.HasProperties

getProperty

Methods inherited from interface maspack.properties.HierarchyNode

getChildren, hasChildren

Methods inherited from interface artisynth.core.modelbase.PostScannable

postscan

Methods inherited from interface maspack.util.Scannable

isWritable, write

Methods inherited from interface artisynth.core.modelbase.HasNumericState

advanceState, getAuxVarDerivative, getAuxVarState, numAuxVars, requiresAdvance, setAuxVarState

Field Detail

Z_IDX

public static final int Z_IDX

See Also:

Constant Field Values

myProps

public static PropertyList myProps

Constructor Detail

SliderJoint

public SliderJoint()

Creates a PrismaticJoint which is not attached to any bodies. It can subsequently be connected using one of the setBodies methods.

SliderJoint

public SliderJoint(RigidBody bodyA,
                   RigidTransform3d TCA,
                   RigidBody bodyB,
                   RigidTransform3d TDB)

Creates a PrismaticJoint connecting two rigid bodies, bodyA and bodyB. If A and B describe the coordinate frames of bodyA and bodyB, then TCA and TDB give the (fixed) transforms from the joint's C and D frames to A and B, respectively. Since C and D are specified independently, the joint transform TCD may not necessarily be initialized to the identity.

Specifying bodyB as null will cause bodyA to be connected to ground, with TDB then being the same as TDW.

Parameters:

bodyA - rigid body A

TCA - transform from joint frame C to body frame A

bodyB - rigid body B (or null)

TDB - transform from joint frame D to body frame B

SliderJoint

public SliderJoint(ConnectableBody bodyA,
                   ConnectableBody bodyB,
                   RigidTransform3d TCW,
                   RigidTransform3d TDW)

Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB. The joint frames C and D are located independently with respect to world coordinates by TCW and TDW.

Specifying bodyB as null will cause bodyA to be connected to ground.

Parameters:

bodyA - body A

bodyB - body B (or null)

TCW - initial transform from joint frame C to world

TDW - initial transform from joint frame D to world

SliderJoint

public SliderJoint(ConnectableBody bodyA,
                   ConnectableBody bodyB,
                   RigidTransform3d TDW)

Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB. The joint frames D and C are assumed to be initially coincident, so that z will have an initial value of 0. D (and C) is located by TDW, which gives the transform from D to world coordinates.

Parameters:

bodyA - body A

bodyB - body B

TDW - initial transform from joint frames D and C to world

SliderJoint

public SliderJoint(ConnectableBody bodyA,
                   RigidTransform3d TDW)

Creates a PrismaticJoint connecting a single connectable body, bodyA, to ground. The joint frames D and C are assumed to be initially coincident, so that z will have an initial value of 0. D (and C) is located by TDW, which gives the transform from D to world coordinates.

Parameters:

bodyA - body A

TDW - initial transform from joint frames D and C to world

SliderJoint

public SliderJoint(RigidBody bodyA,
                   ConnectableBody bodyB,
                   Point3d originD,
                   Vector3d zaxis)

Creates a PrismaticJoint connecting two connectable bodies, bodyA and bodyB. The joint frames D and C are assumed to be initially coincident, so that z will have an initial value of 0. D (and C) is located (with respect to world) so that its origin is at pd and its z axis in the direction of zaxis.

Specifying bodyB as null will cause bodyA to be connected to ground.

Parameters:

bodyA - body A

bodyB - body B, or null if bodyA is connected to ground.

originD - origin of frame D (world coordinates)

zaxis - direction of frame D's z axis (world coordinates)

Method Detail

getAllPropertyInfo

public PropertyList getAllPropertyInfo()

Description copied from interface: HasProperties

Returns a list giving static information about all properties exported by this object.

Specified by:

getAllPropertyInfo in interface HasProperties

Overrides:

getAllPropertyInfo in class JointBase

Returns:

static information for all exported properties

getZ

public double getZ()

Queries this joint's z value. See setZ(double) for more details.

Returns:

current z value

setZ

public void setZ(double z)

Sets this joint's z value. This describes the displacement of frame C along the z axis of frame D. See this class's Javadoc header for a discussion of what happens when this value is set.

Parameters:

z - new z value

getZRange

public DoubleInterval getZRange()

Queries the z range limits for this joint. See setZRange(DoubleInterval) for more details.

Returns:

z range limits for this joint

getMinZ

public double getMinZ()

Queries the lower z range limit for this joint, in degrees.

Returns:

lower z range limit

getMaxZ

public double getMaxZ()

Queries the upper z range limit for this joint, in degrees.

Returns:

upper z range limit

setZRange

public void setZRange(DoubleInterval range)

Sets the z range limits for this joint. The default range is [-inf, inf], which implies no limits. If z travels beyond these limits during dynamic simulation, unilateral constraints will be activated to enforce them. Setting the lower limit to -inf or the upper limit to inf removes the lower or upper limit, respectively. Specifying range as null will set the range to (-inf, inf).

Parameters:

range - z range limits for this joint

setZRange

public void setZRange(double min,
                      double max)

Sets the z range limits for this joint. This is a convenience wrapper for setZRange(DoubleInterval).

Parameters:

min - minimum z value

max - maximum z value

setMaxZ

public void setMaxZ(double max)

Sets the upper z range limit for this joint. Setting a value of inf removes the upper limit.

Parameters:

max - upper z range limit

setMinZ

public void setMinZ(double min)

Sets the lower z range limit for this joint. Setting a value of -inf removes the lower limit.

Parameters:

min - lower z range limit

isZLocked

public boolean isZLocked()

Queries whether the z coordinate for this joint is locked.

Returns:

true if z is locked

setZLocked

public void setZLocked(boolean locked)

Set whether the z coordinate for this joint is locked.

Parameters:

locked - if true, locks z

updateBounds

public void updateBounds(Vector3d pmin,
                         Vector3d pmax)

Description copied from interface: IsRenderable

Update the minimum and maximum points for this object. In an x-y-z coordinate system with x directed to the right and y directed upwards, the minimum and maximum points can be thought of as defining the left-lower-far and right-upper-near corners of a bounding cube. This method should only reduce the elements of the minimum point and increase the elements of the maximum point, since it may be used as part of an iteration to determine the bounding cube for several different objects.

Specified by:

updateBounds in interface IsRenderable

Overrides:

updateBounds in class BodyConnector

Parameters:

pmin - minimum point

pmax - maximum point

render

public void render(Renderer renderer,
                   int flags)

Description copied from interface: IsRenderable

Render this object using the functionality of the supplied Renderer.

Specified by:

render in interface IsRenderable

Overrides:

render in class BodyConnector

Parameters:

renderer - provides the functionality used to perform the rendering.

flags - flags that may be used to control different aspects of the rendering. Flags are defined in Renderer and currently include Renderer.HIGHLIGHT and Renderer.SORT_FACES.