The render index is part of the Hydra 1.0 API and is only used for emulation purposes so that HdSceneDelegate's and HdRenderDelegate's can be used with scene indices through the HdRenderIndexAdapterSceneIndex and HdRenderDelegateAdapterRenderer. More...

#include <renderIndex.h>

Public Types
typedef std::vector< HdDrawItem const * >	HdDrawItemPtrVector

Public Member Functions
HD_API void	Clear ()
	Clear all r (render), s (state) and b (buffer) prims.

HD_API void	RemoveSubtree (const SdfPath &root, HdSceneDelegate *sceneDelegate)
	Clear all entries in the render index under the given root and belong to a specified delegate.

HD_API SdfPath	GetRprimPathFromPrimId (int primId) const
	Given a prim id, returns the path of the corresponding rprim or an empty path if none is found.

Synchronization
HD_API void	EnqueueCollectionToSync (HdRprimCollection const &collection)
	Hydra's core currently needs to know the collections used by tasks to aggregate the reprs that need to be synced for the dirty Rprims.

HD_API void	SyncAll (HdTaskSharedPtrVector tasks, HdTaskContext taskContext)
	Syncs input tasks, B & S prims, (external) computations and updates the Rprim dirty list to then sync the Rprims.

HD_API bool	IsSyncAllInProgress () const
	Returns true while a thread is invoking SyncAll().

Execution
HD_API HdDrawItemPtrVector	GetDrawItems (HdRprimCollection const &collection, TfTokenVector const &renderTags)
	Returns a list of relevant draw items that match the criteria specified.

Change Tracker
HdChangeTracker &	GetChangeTracker ()

HdChangeTracker const &	GetChangeTracker () const

Renderable prims (e.g. meshes, basis curves)
HD_API bool	IsRprimTypeSupported (TfToken const &typeId) const
	Returns whether the rprim type is supported by this render index.

HD_API void	InsertRprim (TfToken const &typeId, HdSceneDelegate *sceneDelegate, SdfPath const &rprimId)
	Insert a rprim into index.

HD_API void	RemoveRprim (SdfPath const &id)
	Remove a rprim from index.

bool	HasRprim (SdfPath const &id)
	Returns true if rprim `id` exists in index.

HD_API HdRprim const *	GetRprim (SdfPath const &id) const
	Returns the rprim of id.

HD_API HdSceneDelegate *	GetSceneDelegateForRprim (SdfPath const &id) const
	Returns the scene delegate for the given rprim.

HD_API bool	GetSceneDelegateAndInstancerIds (SdfPath const &id, SdfPath sceneDelegateId, SdfPath instancerId) const
	Query function to return the id's of the scene delegate and instancer associated with the Rprim at the given path.

HD_API TfToken	GetRenderTag (SdfPath const &id) const
	Returns the render tag for the given rprim.

TfToken	UpdateRenderTag (SdfPath const &id, HdDirtyBits bits)
	Like GetRenderTag, but updates the render tag if dirty.

HD_API const SdfPathVector &	GetRprimIds ()
	Returns a sorted list of all Rprims in the render index.

HD_API SdfPathVector	GetRprimSubtree (SdfPath const &root)
	Returns the subtree rooted under the given path.

Instancer Support
HD_API void	InsertInstancer (HdSceneDelegate *delegate, SdfPath const &id)
	Insert an instancer into index.

HD_API void	RemoveInstancer (SdfPath const &id)
	Remove an instancer from index.

bool	HasInstancer (SdfPath const &id)
	Returns true if instancer `id` exists in index.

HD_API HdInstancer *	GetInstancer (SdfPath const &id) const
	Returns the instancer of id.

Task Support
template<typename T >
void	InsertTask (HdSceneDelegate *delegate, SdfPath const &id)

HD_API void	RemoveTask (SdfPath const &id)

bool	HasTask (SdfPath const &id)

HD_API HdTaskSharedPtr const &	GetTask (SdfPath const &id) const
	Returns the task for the given `id`.

Scene state prims (e.g. camera, light)
HD_API bool	IsSprimTypeSupported (TfToken const &typeId) const
	Returns whether the sprim type is supported by this render index.

HD_API void	InsertSprim (TfToken const &typeId, HdSceneDelegate *delegate, SdfPath const &sprimId)
	Insert a sprim into index.

HD_API void	RemoveSprim (TfToken const &typeId, SdfPath const &id)

HD_API HdSprim *	GetSprim (TfToken const &typeId, SdfPath const &id) const

HD_API SdfPathVector	GetSprimSubtree (TfToken const &typeId, SdfPath const &root)
	Returns the subtree rooted under the given path for the given sprim type.

HD_API HdSprim *	GetFallbackSprim (TfToken const &typeId) const
	Returns the fullback prim for the Sprim of the given type.

Buffer prims (e.g. textures, buffers)
HD_API bool	IsBprimTypeSupported (TfToken const &typeId) const
	Returns whether the bprim type is supported by this render index.

HD_API void	InsertBprim (TfToken const &typeId, HdSceneDelegate *delegate, SdfPath const &bprimId)
	Insert a bprim into index.

HD_API void	RemoveBprim (TfToken const &typeId, SdfPath const &id)

HD_API HdBprim *	GetBprim (TfToken const &typeId, SdfPath const &id) const

HD_API SdfPathVector	GetBprimSubtree (TfToken const &typeId, SdfPath const &root)
	Returns the subtree rooted under the given path for the given bprim type.

HD_API HdBprim *	GetFallbackBprim (TfToken const &typeId) const
	Returns the fallback prim for the Bprim of the given type.

Scene indices
HD_API void	InsertSceneIndex (const HdSceneIndexBaseRefPtr &inputScene, SdfPath const &scenePathPrefix, bool needsPrefixing=true)

HD_API void	RemoveSceneIndex (const HdSceneIndexBaseRefPtr &inputScene)

HD_API HdSceneIndexBaseRefPtr	GetTerminalSceneIndex () const
	The terminal scene index that is driving what is in the render index through emulation.

HD_API HdSceneIndexBaseRefPtr	GetEmulationSceneIndex () const

Static Public Member Functions
static HD_API HdRenderIndex *	New (HdRenderDelegate *renderDelegate, HdDriverVector const &drivers, const std::string &instanceName=std::string(), const std::string &appName=std::string())
	"instanceName" is an optional identifier useful for applications to associate this render index with related resources (such as the scene index instances).

static HdRenderIndex *	NewForBackendEmulation (HdRenderDelegate *renderDelegate, HdDriverVector const &drivers, HdSceneIndexBaseRefPtr const &terminalSceneIndex)
	Create a render index with the given render delegate that populates itself by observing the given scene index.

static HdRenderIndex *	NewForFrontendEmulation (HdRenderDelegate *nullRenderDelegate)
	Create a render index for "front-end" emulation.

Render Delegate
class	HdSceneIndexAdapterSceneDelegate

HD_API HdRenderDelegate *	GetRenderDelegate () const
	Currently, a render index only supports connection to one type of render delegate, due to the inserted information and change tracking being specific to that delegate type.

HD_API HdDriverVector const &	GetDrivers () const

HD_API HdResourceRegistrySharedPtr	GetResourceRegistry () const
	Returns a shared ptr to the resource registry of the current render delegate.

HD_API void	SceneIndexEmulationNoticeBatchBegin ()
	An application or legacy scene delegate may prefer for the scene index observer notices generated from its prim insertions, removals, or invalidations to be consolidated into vectorized batches.

HD_API void	SceneIndexEmulationNoticeBatchEnd ()
	Flushes any queued scene index observer notices and disables further queueing.

HD_API void	MergingSceneIndexNoticeBatchBegin ()
	Consolidate notices generated by the merging scene index to vectorized batches.

HD_API void	MergingSceneIndexNoticeBatchEnd ()
	Flushes any queued scene index observer notices from the merging scene index and disables further queueing.

HD_API std::string	GetInstanceName () const

Detailed Description

The render index is part of the Hydra 1.0 API and is only used for emulation purposes so that HdSceneDelegate's and HdRenderDelegate's can be used with scene indices through the HdRenderIndexAdapterSceneIndex and HdRenderDelegateAdapterRenderer.

The Hydra render index is a flattened representation of the client scene graph, which may be composed of several self-contained scene graphs, each of which provides a HdSceneDelegate adapter for data access.

Thus, multiple HdSceneDelegate's may be tied to the same HdRenderIndex.

The render index, however, is tied to a single HdRenderDelegate, which handles the actual creation and deletion of Hydra scene primitives. These include geometry and non-drawable objects (such as the camera and texture buffers). The render index simply holds a handle to these primitives, and tracks any changes to them via the HdChangeTracker. It also tracks computations and tasks that may update resources and render a subset of the renderable primitives.

The render index orchestrates the "syncing" of scene primitives, by providing the relevant scene delegate for data access, and leaves resource management to the rendering backend (via HdResourceRegistry).

It also provides "execution" functionality for application facing Hydra concepts (such as HdTask/HdRenderPass) in computing the set of HdDrawItems for a given HdRprimCollection, for rendering.

See also: HdChangeTracker HdDrawItem HdRenderDelegate HdRprimCollection HdSceneDelegate

Note: The current design ties a HdRenderIndex to a HdRenderDelegate. However, the HdRenderIndex isn't tied to a viewer (viewport). It is common to have multiple viewers image the composed scene (for example, with different cameras), in which case the HdRenderIndex and HdRenderDelegate are shared by the viewers.

If two viewers use different HdRenderDelegate's, then it may unfortunately require populating two HdRenderIndex's.

Definition at line 109 of file renderIndex.h.

Member Typedef Documentation

◆ HdDrawItemPtrVector

std::vector<HdDrawItem const*> HdDrawItemPtrVector

Definition at line 112 of file renderIndex.h.

Member Function Documentation

◆ Clear()

HD_API void Clear ( )

Clear all r (render), s (state) and b (buffer) prims.

◆ EnqueueCollectionToSync()

HD_API void EnqueueCollectionToSync ( HdRprimCollection const & collection )

Hydra's core currently needs to know the collections used by tasks to aggregate the reprs that need to be synced for the dirty Rprims.

◆ GetBprimSubtree()

HD_API SdfPathVector GetBprimSubtree	(	TfToken const &	typeId,
		SdfPath const &	root )

Returns the subtree rooted under the given path for the given bprim type.

◆ GetChangeTracker() [1/2]

HdChangeTracker & GetChangeTracker ( )

inline

Definition at line 225 of file renderIndex.h.

◆ GetChangeTracker() [2/2]

HdChangeTracker const & GetChangeTracker ( ) const

inline

Definition at line 226 of file renderIndex.h.

◆ GetDrawItems()

HD_API HdDrawItemPtrVector GetDrawItems	(	HdRprimCollection const &	collection,
		TfTokenVector const &	renderTags )

Returns a list of relevant draw items that match the criteria specified.

The is typically called during render pass execution, which is the final phase in the Hydra's execution. See HdRenderPass::Execute

◆ GetFallbackBprim()

HD_API HdBprim * GetFallbackBprim ( TfToken const & typeId ) const

Returns the fallback prim for the Bprim of the given type.

◆ GetFallbackSprim()

HD_API HdSprim * GetFallbackSprim ( TfToken const & typeId ) const

Returns the fullback prim for the Sprim of the given type.

◆ GetInstancer()

HD_API HdInstancer * GetInstancer ( SdfPath const & id ) const

Returns the instancer of id.

◆ GetRenderDelegate()

HD_API HdRenderDelegate * GetRenderDelegate ( ) const

Currently, a render index only supports connection to one type of render delegate, due to the inserted information and change tracking being specific to that delegate type.

◆ GetRenderTag()

HD_API TfToken GetRenderTag ( SdfPath const & id ) const

Returns the render tag for the given rprim.

◆ GetResourceRegistry()

HD_API HdResourceRegistrySharedPtr GetResourceRegistry ( ) const

Returns a shared ptr to the resource registry of the current render delegate.

◆ GetRprim()

HD_API HdRprim const * GetRprim ( SdfPath const & id ) const

Returns the rprim of id.

◆ GetRprimIds()

HD_API const SdfPathVector & GetRprimIds ( )

inline

Returns a sorted list of all Rprims in the render index.

The list is sorted by std::less<SdfPath>

Definition at line 281 of file renderIndex.h.

◆ GetRprimPathFromPrimId()

HD_API SdfPath GetRprimPathFromPrimId ( int primId ) const

Given a prim id, returns the path of the corresponding rprim or an empty path if none is found.

◆ GetRprimSubtree()

HD_API SdfPathVector GetRprimSubtree ( SdfPath const & root )

Returns the subtree rooted under the given path.

◆ GetSceneDelegateAndInstancerIds()

HD_API bool GetSceneDelegateAndInstancerIds	(	SdfPath const &	id,
		SdfPath *	sceneDelegateId,
		SdfPath *	instancerId ) const

Query function to return the id's of the scene delegate and instancer associated with the Rprim at the given path.

Deprecated: . Query terminal scene index for prim and extract instancer from HdInstancedBySchema instead.

◆ GetSceneDelegateForRprim()

HD_API HdSceneDelegate * GetSceneDelegateForRprim ( SdfPath const & id ) const

Returns the scene delegate for the given rprim.

◆ GetSprimSubtree()

HD_API SdfPathVector GetSprimSubtree	(	TfToken const &	typeId,
		SdfPath const &	root )

Returns the subtree rooted under the given path for the given sprim type.

◆ GetTask()

HD_API HdTaskSharedPtr const & GetTask ( SdfPath const & id ) const

Returns the task for the given id.

◆ GetTerminalSceneIndex()

HD_API HdSceneIndexBaseRefPtr GetTerminalSceneIndex ( ) const

The terminal scene index that is driving what is in the render index through emulation.

◆ HasInstancer()

bool HasInstancer ( SdfPath const & id )

inline

Returns true if instancer id exists in index.

Definition at line 303 of file renderIndex.h.

◆ HasRprim()

bool HasRprim ( SdfPath const & id )

inline

Returns true if rprim id exists in index.

Definition at line 247 of file renderIndex.h.

◆ HasTask()

bool HasTask ( SdfPath const & id )

inline

Deprecated

In Hydra 2.0, tasks are managed by a scene index such as the HdxTaskControllerSceneIndex (reimplementing HdxTaskController).

Returns true if a task exists in the index with the given id.

Definition at line 339 of file renderIndex.h.

◆ InsertBprim()

HD_API void InsertBprim	(	TfToken const &	typeId,
		HdSceneDelegate *	delegate,
		SdfPath const &	bprimId )

Insert a bprim into index.

◆ InsertInstancer()

HD_API void InsertInstancer	(	HdSceneDelegate *	delegate,
		SdfPath const &	id )

Insert an instancer into index.

◆ InsertRprim()

HD_API void InsertRprim	(	TfToken const &	typeId,
		HdSceneDelegate *	sceneDelegate,
		SdfPath const &	rprimId )

Insert a rprim into index.

◆ InsertSprim()

HD_API void InsertSprim	(	TfToken const &	typeId,
		HdSceneDelegate *	delegate,
		SdfPath const &	sprimId )

Insert a sprim into index.

◆ InsertTask()

template<typename T >

void InsertTask	(	HdSceneDelegate *	delegate,
		SdfPath const &	id )

Deprecated

In Hydra 2.0, tasks are managed by a scene index such as the HdxTaskControllerSceneIndex (reimplementing HdxTaskController).

Inserts a new task into the render index with an identifier of id.

Definition at line 671 of file renderIndex.h.

◆ IsBprimTypeSupported()

HD_API bool IsBprimTypeSupported ( TfToken const & typeId ) const

Returns whether the bprim type is supported by this render index.

◆ IsRprimTypeSupported()

HD_API bool IsRprimTypeSupported ( TfToken const & typeId ) const

Returns whether the rprim type is supported by this render index.

◆ IsSprimTypeSupported()

HD_API bool IsSprimTypeSupported ( TfToken const & typeId ) const

Returns whether the sprim type is supported by this render index.

◆ IsSyncAllInProgress()

HD_API bool IsSyncAllInProgress ( ) const

Returns true while a thread is invoking SyncAll().

◆ MergingSceneIndexNoticeBatchBegin()

HD_API void MergingSceneIndexNoticeBatchBegin ( )

Consolidate notices generated by the merging scene index to vectorized batches.

Calling this will cause subsequent notices to be queued.

NOTE: This tracks depth internally and is safe to call in nested contexts. It is not safe to call from multiple threads, though.

◆ MergingSceneIndexNoticeBatchEnd()

HD_API void MergingSceneIndexNoticeBatchEnd ( )

Flushes any queued scene index observer notices from the merging scene index and disables further queueing.

NOTE: This tracks depth internally and is safe to call in nested contexts. It is not safe to call from multiple threads, though.

◆ New()

static HD_API HdRenderIndex * New	(	HdRenderDelegate *	renderDelegate,
		HdDriverVector const &	drivers,
		const std::string &	instanceName = std::string(),
		const std::string &	appName = std::string() )

static

"instanceName" is an optional identifier useful for applications to associate this render index with related resources (such as the scene index instances).

Deprecated: In Hydra 2.0, applications create scene indices feeding into HdRenderer.

Create a render index with the given render delegate. Returns null if renderDelegate is null. The render delegate and render tasks may require access to a renderer's device provided by the application. The objects can be passed in as 'drivers'. Hgi is an example of a HdDriver.

"appName" is an application name that is used to load scene index plugins that are enabled on a per-app basis, when scene index emulation is enabled. See HdSceneIndexPluginRegistry for more information.

◆ NewForBackendEmulation()

static HdRenderIndex * NewForBackendEmulation	(	HdRenderDelegate *	renderDelegate,
		HdDriverVector const &	drivers,
		HdSceneIndexBaseRefPtr const &	terminalSceneIndex )

static

Create a render index with the given render delegate that populates itself by observing the given scene index.

Returns null if renderDelegate is null. The render delegate and render tasks may require access to a renderer's device provided by the application. The objects can be passed in as 'drivers'. Hgi is an example of a HdDriver. hgi = Hgi::CreatePlatformDefaultHgi() hgiDriver = new HdDriver<Hgi*>(HgiTokens→renderDriver, hgi) HdRenderIndex::New(_renderDelegate, {_hgiDriver})

◆ NewForFrontendEmulation()

static HdRenderIndex * NewForFrontendEmulation ( HdRenderDelegate * nullRenderDelegate )

static

Create a render index for "front-end" emulation.

That is, the render index can be populated from an HdSceneDelegate and populates the returned emulation scene index.

The HdRenderDelegate is not populated. It is just used by the HdSceneDelegate for queries such as HdRenderDelegate::GetMaterialBindingPurpose().

◆ RemoveInstancer()

HD_API void RemoveInstancer ( SdfPath const & id )

Remove an instancer from index.

◆ RemoveRprim()

HD_API void RemoveRprim ( SdfPath const & id )

Remove a rprim from index.

◆ RemoveSubtree()

HD_API void RemoveSubtree	(	const SdfPath &	root,
		HdSceneDelegate *	sceneDelegate )

Clear all entries in the render index under the given root and belong to a specified delegate.

Used for example to unload a delegate.

◆ RemoveTask()

HD_API void RemoveTask ( SdfPath const & id )

Deprecated

In Hydra 2.0, tasks are managed by a scene index such as the HdxTaskControllerSceneIndex (reimplementing HdxTaskController).

Removes the given task from the RenderIndex.

◆ SceneIndexEmulationNoticeBatchBegin()

HD_API void SceneIndexEmulationNoticeBatchBegin ( )

An application or legacy scene delegate may prefer for the scene index observer notices generated from its prim insertions, removals, or invalidations to be consolidated into vectorized batches.

Calling this will cause subsequent notices to be queued.

NOTE: This tracks depth internally and is safe to call in nested contexts. It is not safe to call from multiple threads, though.

◆ SceneIndexEmulationNoticeBatchEnd()

HD_API void SceneIndexEmulationNoticeBatchEnd ( )

Flushes any queued scene index observer notices and disables further queueing.

NOTE: This tracks depth internally and is safe to call in nested contexts. It is not safe to call from multiple threads, though.

◆ SyncAll()

HD_API void SyncAll	(	HdTaskSharedPtrVector *	tasks,
		HdTaskContext *	taskContext )

Syncs input tasks, B & S prims, (external) computations and updates the Rprim dirty list to then sync the Rprims.

At the end of this step, all the resources that need to be updated have handles to their data sources. This is the first phase in Hydra's execution. See HdEngine::Execute

◆ UpdateRenderTag()

TfToken UpdateRenderTag	(	SdfPath const &	id,
		HdDirtyBits	bits )

Like GetRenderTag, but updates the render tag if dirty.

Friends And Related Symbol Documentation

◆ HdSceneIndexAdapterSceneDelegate

friend class HdSceneIndexAdapterSceneDelegate

friend

Definition at line 540 of file renderIndex.h.

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

pxr/imaging/hd/renderIndex.h

Public Types

Public Member Functions

Static Public Member Functions

Render Delegate

Detailed Description

Member Typedef Documentation

◆ HdDrawItemPtrVector

Member Function Documentation

◆ Clear()

◆ EnqueueCollectionToSync()

◆ GetBprimSubtree()

◆ GetChangeTracker() [1/2]

◆ GetChangeTracker() [2/2]

◆ GetDrawItems()

◆ GetFallbackBprim()

◆ GetFallbackSprim()

◆ GetInstancer()

◆ GetRenderDelegate()

◆ GetRenderTag()

◆ GetResourceRegistry()

◆ GetRprim()

◆ GetRprimIds()

◆ GetRprimPathFromPrimId()

◆ GetRprimSubtree()

◆ GetSceneDelegateAndInstancerIds()

◆ GetSceneDelegateForRprim()

◆ GetSprimSubtree()

◆ GetTask()

◆ GetTerminalSceneIndex()

◆ HasInstancer()

◆ HasRprim()

◆ HasTask()

◆ InsertBprim()

◆ InsertInstancer()

◆ InsertRprim()

◆ InsertSprim()

◆ InsertTask()

◆ IsBprimTypeSupported()

◆ IsRprimTypeSupported()

◆ IsSprimTypeSupported()

◆ IsSyncAllInProgress()

◆ MergingSceneIndexNoticeBatchBegin()

◆ MergingSceneIndexNoticeBatchEnd()

◆ New()

◆ NewForBackendEmulation()

◆ NewForFrontendEmulation()

◆ RemoveInstancer()

◆ RemoveRprim()

◆ RemoveSubtree()

◆ RemoveTask()

◆ SceneIndexEmulationNoticeBatchBegin()

◆ SceneIndexEmulationNoticeBatchEnd()

◆ SyncAll()

◆ UpdateRenderTag()

Friends And Related Symbol Documentation

◆ HdSceneIndexAdapterSceneDelegate