HdRetainedSceneIndex Class Reference

Concrete scene container which can be externally populated and dirtied. More...

+ Inheritance diagram for HdRetainedSceneIndex:

Public Types

using AddedPrimEntries = std::vector< AddedPrimEntry >
 
- Public Types inherited from TfRefBase
typedef void(* UniqueChangedFuncPtr) (TfRefBase const *, bool)
 

Public Member Functions

virtual void AddPrims (const AddedPrimEntries &entries)
 Add a prim to the retained scene index. More...
 
virtual void RemovePrims (const HdSceneIndexObserver::RemovedPrimEntries &entries)
 Removes a prim subtree from the retained scene index. More...
 
virtual void DirtyPrims (const HdSceneIndexObserver::DirtiedPrimEntries &entries)
 Invalidates prim data in the retained scene index. More...
 
HdSceneIndexPrim GetPrim (const SdfPath &primPath) const override
 Returns a pair of (prim type, datasource) for the object at primPath. More...
 
SdfPathVector GetChildPrimPaths (const SdfPath &primPath) const override
 Returns the paths of all scene index prims located immediately below primPath. More...
 
- Public Member Functions inherited from HdSceneIndexBase
HD_API void AddObserver (const HdSceneIndexObserverPtr &observer)
 Adds an observer to this scene index. More...
 
HD_API void RemoveObserver (const HdSceneIndexObserverPtr &observer)
 Removes an observer from this scene index; the given observer will no longer be forwarded notices. More...
 
HdDataSourceBaseHandle GetDataSource (const SdfPath &primPath, const HdDataSourceLocator &locator) const
 A convenience function: look up the object at primPath, and if successful return the datasource at locator within that prim. More...
 
- Public Member Functions inherited from TfRefBase
size_t GetCurrentCount () const
 Return the current reference count of this object. More...
 
bool IsUnique () const
 Return true if only one TfRefPtr points to this object. More...
 
const TfRefCountGetRefCount () const
 
void SetShouldInvokeUniqueChangedListener (bool shouldCall)
 
- Public Member Functions inherited from TfWeakBase
 TfWeakBase (const TfWeakBase &)
 
const TfWeakBase__GetTfWeakBase__ () const
 
const TfWeakBaseoperator= (const TfWeakBase &)
 
void EnableNotification2 () const
 
TF_API void const * GetUniqueIdentifier () const
 

Static Public Member Functions

static HdRetainedSceneIndexRefPtr New ()
 Creates a new retained scene index. More...
 
- Static Public Member Functions inherited from TfRefBase
static TF_API void SetUniqueChangedListener (UniqueChangedListener listener)
 

Additional Inherited Members

- Protected Member Functions inherited from HdSceneIndexBase
HD_API void _SendPrimsAdded (const HdSceneIndexObserver::AddedPrimEntries &entries)
 Notify attached observers of prims added to the scene. More...
 
HD_API void _SendPrimsRemoved (const HdSceneIndexObserver::RemovedPrimEntries &entries)
 Notify attached observers of prims removed from the scene. More...
 
HD_API void _SendPrimsDirtied (const HdSceneIndexObserver::DirtiedPrimEntries &entries)
 Notify attached observers of datasource invalidations from the scene. More...
 
HD_API bool _IsObserved () const
 Returns whether the scene index has any registered observers; this information can be used to skip work preparing notices when there are no observers. More...
 
- Protected Member Functions inherited from TfWeakBase
TfRefPtr< Tf_Remnant > _Register () const
 
template<class T >
TfRefPtr< Tf_Remnant > _Register (T *tempRmnt) const
 
bool _HasRemnant () const
 

Detailed Description

Concrete scene container which can be externally populated and dirtied.

Definition at line 43 of file retainedSceneIndex.h.

Member Function Documentation

◆ AddPrims()

virtual void AddPrims ( const AddedPrimEntries &  entries)
virtual

Add a prim to the retained scene index.

Each added entry has a path, type, and datasource; the retained scene index assumes ownership of these and uses them to answer scene queries. This will also generate a PrimsAdded notification, if applicable.

◆ DirtyPrims()

virtual void DirtyPrims ( const HdSceneIndexObserver::DirtiedPrimEntries entries)
virtual

Invalidates prim data in the retained scene index.

This scene index doesn't have any internal invalidation mechanisms, but it generates a PrimsDirtied notification, if applicable. Subclasses can use it for invalidation of caches or retained data.

Reimplemented in HdLegacyPrimSceneIndex.

◆ GetChildPrimPaths()

SdfPathVector GetChildPrimPaths ( const SdfPath primPath) const
overridevirtual

Returns the paths of all scene index prims located immediately below primPath.

This function can be used to traverse the scene by recursing from SdfPath::AbsoluteRootPath(); such a traversal is expected to give the same set of prims as the flattening of the scene index's PrimsAdded and PrimsRemoved messages. This function is expected to be threadsafe.

Implements HdSceneIndexBase.

◆ GetPrim()

HdSceneIndexPrim GetPrim ( const SdfPath primPath) const
overridevirtual

Returns a pair of (prim type, datasource) for the object at primPath.

If no such object exists, the type will be the empty token and the datasource will be null. This function is expected to be threadsafe.

Implements HdSceneIndexBase.

◆ New()

static HdRetainedSceneIndexRefPtr New ( )
inlinestatic

Creates a new retained scene index.

Definition at line 48 of file retainedSceneIndex.h.

◆ RemovePrims()

virtual void RemovePrims ( const HdSceneIndexObserver::RemovedPrimEntries entries)
virtual

Removes a prim subtree from the retained scene index.

This will also generate a PrimsRemoved notification, if applicable.


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