SingleAxisHingeJoint
Overview
SingleAxisHingeJoint has single axis about which to rotate, similar to a traditional door hinge. Contains two RigidBody nodes (containerField values body1, body2).
The SingleAxisHingeJoint node belongs to the RigidBodyPhysics component and requires at least level 2, its default container field is joints. It is available from X3D version 3.2 or higher.
Hierarchy
1
2
3
+ X3DNode
+ X3DRigidJointNode
+ SingleAxisHingeJoint
Fields
SFNode [in, out] metadata NULL [X3DMetadataObject]
Information about this node can be contained in a MetadataBoolean, MetadataDouble, MetadataFloat, MetadataInteger, MetadataString or MetadataSet node.
Hint
MFString [in, out] forceOutput “NONE” [“ALL”, “NONE”, …]
forceOutput controls which output fields are generated for the next frame. Values are ALL, NONE, or exact names of output fields updated at start of next frame.
SFVec3f [in, out] anchorPoint 0 0 0 (-∞,∞)
anchorPoint is joint center, specified in world coordinates.
SFVec3f [in, out] axis 0 1 0 (-∞,∞)
axis defines vector of joint connection between body1 and body2.
SFFloat [in, out] minAngle -π [-π,π) not supported
minAngle is minimum rotation angle for hinge.
Hint
SFFloat [in, out] maxAngle π [-π,π) not supported
maxAngle is maximum rotation angle for hinge.
Hint
SFFloat [in, out] stopBounce 0 [0,1] not supported
stopBounce is velocity factor for bounce back once stop point is reached.
Hint
- 0 means no bounce, 1 means return velocity matches.
SFFloat [in, out] stopErrorCorrection 0.8 [0,1] not supported
stopErrorCorrection is fraction of error correction performed during time step once stop point is reached.
Hint
- 0 means no error correction, 1 means all error corrected in single step.
SFVec3f [out] body1AnchorPoint
body1AnchorPoint describes anchorPoint position relative to local coordinate reference frame.
Hint
- Can detect separation if body1AnchorPoint!=body2AnchorPoint.
Warning
- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
SFVec3f [out] body2AnchorPoint
body2AnchorPoint describes anchorPoint position relative to local coordinate reference frame.
Hint
- Can detect separation if body1AnchorPoint!=body2AnchorPoint.
Warning
- It is an error to define this transient outputOnly field in an X3D file, instead only use it a source for ROUTE events.
SFFloat [out] angle
Output field angle.
SFFloat [out] angleRate
Output field angleRate.
SFNode [in, out] body1 NULL [RigidBody]
The body1 and body2 fields indicate the two RigidBody nodes connected by this joint.
SFNode [in, out] body2 NULL [RigidBody]
The body1 and body2 fields indicate the two RigidBody nodes connected by this joint.
Advice
Hint
- RigidBodyPhysics component, level 2.