PxQueryCache Struct Reference

single hit cache for scene queries. More...

#include <PxScene.h>

Collaboration diagram for PxQueryCache:

Public Member Functions

PX_INLINE PxQueryCache ()
 constructor sets to default More...
 
PX_INLINE PxQueryCache (PxShape *s, PxU32 findex)
 constructor to set properties More...
 

Public Attributes

PxShapeshape
 Shape to test for intersection first. More...
 
PxRigidActoractor
 Actor to which the shape belongs. More...
 
PxU32 faceIndex
 Triangle index to test first - NOT CURRENTLY SUPPORTED. More...
 

Detailed Description

single hit cache for scene queries.

If a cache object is supplied to a scene query, the cached actor/shape pair is checked for intersection first.

Note
Filters are not executed for the cached shape.
If intersection is found, the hit is treated as blocking.
Typically actor and shape from the last PxHitCallback.block query result is used as a cached actor/shape pair.
Using past touching hits as cache will produce incorrect behavior since the cached hit will always be treated as blocking.
Cache is only used if no touch buffer was provided, for single nearest blocking hit queries and queries using eANY_HIT flag.
if non-zero touch buffer was provided, cache will be ignored
It is the user's responsibility to ensure that the shape and actor are valid, so care must be taken when deleting shapes to invalidate cached references.

The faceIndex field is an additional hint for a mesh or height field which is not currently used.

See also
PxScene.raycast

Constructor & Destructor Documentation

◆ PxQueryCache() [1/2]

PX_INLINE PxQueryCache::PxQueryCache ( )
inline

constructor sets to default

◆ PxQueryCache() [2/2]

PX_INLINE PxQueryCache::PxQueryCache ( PxShape s,
PxU32  findex 
)
inline

constructor to set properties

Member Data Documentation

◆ actor

PxRigidActor* PxQueryCache::actor

Actor to which the shape belongs.

◆ faceIndex

PxU32 PxQueryCache::faceIndex

Triangle index to test first - NOT CURRENTLY SUPPORTED.

◆ shape

PxShape* PxQueryCache::shape

Shape to test for intersection first.


The documentation for this struct was generated from the following file: