Post

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.

Example

See Also

This post is licensed under CC BY 4.0 by the author.