UsdImagingMaterialBindingSchema Class Reference

The UsdImagingMaterialBindingSchema specifies a container for a prim's material bindings for a particular purpose. More...

#include <materialBindingSchema.h>

Inheritance diagram for UsdImagingMaterialBindingSchema:

Classes
class	Builder
	Utility class for setting sparse sets of child data source fields to be filled as arguments into BuildRetained. More...

Public Member Functions
Member accessor
USDIMAGING_API UsdImagingDirectMaterialBindingSchema	GetDirectMaterialBinding () const
USDIMAGING_API UsdImagingCollectionMaterialBindingVectorSchema	GetCollectionMaterialBindings () const
Public Member Functions inherited from HdSchema
	HdSchema (HdContainerDataSourceHandle container)
HD_API HdContainerDataSourceHandle	GetContainer () const
	Returns the container data source that this schema is interpreting.
HD_API bool	IsDefined () const
	operator bool () const
	Returns true if this schema is applied on top of a non-null container.

Static Public Member Functions
Schema location
static USDIMAGING_API const TfToken &	GetSchemaToken ()
	Returns a token where the container representing this schema is found in a container by default.
static USDIMAGING_API const HdDataSourceLocator &	GetDefaultLocator ()
	Returns an HdDataSourceLocator (relative to the prim-level data source) where the container representing this schema is found by default.
Schema construction
static USDIMAGING_API HdContainerDataSourceHandle	BuildRetained (const HdContainerDataSourceHandle &directMaterialBinding, const HdVectorDataSourceHandle &collectionMaterialBindings)

Schema retrieval
	UsdImagingMaterialBindingSchema (HdContainerDataSourceHandle container)
static USDIMAGING_API UsdImagingMaterialBindingSchema	GetFromParent (const HdContainerDataSourceHandle &fromParentContainer)
	Retrieves a container data source with the schema's default name token "usdMaterialBinding" from the parent container and constructs a UsdImagingMaterialBindingSchema instance.

Additional Inherited Members
Public Types inherited from HdSchema
using	UnderlyingDataSource = HdContainerDataSource
Protected Member Functions inherited from HdSchema
template<typename T >
T::Handle	_GetTypedDataSource (TfToken name) const
	Returns a datasource of the requested type for the given name: schema implementations can use this to ask for child containers, sampled values, vectors, etc.
Protected Attributes inherited from HdSchema
HdContainerDataSourceHandle	_container

Detailed Description

The UsdImagingMaterialBindingSchema specifies a container for a prim's material bindings for a particular purpose.

Note that only one direct binding but any number of collection-based bindings may be declared for a given purpose. See UsdImagingMaterialBindingsSchema which specifies the purposes and their associated bindings.

Definition at line 56 of file materialBindingSchema.h.

Constructor & Destructor Documentation

UsdImagingMaterialBindingSchema()

UsdImagingMaterialBindingSchema ( HdContainerDataSourceHandle  container )

inline

Definition at line 62 of file materialBindingSchema.h.

Member Function Documentation

BuildRetained()

static USDIMAGING_API HdContainerDataSourceHandle BuildRetained ( const HdContainerDataSourceHandle &  directMaterialBinding, const HdVectorDataSourceHandle &  collectionMaterialBindings  )

static

Deprecated:

Use Builder instead.

Builds a container data source which includes the provided child data sources. Parameters with nullptr values are excluded. This is a low-level interface. For cases in which it's desired to define the container with a sparse set of child fields, the Builder class is often more convenient and readable.

GetDefaultLocator()

static USDIMAGING_API const HdDataSourceLocator & GetDefaultLocator ( )

static

Returns an HdDataSourceLocator (relative to the prim-level data source) where the container representing this schema is found by default.

GetFromParent()

static USDIMAGING_API UsdImagingMaterialBindingSchema GetFromParent ( const HdContainerDataSourceHandle &  fromParentContainer )

static

Retrieves a container data source with the schema's default name token "usdMaterialBinding" from the parent container and constructs a UsdImagingMaterialBindingSchema instance.

Because the requested container data source may not exist, the result should be checked with IsDefined() or a bool comparison before use.

GetSchemaToken()

static USDIMAGING_API const TfToken & GetSchemaToken ( )

static

Returns a token where the container representing this schema is found in a container by default.

---

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

• pxr/usdImaging/usdImaging/materialBindingSchema.h