PxBroadcastingAllocator#

Defined in include/foundation/PxBroadcast.h

class PxBroadcastingAllocator : public PxBroadcast<PxAllocationListener, PxAllocatorCallback>#

Abstract base class for an application defined memory allocator that allows an external listener to audit the memory allocations.

Public Functions

inline PxBroadcastingAllocator(
PxAllocatorCallback &allocator,
PxErrorCallback &error,
)#

The default constructor.

inline virtual ~PxBroadcastingAllocator()#

The default constructor.

inline virtual void *allocate(
size_t size,
const char *typeName,
const char *filename,
int line,
)#

Allocates size bytes of memory, which must be 16-byte aligned.

This method should never return NULL. If you run out of memory, then you should terminate the app or take some other appropriate action.

Threading: This function should be thread safe as it can be called in the context of the user thread and physics processing thread(s).

Parameters:

  • size – Number of bytes to allocate.

  • typeName – Name of the datatype that is being allocated

  • filename – The source file which allocated the memory

  • line – The source line which allocated the memory

Returns:

The allocated block of memory.

inline virtual void deallocate(void *ptr)#

Frees memory previously allocated by allocate().

Threading: This function should be thread safe as it can be called in the context of the user thread and physics processing thread(s).

Parameters:

ptr – Memory to free.

inline void registerListener(PxAllocationListener &listener)#

Register new listener.

Note

It is NOT SAFE to register and deregister listeners while allocations may be taking place. moreover, there is no thread safety to registration/deregistration.

Parameters:

listener – Listener to register.

inline void deregisterListener(PxAllocationListener &listener)#

Deregister an existing listener.

Note

It is NOT SAFE to register and deregister listeners while allocations may be taking place. moreover, there is no thread safety to registration/deregistration.

Parameters:

listener – Listener to deregister.

inline uint32_t getNbListeners() const#

Get number of registered listeners.

Returns:

Number of listeners.

inline PxAllocationListener &getListener(uint32_t index)#

Get an existing listener from given index.

Parameters:

index – Index of the listener.

Returns:

Listener on given index.

Public Static Attributes

static const uint32_t MAX_NB_LISTENERS#

Protected Attributes

physx::PxInlineArray<PxAllocationListener*, MAX_NB_LISTENERS, physx::PxAllocator> mListeners#
On this page