EsfUsdStageData Class Reference

#include <stageData.h>

Classes
class	ListenerBase

Public Types
using	ChangedPathSet = tbb::concurrent_unordered_set< SdfPath, TfHash >

Public Member Functions
ESFUSD_API	~EsfUsdStageData ()
ESFUSD_API void	Unregister (const ListenerBase *listener)

Static Public Member Functions
static ESFUSD_API std::shared_ptr < EsfUsdStageData >	RegisterStage (const UsdStageConstPtr &stage, const ListenerBase *listener)
static ESFUSD_API EsfUsdStageData &	GetStageData (const UsdStageConstPtr &stage)
static ESFUSD_API const SdfPathVector &	GetOutgoingConnections (const UsdStageConstPtr &stage, const SdfPath &attrPath)
static ESFUSD_API SdfPathVector	GetIncomingConnections (const UsdStageConstPtr &stage, const SdfPath &targetPath)

Detailed Description

Class that holds data that is cached per-stage.

Note

It's unfortunate that clients that access outgoing and incoming connections using this class have to provide a stage pointer, making the implementation of this class less performant and more complicated. Ideally, EsfUsd objects would have a way to get directly to the stage data for their stage, but given the fact that those objects are all short-lived, it's not clear how to do that, at least without growing the sizes of all Esf objects.

Definition at line 54 of file stageData.h.

Member Typedef Documentation

using EsfUsdStageData::ChangedPathSet = tbb::concurrent_unordered_set<SdfPath, TfHash>

A concurrent set of paths, used to indicate the set of targets for which incoming connections have changed.

Definition at line 63 of file stageData.h.

Constructor & Destructor Documentation

ESFUSD_API EsfUsdStageData::~EsfUsdStageData

(

)

Member Function Documentation

static ESFUSD_API SdfPathVector EsfUsdStageData::GetIncomingConnections ( const UsdStageConstPtr &  stage, const SdfPath &  targetPath  )

static

Returns the paths of all attributes that own connections that target the object at targetPath.

static ESFUSD_API const SdfPathVector& EsfUsdStageData::GetOutgoingConnections ( const UsdStageConstPtr &  stage, const SdfPath &  attrPath  )

static

Returns the paths of all objects that are targets of connections owned by the attribute at attrPath.

static ESFUSD_API EsfUsdStageData& EsfUsdStageData::GetStageData ( const UsdStageConstPtr &  stage )

static

Get the cached stage data for stage.

Note

The client calling this method must first have registered stage by calling RegisterStage and must still be holding the strong reference to the stage data while calling this method and using the returned reference.

static ESFUSD_API std::shared_ptr<EsfUsdStageData> EsfUsdStageData::RegisterStage ( const UsdStageConstPtr &  stage, const ListenerBase *  listener  )

static

Registers stage as a stage for which cached data should be held, returning a strong reference the client must hold until the cached data is no longer needed.

listener will be notified of scene changes.

ESFUSD_API void EsfUsdStageData::Unregister

(

const ListenerBase *

listener

)

Notifies that listener no longer needs to be informed of changes.

---

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

• pxr/exec/esfUsd/stageData.h