This class is a collection of common functions used by pulled based executors. More...

#include <pullBasedExecutorEngine.h>

Inheritance diagram for VdfPullBasedExecutorEngine< DataManagerType >:

Public Types
typedef VdfSpeculationExecutorEngine < DataManagerType >	SpeculationExecutorEngine

Public Member Functions
	VdfPullBasedExecutorEngine (const VdfExecutorInterface &executor, DataManagerType *dataManager)

void	RunSchedule (const VdfSchedule &schedule, const VdfRequest &computeRequest, VdfExecutorErrorLogger *errorLogger)

template<typename F >
void	RunSchedule (const VdfSchedule &schedule, const VdfRequest &computeRequest, VdfExecutorErrorLogger *errorLogger, F &&callback)

Protected Types
enum	_ExecutionStage { ExecutionStageStart, ExecutionStagePreRequisitesDone, ExecutionStageReadsDone, ExecutionStageCompute }

typedef DataManagerType::DataHandle	_DataHandle

Protected Member Functions
void	_ComputeNode (const VdfEvaluationState &state, const VdfNode &node, bool absorbLockedCache=false)

bool	_PassThroughNode (const VdfSchedule &schedule, const VdfNode &node, bool absorbLockedCache=false)

VdfVector *	_CopyCache (const VdfOutput &toOutput, VdfExecutorBufferData *toBuffer, const VdfOutput &fromOutput, const VdfMask &fromMask) const

const VdfExecutorInterface &	_GetExecutor ()

DataManagerType *	_GetDataManager ()

VdfVector *	_PassOrCopySourceOutputBuffer (const _DataHandle dataHandle, const VdfOutput &output, const VdfOutput &source, const VdfMask &inputMask, const VdfSchedule &schedule)

VdfVector *	_PassOrCopyBufferInternal (const _DataHandle dataHandle, const VdfOutput &output, const VdfOutput &source, const VdfMask &inputMask, const VdfSchedule &schedule) const

void	_PrepareReadWriteBuffer (const _DataHandle dataHandle, const VdfInput &input, const VdfMask &mask, const VdfSchedule &schedule)

Static Protected Member Functions
static bool	_IsNotPassing (const VdfOutput &output, const VdfSchedule::OutputId &outputId, const VdfSchedule &schedule)

Detailed Description

template<typename DataManagerType>
class VdfPullBasedExecutorEngine< DataManagerType >

This class is a collection of common functions used by pulled based executors.

Definition at line 67 of file pullBasedExecutorEngine.h.

Member Typedef Documentation

template<typename DataManagerType >

typedef DataManagerType::DataHandle VdfPullBasedExecutorEngine< DataManagerType >::_DataHandle

protected

The data handle type from the data manager implementation.

Definition at line 116 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

typedef VdfSpeculationExecutorEngine<DataManagerType> VdfPullBasedExecutorEngine< DataManagerType >::SpeculationExecutorEngine

The equivalent speculation executor engine. Executor factories can use this typedef to map from an executor engine to a speculation executor engine with equivalent traits.

Definition at line 77 of file pullBasedExecutorEngine.h.

Member Enumeration Documentation

template<typename DataManagerType >

enum VdfPullBasedExecutorEngine::_ExecutionStage

protected

This enum describes the stages that a node goes through in execution.

Enumerator
ExecutionStageStart
ExecutionStagePreRequisitesDone
ExecutionStageReadsDone
ExecutionStageCompute

Definition at line 120 of file pullBasedExecutorEngine.h.

Constructor & Destructor Documentation

template<typename DataManagerType >

VdfPullBasedExecutorEngine< DataManagerType >::VdfPullBasedExecutorEngine	(	const VdfExecutorInterface &	executor,
		DataManagerType *	dataManager
	)

inline

Constructor.

Definition at line 81 of file pullBasedExecutorEngine.h.

Member Function Documentation

template<typename DataManagerType >

void VdfPullBasedExecutorEngine< DataManagerType >::_ComputeNode	(	const VdfEvaluationState &	state,
		const VdfNode &	node,
		bool	absorbLockedCache = `false`
	)

protected

Computes node.

This is the method that ends up calling Compute() on the VdfNode.

Definition at line 906 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

VdfVector * VdfPullBasedExecutorEngine< DataManagerType >::_CopyCache	(	const VdfOutput &	toOutput,
		VdfExecutorBufferData *	toBuffer,
		const VdfOutput &	fromOutput,
		const VdfMask &	fromMask
	)		const

protected

Helper method to _PrepareReadWriteBuffer that copies the cache from fromOutput to toOutput.

Definition at line 377 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

DataManagerType* VdfPullBasedExecutorEngine< DataManagerType >::_GetDataManager ( )

inlineprotected

Returns the data manager used by this engine.

Definition at line 178 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

const VdfExecutorInterface& VdfPullBasedExecutorEngine< DataManagerType >::_GetExecutor ( )

inlineprotected

Returns the executor running this engine.

Definition at line 174 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

static bool VdfPullBasedExecutorEngine< DataManagerType >::_IsNotPassing	(	const VdfOutput &	output,
		const VdfSchedule::OutputId &	outputId,
		const VdfSchedule &	schedule
	)

inlinestaticprotected

Returns true if the output is associative but does not pass the buffer to another output. In other words, this returns true if this is the last output in the pool chain.

Definition at line 219 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

VdfVector * VdfPullBasedExecutorEngine< DataManagerType >::_PassOrCopyBufferInternal	(	const _DataHandle	dataHandle,
		const VdfOutput &	output,
		const VdfOutput &	source,
		const VdfMask &	inputMask,
		const VdfSchedule &	schedule
	)		const

protected

Common method for _PrepareReadWriteBuffer and _PassOrCopySourceOutputBuffer that attempts to pass the buffer from source to output.

Definition at line 444 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

VdfVector * VdfPullBasedExecutorEngine< DataManagerType >::_PassOrCopySourceOutputBuffer	(	const _DataHandle	dataHandle,
		const VdfOutput &	output,
		const VdfOutput &	source,
		const VdfMask &	inputMask,
		const VdfSchedule &	schedule
	)

protected

Fast path for when we know ahead of time the output from which we wish to pass the buffer (or copy) and it is not necessarily the one that is directly connected to the output's associated input.

Definition at line 415 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

bool VdfPullBasedExecutorEngine< DataManagerType >::_PassThroughNode	(	const VdfSchedule &	schedule,
		const VdfNode &	node,
		bool	absorbLockedCache = `false`
	)

protected

Causes the outputs with associated inputs in node to have their data passed through.

For outputs that don't have associated inputs, the default value registered for the output's value type is used.

It is an error to call this method on a node that was computed with _ComputeNode() – these two calls are mutually exclusive.

Returns true if any output had data to be passed through, and false otherwise.

Definition at line 1063 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

void VdfPullBasedExecutorEngine< DataManagerType >::_PrepareReadWriteBuffer	(	const _DataHandle	dataHandle,
		const VdfInput &	input,
		const VdfMask &	mask,
		const VdfSchedule &	schedule
	)

protected

Prepares a buffer for a read/write output. This method makes sure that the output buffer has been passed down from the input. If at the input there is no buffer available for passing, this method will create a new one.

Definition at line 544 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

void VdfPullBasedExecutorEngine< DataManagerType >::RunSchedule	(	const VdfSchedule &	schedule,
		const VdfRequest &	computeRequest,
		VdfExecutorErrorLogger *	errorLogger
	)

inline

Executes the given schedule with a computeRequest and an optional /p errorLogger.

Definition at line 91 of file pullBasedExecutorEngine.h.

template<typename DataManagerType >

template<typename F >

void VdfPullBasedExecutorEngine< DataManagerType >::RunSchedule	(	const VdfSchedule &	schedule,
		const VdfRequest &	computeRequest,
		VdfExecutorErrorLogger *	errorLogger,
		F &&	callback
	)

Executes the given schedule with a computeRequest and an optional /p errorLogger. Invokes callback after evaluation of each uncached output in the request, and immediatelly after hitting the cache for cached outputs in the request.

Definition at line 322 of file pullBasedExecutorEngine.h.

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

pxr/exec/vdf/pullBasedExecutorEngine.h

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Detailed Description

template<typename DataManagerType> class VdfPullBasedExecutorEngine< DataManagerType >

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<typename DataManagerType>
class VdfPullBasedExecutorEngine< DataManagerType >