All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HdSceneDelegate Class Reference

Adapter class providing data exchange with the client scene graph. More...

+ Inheritance diagram for HdSceneDelegate:

Public Member Functions

HD_API HdSceneDelegate (HdRenderIndex *parentIndex, SdfPath const &delegateID)
 Constructor used for nested delegate objects which share a RenderIndex. More...
 
HdRenderIndexGetRenderIndex ()
 Returns the RenderIndex owned by this delegate. More...
 
SdfPath const & GetDelegateID () const
 Returns the ID of this delegate, which is used as a prefix for all objects it creates in the RenderIndex. More...
 
virtual HD_API void Sync (HdSyncRequestVector *request)
 Synchronizes the delegate state for the given request vector. More...
 
virtual HD_API void PostSyncCleanup ()
 Opportunity for the delegate to clean itself up after performing parrellel work during sync phase. More...
 
Options
virtual HD_API bool IsEnabled (TfToken const &option) const
 Returns true if the named option is enabled by the delegate. More...
 
Rprim Aspects
virtual HD_API HdMeshTopology GetMeshTopology (SdfPath const &id)
 Gets the topological mesh data for a given prim. More...
 
virtual HD_API
HdBasisCurvesTopology 
GetBasisCurvesTopology (SdfPath const &id)
 Gets the topological curve data for a given prim. More...
 
virtual HD_API PxOsdSubdivTags GetSubdivTags (SdfPath const &id)
 Gets the subdivision surface tags (sharpness, holes, etc). More...
 
virtual HD_API GfRange3d GetExtent (SdfPath const &id)
 Gets the axis aligned bounds of a prim. More...
 
virtual HD_API GfMatrix4d GetTransform (SdfPath const &id)
 Returns the object space transform, including all parent transforms. More...
 
virtual HD_API bool GetVisible (SdfPath const &id)
 Returns the authored visible state of the prim. More...
 
virtual HD_API bool GetDoubleSided (SdfPath const &id)
 Returns the doubleSided state for the given prim. More...
 
virtual HD_API HdCullStyle GetCullStyle (SdfPath const &id)
 Returns the cullstyle for the given prim. More...
 
virtual HD_API VtValue GetShadingStyle (SdfPath const &id)
 Returns the shading style for the given prim. More...
 
virtual HD_API HdDisplayStyle GetDisplayStyle (SdfPath const &id)
 Returns the refinement level for the given prim in the range [0,8]. More...
 
virtual HD_API VtValue Get (SdfPath const &id, TfToken const &key)
 Returns a named value. More...
 
virtual HD_API HdReprSelector GetReprSelector (SdfPath const &id)
 Returns the authored repr (if any) for the given prim. More...
 
virtual HD_API TfToken GetRenderTag (SdfPath const &id)
 Returns the render tag that will be used to bucket prims during render pass bucketing. More...
 
virtual HD_API VtArray< TfTokenGetCategories (SdfPath const &id)
 Returns the prim categories. More...
 
virtual HD_API std::vector
< VtArray< TfToken > > 
GetInstanceCategories (SdfPath const &instancerId)
 Returns the categories for all instances in the instancer. More...
 
virtual HD_API HdIdVectorSharedPtr GetCoordSysBindings (SdfPath const &id)
 Returns the coordinate system bindings, or a nullptr if none are bound. More...
 
Motion samples
virtual HD_API size_t SampleTransform (SdfPath const &id, size_t maxSampleCount, float *sampleTimes, GfMatrix4d *sampleValues)
 Store up to maxSampleCount transform samples in *sampleValues. More...
 
template<unsigned int CAPACITY>
void SampleTransform (SdfPath const &id, HdTimeSampleArray< GfMatrix4d, CAPACITY > *sa)
 Convenience form of SampleTransform() that takes an HdTimeSampleArray. More...
 
virtual HD_API size_t SampleInstancerTransform (SdfPath const &instancerId, size_t maxSampleCount, float *sampleTimes, GfMatrix4d *sampleValues)
 Store up to maxSampleCount transform samples in *sampleValues. More...
 
template<unsigned int CAPACITY>
void SampleInstancerTransform (SdfPath const &instancerId, HdTimeSampleArray< GfMatrix4d, CAPACITY > *sa)
 Convenience form of SampleInstancerTransform() that takes an HdTimeSampleArray. More...
 
virtual HD_API size_t SamplePrimvar (SdfPath const &id, TfToken const &key, size_t maxSampleCount, float *sampleTimes, VtValue *sampleValues)
 Store up to maxSampleCount primvar samples in *samplesValues. More...
 
template<unsigned int CAPACITY>
void SamplePrimvar (SdfPath const &id, TfToken const &key, HdTimeSampleArray< VtValue, CAPACITY > *sa)
 Convenience form of SamplePrimvar() that takes an HdTimeSampleArray. More...
 
Instancer prototypes
virtual HD_API VtIntArray GetInstanceIndices (SdfPath const &instancerId, SdfPath const &prototypeId)
 Gets the extracted indices array of the prototype id used in the instancer. More...
 
virtual HD_API GfMatrix4d GetInstancerTransform (SdfPath const &instancerId)
 Returns the instancer transform. More...
 
Path Translation
virtual HD_API SdfPath GetScenePrimPath (SdfPath const &rprimId, int instanceIndex, HdInstancerContext *instancerContext=nullptr)
 Returns the scene address of the prim corresponding to the given rprim/instance index. More...
 
Material Aspects
virtual HD_API SdfPath GetMaterialId (SdfPath const &rprimId)
 Returns the material ID bound to the rprim rprimId. More...
 
virtual HD_API VtValue GetMaterialResource (SdfPath const &materialId)
 
Texture Aspects
virtual HD_API
HdTextureResource::ID 
GetTextureResourceID (SdfPath const &textureId)
 
virtual HD_API
HdTextureResourceSharedPtr 
GetTextureResource (SdfPath const &textureId)
 
Renderbuffer Aspects
virtual HD_API
HdRenderBufferDescriptor 
GetRenderBufferDescriptor (SdfPath const &id)
 Returns the allocation descriptor for a given render buffer prim. More...
 
Light Aspects
virtual HD_API VtValue GetLightParamValue (SdfPath const &id, TfToken const &paramName)
 
Camera Aspects
virtual HD_API VtValue GetCameraParamValue (SdfPath const &cameraId, TfToken const &paramName)
 Returns a single value for a given camera and parameter. More...
 
Volume Aspects
virtual HD_API
HdVolumeFieldDescriptorVector 
GetVolumeFieldDescriptors (SdfPath const &volumeId)
 
ExtComputation Aspects
virtual HD_API TfTokenVector GetExtComputationSceneInputNames (SdfPath const &computationId)
 For the given computation id, returns a list of inputs which will be requested from the scene delegate using the Get() method. More...
 
virtual HD_API
HdExtComputationInputDescriptorVector 
GetExtComputationInputDescriptors (SdfPath const &computationId)
 For the given computation id, returns a list of computation input descriptors. More...
 
virtual HD_API
HdExtComputationOutputDescriptorVector 
GetExtComputationOutputDescriptors (SdfPath const &computationId)
 For the given computation id, returns a list of computation output descriptors. More...
 
virtual HD_API
HdExtComputationPrimvarDescriptorVector 
GetExtComputationPrimvarDescriptors (SdfPath const &id, HdInterpolation interpolationMode)
 Returns a list of primvar names that should be bound to a generated output from an ExtComputation for the given prim id and interpolation mode. More...
 
virtual HD_API VtValue GetExtComputationInput (SdfPath const &computationId, TfToken const &input)
 Returns a single value for a given computation id and input token. More...
 
virtual HD_API std::string GetExtComputationKernel (SdfPath const &computationId)
 Returns the kernel source assigned to the computation at the path id. More...
 
virtual HD_API void InvokeExtComputation (SdfPath const &computationId, HdExtComputationContext *context)
 Requests the scene delegate run the ExtComputation with the given id. More...
 
Primitive Variables
virtual HD_API
HdPrimvarDescriptorVector 
GetPrimvarDescriptors (SdfPath const &id, HdInterpolation interpolation)
 Returns descriptors for all primvars of the given interpolation type. More...
 

Task Aspects

virtual HD_API TfTokenVector GetTaskRenderTags (SdfPath const &taskId)
 

Detailed Description

Adapter class providing data exchange with the client scene graph.

Definition at line 293 of file sceneDelegate.h.

Constructor & Destructor Documentation

HD_API HdSceneDelegate ( HdRenderIndex parentIndex,
SdfPath const &  delegateID 
)

Constructor used for nested delegate objects which share a RenderIndex.

Member Function Documentation

virtual HD_API VtValue Get ( SdfPath const &  id,
TfToken const &  key 
)
virtual

Returns a named value.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API HdBasisCurvesTopology GetBasisCurvesTopology ( SdfPath const &  id)
virtual

Gets the topological curve data for a given prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API VtValue GetCameraParamValue ( SdfPath const &  cameraId,
TfToken const &  paramName 
)
virtual

Returns a single value for a given camera and parameter.

See HdCameraTokens for the list of paramters.

Reimplemented in UsdImagingDelegate, and HdUnitTestDelegate.

virtual HD_API VtArray<TfToken> GetCategories ( SdfPath const &  id)
virtual

Returns the prim categories.

Reimplemented in UsdImagingDelegate.

virtual HD_API HdIdVectorSharedPtr GetCoordSysBindings ( SdfPath const &  id)
virtual

Returns the coordinate system bindings, or a nullptr if none are bound.

Reimplemented in UsdImagingDelegate.

virtual HD_API HdCullStyle GetCullStyle ( SdfPath const &  id)
virtual

Returns the cullstyle for the given prim.

Reimplemented in UsdImagingDelegate.

SdfPath const& GetDelegateID ( ) const
inline

Returns the ID of this delegate, which is used as a prefix for all objects it creates in the RenderIndex.

The default value is SdfPath::AbsoluteRootPath().

Definition at line 310 of file sceneDelegate.h.

virtual HD_API HdDisplayStyle GetDisplayStyle ( SdfPath const &  id)
virtual

Returns the refinement level for the given prim in the range [0,8].

The refinement level indicates how many iterations to apply when subdividing subdivision surfaces or other refinable primitives.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API bool GetDoubleSided ( SdfPath const &  id)
virtual

Returns the doubleSided state for the given prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API VtValue GetExtComputationInput ( SdfPath const &  computationId,
TfToken const &  input 
)
virtual

Returns a single value for a given computation id and input token.

The token may be a computation input or a computation config parameter.

Reimplemented in UsdImagingDelegate.

virtual HD_API HdExtComputationInputDescriptorVector GetExtComputationInputDescriptors ( SdfPath const &  computationId)
virtual

For the given computation id, returns a list of computation input descriptors.

See HdExtComputationInputDecriptor

Reimplemented in UsdImagingDelegate.

virtual HD_API std::string GetExtComputationKernel ( SdfPath const &  computationId)
virtual

Returns the kernel source assigned to the computation at the path id.

If the string is empty the computation has no GPU kernel and the CPU callback should be used.

Reimplemented in UsdImagingDelegate.

virtual HD_API HdExtComputationOutputDescriptorVector GetExtComputationOutputDescriptors ( SdfPath const &  computationId)
virtual

For the given computation id, returns a list of computation output descriptors.

See HdExtComputationOutputDescriptor

Reimplemented in UsdImagingDelegate.

virtual HD_API HdExtComputationPrimvarDescriptorVector GetExtComputationPrimvarDescriptors ( SdfPath const &  id,
HdInterpolation  interpolationMode 
)
virtual

Returns a list of primvar names that should be bound to a generated output from an ExtComputation for the given prim id and interpolation mode.

Binding information is obtained through GetExtComputationPrimvarDesc() Returns a structure describing source information for a primvar that is bound to an ExtComputation. See HdExtComputationPrimvarDesc for the expected information to be returned.

Reimplemented in UsdImagingDelegate.

virtual HD_API TfTokenVector GetExtComputationSceneInputNames ( SdfPath const &  computationId)
virtual

For the given computation id, returns a list of inputs which will be requested from the scene delegate using the Get() method.

See GetExtComputationInputDescriptors and GetExtComputationOutpuDescriptors for descriptions of other computation inputs and outputs.

Reimplemented in UsdImagingDelegate.

virtual HD_API GfRange3d GetExtent ( SdfPath const &  id)
virtual

Gets the axis aligned bounds of a prim.

The returned bounds are in the local space of the prim (transform is yet to be applied) and should contain the bounds of any child prims.

The returned bounds does not include any displacement that might occur as the result of running shaders on the prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API std::vector<VtArray<TfToken> > GetInstanceCategories ( SdfPath const &  instancerId)
virtual

Returns the categories for all instances in the instancer.

Reimplemented in UsdImagingDelegate.

virtual HD_API VtIntArray GetInstanceIndices ( SdfPath const &  instancerId,
SdfPath const &  prototypeId 
)
virtual

Gets the extracted indices array of the prototype id used in the instancer.

example instances: 0, 1, 2, 3, 4, 5 protoypes: A, B, A, A, B, C

GetInstanceIndices(A) : [0, 2, 3] GetInstanceIndices(B) : [1, 4] GetInstanceIndices(C) : [5] GetInstanceIndices(D) : []

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API GfMatrix4d GetInstancerTransform ( SdfPath const &  instancerId)
virtual

Returns the instancer transform.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API SdfPath GetMaterialId ( SdfPath const &  rprimId)
virtual

Returns the material ID bound to the rprim rprimId.

Reimplemented in UsdImagingDelegate, and HdUnitTestDelegate.

virtual HD_API HdMeshTopology GetMeshTopology ( SdfPath const &  id)
virtual

Gets the topological mesh data for a given prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API HdPrimvarDescriptorVector GetPrimvarDescriptors ( SdfPath const &  id,
HdInterpolation  interpolation 
)
virtual

Returns descriptors for all primvars of the given interpolation type.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API HdRenderBufferDescriptor GetRenderBufferDescriptor ( SdfPath const &  id)
virtual

Returns the allocation descriptor for a given render buffer prim.

Reimplemented in HdUnitTestDelegate.

HdRenderIndex& GetRenderIndex ( )
inline

Returns the RenderIndex owned by this delegate.

Definition at line 304 of file sceneDelegate.h.

virtual HD_API TfToken GetRenderTag ( SdfPath const &  id)
virtual

Returns the render tag that will be used to bucket prims during render pass bucketing.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API HdReprSelector GetReprSelector ( SdfPath const &  id)
virtual

Returns the authored repr (if any) for the given prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API SdfPath GetScenePrimPath ( SdfPath const &  rprimId,
int  instanceIndex,
HdInstancerContext *  instancerContext = nullptr 
)
virtual

Returns the scene address of the prim corresponding to the given rprim/instance index.

This is designed to give paths in scene namespace, rather than hydra namespace, so it always strips the delegate ID.

Reimplemented in UsdImagingDelegate.

virtual HD_API VtValue GetShadingStyle ( SdfPath const &  id)
virtual

Returns the shading style for the given prim.

virtual HD_API PxOsdSubdivTags GetSubdivTags ( SdfPath const &  id)
virtual

Gets the subdivision surface tags (sharpness, holes, etc).

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API HdTextureResourceSharedPtr GetTextureResource ( SdfPath const &  textureId)
virtual
Deprecated:
It is now the responsibility of the render delegate to load the texture (using the file path authored on the texture node in a material network).

Returns the texture resource for a given texture ID.

Reimplemented in HdUnitTestDelegate.

virtual HD_API HdTextureResource::ID GetTextureResourceID ( SdfPath const &  textureId)
virtual
Deprecated:
It is now the responsibility of the render delegate to load the texture (using the file path authored on the texture node in a material network).

Returns the texture resource ID for a given texture ID.

Reimplemented in HdUnitTestDelegate.

virtual HD_API GfMatrix4d GetTransform ( SdfPath const &  id)
virtual

Returns the object space transform, including all parent transforms.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API bool GetVisible ( SdfPath const &  id)
virtual

Returns the authored visible state of the prim.

Reimplemented in HdUnitTestDelegate, and UsdImagingDelegate.

virtual HD_API void InvokeExtComputation ( SdfPath const &  computationId,
HdExtComputationContext context 
)
virtual

Requests the scene delegate run the ExtComputation with the given id.

The context contains the input values that delegate requested through GetExtComputationInputNames().

The scene delegate is expected to set each output identified by GetExtComputationOutputNames() on the context.

Hydra may invoke the computation on a different thread from what HdEngine::Execute() was called on. It may also invoke many computations in parallel.

Reimplemented in UsdImagingDelegate.

virtual HD_API bool IsEnabled ( TfToken const &  option) const
virtual

Returns true if the named option is enabled by the delegate.

virtual HD_API void PostSyncCleanup ( )
virtual

Opportunity for the delegate to clean itself up after performing parrellel work during sync phase.

Reimplemented in UsdImagingDelegate.

virtual HD_API size_t SampleInstancerTransform ( SdfPath const &  instancerId,
size_t  maxSampleCount,
float *  sampleTimes,
GfMatrix4d sampleValues 
)
virtual

Store up to maxSampleCount transform samples in *sampleValues.

Returns the union of the authored samples and the boundaries of the current camera shutter interval. If this number is greater than maxSampleCount, you might want to call this function again to get all the authored data. Sample times are relative to the scene delegate's current time.

See Also
GetInstancerTransform()

Reimplemented in UsdImagingDelegate.

void SampleInstancerTransform ( SdfPath const &  instancerId,
HdTimeSampleArray< GfMatrix4d, CAPACITY > *  sa 
)
inline

Convenience form of SampleInstancerTransform() that takes an HdTimeSampleArray.

This function returns the union of the authored samples and the boundaries of the current camera shutter interval.

Definition at line 472 of file sceneDelegate.h.

virtual HD_API size_t SamplePrimvar ( SdfPath const &  id,
TfToken const &  key,
size_t  maxSampleCount,
float *  sampleTimes,
VtValue sampleValues 
)
virtual

Store up to maxSampleCount primvar samples in *samplesValues.

Returns the union of the authored samples and the boundaries of the current camera shutter interval. If this number is greater than maxSampleCount, you might want to call this function again to get all the authored data.

Sample values that are array-valued will have a size described by the HdPrimvarDescriptor as applied to the toplogy.

For example, this means that a mesh that is fracturing over time will return samples with the same number of points; the number of points will change as the scene delegate is resynchronzied to represent the scene at a time with different topology.

Sample times are relative to the scene delegate's current time.

See Also
Get()

Reimplemented in UsdImagingDelegate.

void SamplePrimvar ( SdfPath const &  id,
TfToken const &  key,
HdTimeSampleArray< VtValue, CAPACITY > *  sa 
)
inline

Convenience form of SamplePrimvar() that takes an HdTimeSampleArray.

This function returns the union of the authored samples and the boundaries of the current camera shutter interval.

Definition at line 525 of file sceneDelegate.h.

virtual HD_API size_t SampleTransform ( SdfPath const &  id,
size_t  maxSampleCount,
float *  sampleTimes,
GfMatrix4d sampleValues 
)
virtual

Store up to maxSampleCount transform samples in *sampleValues.

Returns the union of the authored samples and the boundaries of the current camera shutter interval. If this number is greater than maxSampleCount, you might want to call this function again to get all the authored data. Sample times are relative to the scene delegate's current time.

See Also
GetTransform()

Reimplemented in UsdImagingDelegate.

void SampleTransform ( SdfPath const &  id,
HdTimeSampleArray< GfMatrix4d, CAPACITY > *  sa 
)
inline

Convenience form of SampleTransform() that takes an HdTimeSampleArray.

This function returns the union of the authored transform samples and the boundaries of the current camera shutter interval.

Definition at line 433 of file sceneDelegate.h.

virtual HD_API void Sync ( HdSyncRequestVector request)
virtual

Synchronizes the delegate state for the given request vector.

Reimplemented in UsdImagingDelegate.


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