PhysxTriangleMeshCollisionAPI

Triangle mesh cooking parameter (weld tolerance) for a Mesh collider with physics:approximation none or sdf. Cooking input only; nothing here is verified.

• Applies to: Gprim

• Requires on the same prim: PhysicsCollisionAPI

• Read only when listed in usd-schemas.

What USD population writes

Every declared attribute of an applied collision API is published at its resolved value; the column lands as -inf when unauthored. No derivation.

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
physxTriangleMeshCollision:weldTolerance	float32	length	-inf	resolved USD value (authored, else raw fallback)	-FLT_MAX	-FLT_MAX from the TriangleMeshCookingParams constructor: no vertex welding. A published -inf (the raw fallback) is also negative and has the same effect. A NaN is rewritten to -FLT_MAX unconditionally. In the cooking task a positive value is used as the weld distance and exactly 0 selects an automatic tolerance.

Interactions

• PhysicsMeshCollisionAPI: Read by parseTriangleMeshCookingExt for descriptor kinds none and sdf. No usd-schemas gate: the column is read whenever it exists on the collider.

Notes

• Cooking APIs on a Mesh cannot be verified by the generated tests: the weld tolerance only changes the cooked PxTriangleMesh, which exposes no getter for it, and the builder writes no mesh arrays.