collider-capability#

Code

RB.COL.001

Version

1.0.0

Validator

Compatibility

open-usd

Tags

🔑

Summary#

Colliding Gprims must apply the Collision API.

Description#

UsdPhysics defines collisions through UsdPhysicsCollisionAPI. UsdGeomGPrim types that should be part of the collision representation must have UsdPhysicsCollisionAPI.

The Collision API can not be applied to xforms.

Why is it required?#

  • Assets with collision API will collide during simulation based on the UsdGeomGPrim geometry definition.

  • Assets with collision API define volume hence mass properties can be computed.

Examples#

Invalid: Collision on non UsdGeomGPrim#

#usda 1.0

def Xform "xform" (
   prepend apiSchemas = ["PhysicsCollisionAPI"]
) {
}

Valid: Collision on UsdGeomGPrim#

#usda 1.0

def Cube "cube" (
   prepend apiSchemas = ["PhysicsCollisionAPI"]
) {
}

How to comply#

UsdPhysicsCollisionAPI has to be applied to a UsdGeomGPrim.

For More Information#