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

#include <primDefinition.h>

Public Member Functions

 ~UsdPrimDefinition ()=default
 
const TfTokenVectorGetPropertyNames () const
 Return the list of names of builtin properties for this prim definition. More...
 
const TfTokenVectorGetAppliedAPISchemas () const
 
SdfSpecType GetSpecType (const TfToken &propName) const
 
SdfPropertySpecHandle GetSchemaPropertySpec (const TfToken &propName) const
 
SdfAttributeSpecHandle GetSchemaAttributeSpec (const TfToken &attrName) const
 
SdfRelationshipSpecHandle GetSchemaRelationshipSpec (const TfToken &relName) const
 
template<class T >
bool GetAttributeFallbackValue (const TfToken &attrName, T *value) const
 
TfTokenVector ListMetadataFields () const
 
template<class T >
bool GetMetadata (const TfToken &key, T *value) const
 
template<class T >
bool GetMetadataByDictKey (const TfToken &key, const TfToken &keyPath, T *value) const
 
USD_API std::string GetDocumentation () const
 
TfTokenVector ListPropertyMetadataFields (const TfToken &propName) const
 
template<class T >
bool GetPropertyMetadata (const TfToken &propName, const TfToken &key, T *value) const
 
template<class T >
bool GetPropertyMetadataByDictKey (const TfToken &propName, const TfToken &key, const TfToken &keyPath, T *value) const
 
USD_API std::string GetPropertyDocumentation (const TfToken &propName) const
 
USD_API bool FlattenTo (const SdfLayerHandle &layer, const SdfPath &path, SdfSpecifier newSpecSpecifier=SdfSpecifierOver) const
 
USD_API UsdPrim FlattenTo (const UsdPrim &parent, const TfToken &name, SdfSpecifier newSpecSpecifier=SdfSpecifierOver) const
 
USD_API UsdPrim FlattenTo (const UsdPrim &prim, SdfSpecifier newSpecSpecifier=SdfSpecifierOver) const
 

Friends

class UsdSchemaRegistry
 
template<class T >
bool Usd_GetFallbackValue (const UsdPrimDefinition &primDef, const TfToken &propName, const TfToken &fieldName, const TfToken &keyPath, T *value)
 

Detailed Description

Class representing the builtin definition of a prim given the schemas registered in the schema registry. It provides access to the the builtin properties and metadata of a prim whose type is defined by this definition.

Instances of this class can only be created by the UsdSchemaRegistry.

Definition at line 48 of file primDefinition.h.

Constructor & Destructor Documentation

UsdPrimDefinition::~UsdPrimDefinition ( )
default

Member Function Documentation

USD_API bool UsdPrimDefinition::FlattenTo ( const SdfLayerHandle &  layer,
const SdfPath path,
SdfSpecifier  newSpecSpecifier = SdfSpecifierOver 
) const

Copies the contents of this prim definition to a prim spec on the given layer at the given path. This includes the entire property spec for each of this definition's built-in properties as well as all of this definition's prim metadata.

If the prim definition represents a concrete prim type, the type name of the prim spec is set to the the type name of this prim definition. Otherwise the type name is set to empty. The 'apiSchemas' metadata on the prim spec will always be explicitly set to the combined list of all API schemas applied to this prim definition, i.e. the list returned by UsdPrimDefinition::GetAppliedAPISchemas. Note that if this prim definition is an API schema prim definition (see UsdSchemaRegistry::FindAppliedAPIPrimDefinition) then 'apiSchemas' will be empty as this prim definition does not "have" an applied API because instead it "is" an applied API.

If there is no prim spec at the given path, a new prim spec is created at that path with the specifier newSpecSpecifier. Any necessary ancestor specs will be created as well but they will always be created as overs. If a spec does exist at path, then all of its properties and schema allowed metadata are cleared before it is populated from the prim definition.

USD_API UsdPrim UsdPrimDefinition::FlattenTo ( const UsdPrim parent,
const TfToken name,
SdfSpecifier  newSpecSpecifier = SdfSpecifierOver 
) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Copies the contents of this prim definition to a prim spec at the current edit target for a prim with the given name under the prim parent.

USD_API UsdPrim UsdPrimDefinition::FlattenTo ( const UsdPrim prim,
SdfSpecifier  newSpecSpecifier = SdfSpecifierOver 
) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Copies the contents of this prim definition to a prim spec at the current edit target for the given prim.

const TfTokenVector& UsdPrimDefinition::GetAppliedAPISchemas ( ) const
inline

Return the list of names of the API schemas that have been applied to this prim definition in order.

Definition at line 58 of file primDefinition.h.

template<class T >
bool UsdPrimDefinition::GetAttributeFallbackValue ( const TfToken attrName,
T value 
) const
inline

Retrieves the fallback value for the attribute named attrName and stores it in value if possible.

Returns true if the attribute exists in this prim definition and it has a fallback value defined. Returns false otherwise.

Definition at line 112 of file primDefinition.h.

USD_API std::string UsdPrimDefinition::GetDocumentation ( ) const

Returns the documentation metadata defined by the prim definition for the prim itself.

template<class T >
bool UsdPrimDefinition::GetMetadata ( const TfToken key,
T value 
) const
inline

Retrieves the fallback value for the metadata field named key, that is defined by this prim definition for the prim itself and stores it in value if possible.

Returns true if a fallback value is defined for the given metadata key. Returns false otherwise.

Definition at line 131 of file primDefinition.h.

template<class T >
bool UsdPrimDefinition::GetMetadataByDictKey ( const TfToken key,
const TfToken keyPath,
T value 
) const
inline

Retrieves the value at keyPath from the fallback dictionary value for the dictionary metadata field named key, that is defined by this prim definition for the prim itself, and stores it in value if possible.

Returns true if a fallback dictionary value is defined for the given metadata key and it contains a value at keyPath. Returns false otherwise.

Definition at line 148 of file primDefinition.h.

USD_API std::string UsdPrimDefinition::GetPropertyDocumentation ( const TfToken propName) const

Returns the documentation metadata defined by the prim definition for the property named propName if it exists.

template<class T >
bool UsdPrimDefinition::GetPropertyMetadata ( const TfToken propName,
const TfToken key,
T value 
) const
inline

Retrieves the fallback value for the metadata field named key, that is defined by this prim definition for the property named propName, and stores it in value if possible.

Returns true if a fallback value is defined for the given metadata key for the named property. Returns false otherwise.

Definition at line 178 of file primDefinition.h.

template<class T >
bool UsdPrimDefinition::GetPropertyMetadataByDictKey ( const TfToken propName,
const TfToken key,
const TfToken keyPath,
T value 
) const
inline

Retrieves the value at keyPath from the fallback dictionary value for the dictionary metadata field named key, that is defined by this prim definition for the property named propName, and stores it in value if possible.

Returns true if a fallback dictionary value is defined for the given metadata key for the named property and it contains a value at keyPath. Returns false otherwise.

Definition at line 196 of file primDefinition.h.

const TfTokenVector& UsdPrimDefinition::GetPropertyNames ( ) const
inline

Return the list of names of builtin properties for this prim definition.

Definition at line 54 of file primDefinition.h.

SdfAttributeSpecHandle UsdPrimDefinition::GetSchemaAttributeSpec ( const TfToken attrName) const
inline

This is a convenience method. It is shorthand for TfDynamic_cast<SdfAttributeSpecHandle>( GetSchemaPropertySpec(primType, attrName));

Definition at line 87 of file primDefinition.h.

SdfPropertySpecHandle UsdPrimDefinition::GetSchemaPropertySpec ( const TfToken propName) const
inline

Return the property spec that defines the fallback for the property named propName on prims of this prim definition's type. Return null if there is no such property spec.

Definition at line 76 of file primDefinition.h.

SdfRelationshipSpecHandle UsdPrimDefinition::GetSchemaRelationshipSpec ( const TfToken relName) const
inline

This is a convenience method. It is shorthand for TfDynamic_cast<SdfRelationshipSpecHandle>( GetSchemaPropertySpec(primType, relName));

Definition at line 98 of file primDefinition.h.

SdfSpecType UsdPrimDefinition::GetSpecType ( const TfToken propName) const
inline

Return the SdfSpecType for propName if it is a builtin property of the prim type represented by this prim definition. Otherwise return SdfSpecTypeUnknown.

Definition at line 65 of file primDefinition.h.

TfTokenVector UsdPrimDefinition::ListMetadataFields ( ) const
inline

Returns the list of names of metadata fields that are defined by this prim definition for the prim itself.

Definition at line 119 of file primDefinition.h.

TfTokenVector UsdPrimDefinition::ListPropertyMetadataFields ( const TfToken propName) const
inline

Returns the list of names of metadata fields that are defined by this prim definition for property propName if a property named propName exists.

Definition at line 165 of file primDefinition.h.

Friends And Related Function Documentation

template<class T >
bool Usd_GetFallbackValue ( const UsdPrimDefinition primDef,
const TfToken propName,
const TfToken fieldName,
const TfToken keyPath,
T value 
)
friend

Definition at line 266 of file primDefinition.h.

friend class UsdSchemaRegistry
friend

Definition at line 258 of file primDefinition.h.


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