PhysxPhysicsDistanceJointAPI#

Spring behaviour of a distance joint: enable flag, stiffness and damping of the spring that acts when the distance leaves [minDistance, maxDistance]. Read only on a PhysicsDistanceJoint prim; inert on every other joint type.

  • Applies to: PhysicsJoint

  • Read only when listed in usd-schemas.

What USD population writes#

All three declared attributes are published at their resolved values (false, 0, 0 when unauthored). No rewrite.

Columns#

Raw fallback is the USD schema value. Producer writes is what ovstage population puts in the column for a USD stage. Parser default applies on the consumer when the column is absent, in stage units. diverges means writing the raw fallback literally parses differently from omitting the column (the parser default): USD population may well publish that very value for an unauthored attribute, so the marker is about the column being present, not about its value.

Column

Type

Units

Raw fallback

Producer writes

Parser default

If absent

physxPhysicsDistanceJoint:springEnabled

bool8

none

false

resolved USD value (authored, else raw fallback)

false

Hard distance constraint; the spring stiffness and damping columns are then not applied (PhysxLimitAPI:distance stiffness/damping remain in effect).

physxPhysicsDistanceJoint:springStiffness

float32

force/length

0.0

resolved USD value (authored, else raw fallback)

0.0

No spring force.

physxPhysicsDistanceJoint:springDamping

float32

force*s/length

0.0

resolved USD value (authored, else raw fallback)

0.0

No spring damping.

Interactions#

  • PhysicsDistanceJoint: Read only in the distance-joint branch of the parser, gated by usd-schemas CONTAINS PhysxPhysicsDistanceJointAPI. On any other joint type the columns are ignored.

  • PhysxLimitAPI: The runtime first applies PhysxLimitAPI:distance stiffness/damping to the PxDistanceJoint, then overwrites both with the spring values when springEnabled is true.

Known divergences#

  • note (consumer) physxPhysicsDistanceJoint:springEnabled: The stage-wide presence flag present.physxDistanceJoint is computed by the walker but never consulted by the parser, which goes straight to the per-prim hasSchema probe. Dead performance gate, no correctness effect.