pub unsafe extern "C" fn PxSimulationFilterCallback_statusChange_mut(
self_: *mut PxSimulationFilterCallback,
pairID: *mut u32,
pairFlags: *mut PxPairFlags,
filterFlags: *mut PxFilterFlags
) -> bool
Expand description
Callback to give the opportunity to change the filter state of a tracked collision pair.
This method gets called once per simulation step to let the application change the filter and pair
flags of a collision pair that has been reported in pairFound
and requested callbacks by
setting [PxFilterFlag::eNOTIFY
]. To request a change of filter status, the target pair has to be
specified by its ID, the new filter and pair flags have to be provided and the method should return true.
If this method changes the filter status of a collision pair and the pair should keep being tracked
by the filter callbacks then [PxFilterFlag::eNOTIFY
] has to be set.
The application is responsible to ensure that this method does not get called for pairs that have been
reported as lost, see pairLost
.
True if the changes should be applied. In this case the method will get called again. False if no more status changes should be done in the current simulation step. In that case the provided flags will be discarded.