HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HdsiMaterialPrimvarTransferSceneIndex Class Referencefinal

#include <materialPrimvarTransferSceneIndex.h>

+ Inheritance diagram for HdsiMaterialPrimvarTransferSceneIndex:

Public Types

using ComposeFn = std::function< HdDataSourceBaseHandle(HdContainerDataSourceHandle const &, HdContainerDataSourceHandle const &, TfToken const &)>
 
- Public Types inherited from TfRefBase
typedef void(* UniqueChangedFuncPtr )(TfRefBase const *, bool)
 

Public Member Functions

HDSI_API HdSceneIndexPrim GetPrim (const SdfPath &primPath) const override
 
HDSI_API SdfPathVector GetChildPrimPaths (const SdfPath &primPath) const override
 
- Public Member Functions inherited from HdSingleInputFilteringSceneIndexBase
HD_API std::vector
< HdSceneIndexBaseRefPtr > 
GetInputScenes () const final
 
- Public Member Functions inherited from HdSceneIndexBase
HD_API HdSceneIndexBase ()
 
HD_API ~HdSceneIndexBase () override
 
HD_API void AddObserver (const HdSceneIndexObserverPtr &observer)
 
HD_API void RemoveObserver (const HdSceneIndexObserverPtr &observer)
 
HdDataSourceBaseHandle GetDataSource (const SdfPath &primPath, const HdDataSourceLocator &locator) const
 
HD_API void SystemMessage (const TfToken &messageType, const HdDataSourceBaseHandle &args)
 
HD_API std::string GetDisplayName () const
 
HD_API void SetDisplayName (const std::string &n)
 
HD_API void AddTag (const TfToken &tag)
 
HD_API void RemoveTag (const TfToken &tag)
 
HD_API bool HasTag (const TfToken &tag) const
 
HD_API TfTokenVector GetTags () const
 
- Public Member Functions inherited from TfRefBase
 TfRefBase ()
 
 TfRefBase (TfRefBase const &)
 
TfRefBaseoperator= (TfRefBase const &)
 
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...
 
void SetShouldInvokeUniqueChangedListener (bool shouldCall)
 
- Public Member Functions inherited from TfWeakBase
 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 HDSI_API
HdDataSourceBaseHandle 
DefaultComposeFn (HdContainerDataSourceHandle const &dsStrong, HdContainerDataSourceHandle const &dsWeak, const TfToken &name)
 
static HDSI_API
HdsiMaterialPrimvarTransferSceneIndexRefPtr 
New (const HdSceneIndexBaseRefPtr &inputSceneIndex, const ComposeFn &composeFn=ComposeFn())
 
- Static Public Member Functions inherited from TfRefBase
static TF_API void SetUniqueChangedListener (UniqueChangedListener listener)
 

Protected Member Functions

void _PrimsAdded (const HdSceneIndexBase &sender, const HdSceneIndexObserver::AddedPrimEntries &entries) override
 
void _PrimsRemoved (const HdSceneIndexBase &sender, const HdSceneIndexObserver::RemovedPrimEntries &entries) override
 
void _PrimsDirtied (const HdSceneIndexBase &sender, const HdSceneIndexObserver::DirtiedPrimEntries &entries) override
 
- Protected Member Functions inherited from HdSingleInputFilteringSceneIndexBase
HD_API HdSingleInputFilteringSceneIndexBase (const HdSceneIndexBaseRefPtr &inputSceneIndex)
 
virtual HD_API void _PrimsRenamed (const HdSceneIndexBase &sender, const HdSceneIndexObserver::RenamedPrimEntries &entries)
 
const HdSceneIndexBaseRefPtr & _GetInputSceneIndex () const
 
- Protected Member Functions inherited from HdSceneIndexBase
HD_API void _SendPrimsAdded (const HdSceneIndexObserver::AddedPrimEntries &entries)
 
HD_API void _SendPrimsRemoved (const HdSceneIndexObserver::RemovedPrimEntries &entries)
 
HD_API void _SendPrimsDirtied (const HdSceneIndexObserver::DirtiedPrimEntries &entries)
 
HD_API void _SendPrimsRenamed (const HdSceneIndexObserver::RenamedPrimEntries &entries)
 
HD_API bool _IsObserved () const
 
virtual HD_API void _SystemMessage (const TfToken &messageType, const HdDataSourceBaseHandle &args)
 
- Protected Member Functions inherited from TfRefBase
virtual TF_API ~TfRefBase ()
 
- Protected Member Functions inherited from TfWeakBase
 ~TfWeakBase ()
 
TfRefPtr< Tf_Remnant_Register () const
 
template<class T >
TfRefPtr< Tf_Remnant_Register (T *tempRmnt) const
 
bool _HasRemnant () const
 

Detailed Description

Transfers primvars present on the locally bound material. Any matching primvar already present will have a stronger opinion.

As it's expected that primvars inherited by the destination location should have a stronger opinion than those transfered here, inherited primvars must be flattened in advance of this scene index.

This is in support of shading workflows.

This also declares dependencies to ensure invalidation if a HdDependencyForwardingSceneIndex is present downstream. (Because those dependencies are computed on demand, no meaningful additional work is done otherwise.)

Some renderers have special syntax and semantics for how attributes may be combined. To accommmodate this, an optional ComposeFn may be provided to implement this behavior.

Definition at line 36 of file materialPrimvarTransferSceneIndex.h.

Member Typedef Documentation

using HdsiMaterialPrimvarTransferSceneIndex::ComposeFn = std::function< HdDataSourceBaseHandle( HdContainerDataSourceHandle const&, HdContainerDataSourceHandle const&, TfToken const&)>

Definition at line 51 of file materialPrimvarTransferSceneIndex.h.

Member Function Documentation

void HdsiMaterialPrimvarTransferSceneIndex::_PrimsAdded ( const HdSceneIndexBase sender,
const HdSceneIndexObserver::AddedPrimEntries entries 
)
overrideprotectedvirtual
void HdsiMaterialPrimvarTransferSceneIndex::_PrimsDirtied ( const HdSceneIndexBase sender,
const HdSceneIndexObserver::DirtiedPrimEntries entries 
)
overrideprotectedvirtual
void HdsiMaterialPrimvarTransferSceneIndex::_PrimsRemoved ( const HdSceneIndexBase sender,
const HdSceneIndexObserver::RemovedPrimEntries entries 
)
overrideprotectedvirtual
static HDSI_API HdDataSourceBaseHandle HdsiMaterialPrimvarTransferSceneIndex::DefaultComposeFn ( HdContainerDataSourceHandle const &  dsStrong,
HdContainerDataSourceHandle const &  dsWeak,
const TfToken name 
)
static
HDSI_API SdfPathVector HdsiMaterialPrimvarTransferSceneIndex::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. The traveral is expected to give exactly the set of paths where prim exists as defined in GetPrim. The traversal is also 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.

HDSI_API HdSceneIndexPrim HdsiMaterialPrimvarTransferSceneIndex::GetPrim ( const SdfPath primPath) const
overridevirtual

Returns a pair of (prim type, datasource). A prim exists at primPath if and only if datasource is a non-null pointer. In particular, we consider the prim to exist even if the prim type or the container that datasource points to is empty.

Note that we require GetChildPrimPaths to be consistent with this notion of prim existence. That is, unless primPath is the absolute root path, the prim at primPath exists if and only if primPath is contained in GetChildPrimPaths of the parent path.

This function is expected to be threadsafe.

Implements HdSceneIndexBase.

static HDSI_API HdsiMaterialPrimvarTransferSceneIndexRefPtr HdsiMaterialPrimvarTransferSceneIndex::New ( const HdSceneIndexBaseRefPtr &  inputSceneIndex,
const ComposeFn composeFn = ComposeFn() 
)
static

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