Enum physx_sys::PxDynamicTreeSecondaryPruner

#[repr(i32)]
pub enum PxDynamicTreeSecondaryPruner {
    None,
    Bucket,
    Incremental,
    Bvh,
    Last,
}

Secondary pruning structure used for newly added objects in dynamic trees.

Dynamic trees (PxPruningStructureType::eDYNAMIC_AABB_TREE) are slowly rebuilt over several frames. A secondary pruning structure holds and manages objects added to the scene while this rebuild is in progress.

eNONE ignores newly added objects. This means that for a number of frames (roughly defined by PxSceneQueryDesc::dynamicTreeRebuildRateHint) newly added objects will be ignored by scene queries. This can be acceptable when streaming large worlds, e.g. when the objects added at the boundaries of the game world don’t immediately need to be visible from scene queries (it would be equivalent to streaming that data in a few frames later). The advantage of this approach is that there is no CPU cost associated with inserting the new objects in the scene query data structures, and no extra runtime cost when performing queries.

eBUCKET uses a structure similar to PxPruningStructureType::eNONE. Insertion is fast but query cost can be high.

eINCREMENTAL uses an incremental AABB-tree, with no direct PxPruningStructureType equivalent. Query time is fast but insertion cost can be high.

eBVH uses a PxBVH structure. This usually offers the best overall performance.

Variants

None

no secondary pruner, new objects aren’t visible to SQ for a few frames

Bucket

bucket-based secondary pruner, faster updates, slower query time

Incremental

incremental-BVH secondary pruner, faster query time, slower updates

Bvh

PxBVH-based secondary pruner, good overall performance

Last

Trait Implementations

impl Clone for PxDynamicTreeSecondaryPruner

fn clone(&self) -> PxDynamicTreeSecondaryPruner

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PxDynamicTreeSecondaryPruner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<PxDynamicTreeSecondaryPruner> for PxDynamicTreeSecondaryPruner

fn eq(&self, other: &PxDynamicTreeSecondaryPruner) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PxDynamicTreeSecondaryPruner

impl Eq for PxDynamicTreeSecondaryPruner

impl StructuralEq for PxDynamicTreeSecondaryPruner

impl StructuralPartialEq for PxDynamicTreeSecondaryPruner