Function physx_sys::PxAggregate_addActor_mut
source · pub unsafe extern "C" fn PxAggregate_addActor_mut(
self_: *mut PxAggregate,
actor: *mut PxActor,
bvh: *const PxBVH
) -> bool
Expand description
Adds an actor to the aggregate object.
A warning is output if the total number of actors is reached, or if the incoming actor already belongs to an aggregate.
If the aggregate belongs to a scene, adding an actor to the aggregate also adds the actor to that scene.
If the actor already belongs to a scene, a warning is output and the call is ignored. You need to remove the actor from the scene first, before adding it to the aggregate.
When a BVH is provided the actor shapes are grouped together. The scene query pruning structure inside PhysX SDK will store/update one bound per actor. The scene queries against such an actor will query actor bounds and then make a local space query against the provided BVH, which is in actor’s local space.