Function physx_sys::PxScene_addActors_mut_1

pub unsafe extern "C" fn PxScene_addActors_mut_1(
    self_: *mut PxScene,
    pruningStructure: *const PxPruningStructure
) -> bool

Adds a pruning structure together with its actors to this scene. Only supports actors of type PxRigidStatic and PxRigidDynamic.

This method only supports actors of type PxRigidStatic and PxRigidDynamic. For other actors, use addActor() instead. For articulation links, use addArticulation().

If an actor in the pruning structure contains an invalid constraint, in checked builds the call is ignored and an error is issued.

For all actors in the pruning structure each assigned PxConstraint object will get added to the scene automatically if it connects to another actor that is part of the scene already.

This method is optimized for high performance.

Merging a PxPruningStructure into an active scene query optimization AABB tree might unbalance the tree. A typical use case for PxPruningStructure is a large world scenario where blocks of closely positioned actors get streamed in. The merge process finds the best node in the active scene query optimization AABB tree and inserts the PxPruningStructure. Therefore using PxPruningStructure for actors scattered throughout the world will result in an unbalanced tree.

True if success