physx::PxTaskManager Class Referenceabstract

The PxTaskManager interface. More...

#include <PxTaskManager.h>

Public Member Functions

virtual void setCpuDispatcher (PxCpuDispatcher &ref)=0
 Set the user-provided dispatcher object for CPU tasks. More...
 
virtual void setGpuDispatcher (PxGpuDispatcher &ref)=0
 Set the user-provided dispatcher object for GPU tasks. More...
 
virtual PxCpuDispatchergetCpuDispatcher () const =0
 Get the user-provided dispatcher object for CPU tasks. More...
 
virtual PxGpuDispatchergetGpuDispatcher () const =0
 Get the user-provided dispatcher object for GPU tasks. More...
 
virtual void resetDependencies ()=0
 Reset any dependencies between Tasks. More...
 
virtual void startSimulation ()=0
 Called by the owning scene to start the task graph. More...
 
virtual void stopSimulation ()=0
 Called by the owning scene at the end of a simulation step to synchronize the PxGpuDispatcher. More...
 
virtual void taskCompleted (PxTask &task)=0
 Called by the worker threads to inform the PxTaskManager that a task has completed processing. More...
 
virtual PxTaskID getNamedTask (const char *name)=0
 Retrieve a task by name. More...
 
virtual PxTaskID submitNamedTask (PxTask *task, const char *name, PxTaskType::Enum type=PxTaskType::TT_CPU)=0
 Submit a task with a unique name. More...
 
virtual PxTaskID submitUnnamedTask (PxTask &task, PxTaskType::Enum type=PxTaskType::TT_CPU)=0
 Submit an unnamed task. More...
 
virtual PxTaskgetTaskFromID (PxTaskID id)=0
 Retrieve a task given a task ID. More...
 
virtual void release ()=0
 Release the PxTaskManager object, referenced dispatchers will not be released. More...
 

Static Public Member Functions

static PxTaskManagercreateTaskManager (PxErrorCallback &errorCallback, PxCpuDispatcher *=0, PxGpuDispatcher *=0)
 Construct a new PxTaskManager instance with the given [optional] dispatchers. More...
 

Protected Member Functions

virtual ~PxTaskManager ()
 

Friends

class PxBaseTask
 
class PxTask
 
class PxLightCpuTask
 
class PxGpuWorkerThread
 

Detailed Description

The PxTaskManager interface.

A PxTaskManager instance holds references to user-provided dispatcher objects, when tasks are submitted the PxTaskManager routes them to the appropriate dispatcher and handles task profiling if enabled. Users should not implement the PxTaskManager interface, the SDK creates its own concrete PxTaskManager object per-scene which users can configure by passing dispatcher objects into the PxSceneDesc.

See also
CpuDispatcher
PxGpuDispatcher

Constructor & Destructor Documentation

◆ ~PxTaskManager()

virtual physx::PxTaskManager::~PxTaskManager ( )
inlineprotectedvirtual

Member Function Documentation

◆ createTaskManager()

static PxTaskManager* physx::PxTaskManager::createTaskManager ( PxErrorCallback errorCallback,
PxCpuDispatcher = 0,
PxGpuDispatcher = 0 
)
static

Construct a new PxTaskManager instance with the given [optional] dispatchers.

◆ getCpuDispatcher()

virtual PxCpuDispatcher* physx::PxTaskManager::getCpuDispatcher ( ) const
pure virtual

Get the user-provided dispatcher object for CPU tasks.

Returns
The CPU dispatcher object.
See also
CpuDispatcher

◆ getGpuDispatcher()

virtual PxGpuDispatcher* physx::PxTaskManager::getGpuDispatcher ( ) const
pure virtual

Get the user-provided dispatcher object for GPU tasks.

Returns
The GPU dispatcher object.
See also
PxGpuDispatcher

◆ getNamedTask()

virtual PxTaskID physx::PxTaskManager::getNamedTask ( const char *  name)
pure virtual

Retrieve a task by name.

Parameters
[in]nameThe unique name of a task
Returns
The ID of the task with that name, or TT_NOT_PRESENT if not found

◆ getTaskFromID()

virtual PxTask* physx::PxTaskManager::getTaskFromID ( PxTaskID  id)
pure virtual

Retrieve a task given a task ID.

Parameters
[in]idThe ID of the task to return, a valid ID must be passed or results are undefined
Returns
The task associated with the ID

◆ release()

virtual void physx::PxTaskManager::release ( )
pure virtual

Release the PxTaskManager object, referenced dispatchers will not be released.

◆ resetDependencies()

virtual void physx::PxTaskManager::resetDependencies ( )
pure virtual

Reset any dependencies between Tasks.

Note
Will be called at the start of every frame before tasks are submitted.
See also
PxTask

◆ setCpuDispatcher()

virtual void physx::PxTaskManager::setCpuDispatcher ( PxCpuDispatcher ref)
pure virtual

Set the user-provided dispatcher object for CPU tasks.

Parameters
[in]refThe dispatcher object.
See also
CpuDispatcher

◆ setGpuDispatcher()

virtual void physx::PxTaskManager::setGpuDispatcher ( PxGpuDispatcher ref)
pure virtual

Set the user-provided dispatcher object for GPU tasks.

Parameters
[in]refThe dispatcher object.
See also
PxGpuDispatcher

◆ startSimulation()

virtual void physx::PxTaskManager::startSimulation ( )
pure virtual

Called by the owning scene to start the task graph.

Note
All tasks with with ref count of 1 will be dispatched.
See also
PxTask

◆ stopSimulation()

virtual void physx::PxTaskManager::stopSimulation ( )
pure virtual

Called by the owning scene at the end of a simulation step to synchronize the PxGpuDispatcher.

See also
PxGpuDispatcher

◆ submitNamedTask()

virtual PxTaskID physx::PxTaskManager::submitNamedTask ( PxTask task,
const char *  name,
PxTaskType::Enum  type = PxTaskType::TT_CPU 
)
pure virtual

Submit a task with a unique name.

Parameters
[in]taskThe task to be executed
[in]nameThe unique name of a task
[in]typeThe type of the task (default TT_CPU)
Returns
The ID of the task with that name, or TT_NOT_PRESENT if not found

◆ submitUnnamedTask()

virtual PxTaskID physx::PxTaskManager::submitUnnamedTask ( PxTask task,
PxTaskType::Enum  type = PxTaskType::TT_CPU 
)
pure virtual

Submit an unnamed task.

Parameters
[in]taskThe task to be executed
[in]typeThe type of the task (default TT_CPU)
Returns
The ID of the task with that name, or TT_NOT_PRESENT if not found

◆ taskCompleted()

virtual void physx::PxTaskManager::taskCompleted ( PxTask task)
pure virtual

Called by the worker threads to inform the PxTaskManager that a task has completed processing.

Parameters
[in]taskThe task which has been completed

Referenced by physx::PxTask::release().

Friends And Related Function Documentation

◆ PxBaseTask

friend class PxBaseTask
friend

◆ PxGpuWorkerThread

friend class PxGpuWorkerThread
friend

◆ PxLightCpuTask

friend class PxLightCpuTask
friend

◆ PxTask

friend class PxTask
friend

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