newton.usd.find_deformable_visual_prims

newton.usd.find_deformable_visual_prims(prim)

Find the visual geometry owned by one USD deformable body.

Experimental

This function follows the AOUSD deformable proposal and may change.

Return the body’s UsdGeom.PointBased prims that apply neither a deformable simulation API nor PhysicsCollisionAPI (the proposal’s graphics geometries), in traversal order and including instance proxies. Stop at nested deformable bodies, rigid bodies, and articulation roots. Simulation geometry is any prim applying an AOUSD deformable simulation API, or a Points prim applying Newton’s NewtonPointsDeformableSimAPI; a TetMesh without one is visual geometry, as in add_usd(). Collision geometry is excluded even when collision is disabled.

This reads ownership only. It does not filter visibility or create a simulation, embedding, or render mesh. Mesh prims can be read with get_mesh().

Parameters:

prim (pxr.Usd.Prim) – Prim with PhysicsDeformableBodyAPI applied.

Returns:

Visual prims belonging to this body, not to nested bodies.

Raises:

ValueError – If prim is invalid or lacks the deformable body API.

Return type:

list[TypeAliasForwardRef(‘pxr.Usd.Prim’)]