This document is for a version of USD that is under development. See this page for the current release.
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
UsdSpecializes Class Reference

A proxy class for applying listOp edits to the specializes list for a prim. More...

#include <specializes.h>

Public Member Functions

USD_API bool AddSpecialize (const SdfPath &primPath, UsdListPosition position=UsdListPositionBackOfPrependList)
 Adds a path to the specializes listOp at the current EditTarget, in the position specified by position.
 
USD_API bool RemoveSpecialize (const SdfPath &primPath)
 Removes the specified path from the specializes listOp at the current EditTarget.
 
USD_API bool ClearSpecializes ()
 Removes the authored specializes listOp edits at the current edit target.
 
USD_API bool SetSpecializes (const SdfPathVector &items)
 Explicitly set specializes paths, potentially blocking weaker opinions that add or remove items, returning true on success, false if the edit could not be performed.
 
const UsdPrimGetPrim () const
 Return the prim this object is bound to.
 
UsdPrim GetPrim ()
 
 operator bool ()
 

Friends

class UsdPrim
 

Detailed Description

A proxy class for applying listOp edits to the specializes list for a prim.

All paths passed to the UsdSpecializes API are expected to be in the namespace of the owning prim's stage. Subroot prim specializes paths
will be translated from this namespace to the namespace of the current edit target, if necessary. If a path cannot be translated, a coding error will be issued and no changes will be made. Root prim specializes paths will not be translated.

Definition at line 34 of file specializes.h.

Member Function Documentation

◆ AddSpecialize()

USD_API bool AddSpecialize ( const SdfPath primPath,
UsdListPosition  position = UsdListPositionBackOfPrependList 
)

Adds a path to the specializes listOp at the current EditTarget, in the position specified by position.

◆ ClearSpecializes()

USD_API bool ClearSpecializes ( )

Removes the authored specializes listOp edits at the current edit target.

◆ GetPrim() [1/2]

UsdPrim GetPrim ( )
inline

Definition at line 65 of file specializes.h.

◆ GetPrim() [2/2]

const UsdPrim & GetPrim ( ) const
inline

Return the prim this object is bound to.

Definition at line 64 of file specializes.h.

◆ operator bool()

operator bool ( )
inlineexplicit

Definition at line 67 of file specializes.h.

◆ RemoveSpecialize()

USD_API bool RemoveSpecialize ( const SdfPath primPath)

Removes the specified path from the specializes listOp at the current EditTarget.

◆ SetSpecializes()

USD_API bool SetSpecializes ( const SdfPathVector &  items)

Explicitly set specializes paths, potentially blocking weaker opinions that add or remove items, returning true on success, false if the edit could not be performed.

Friends And Related Function Documentation

◆ UsdPrim

friend class UsdPrim
friend

Definition at line 35 of file specializes.h.


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