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
UsdPrimCompositionQuery Class Reference

Object for making optionally filtered composition queries about a prim. More...

#include <primCompositionQuery.h>

Classes

struct  Filter
 Aggregate filter for filtering composition arcs by the previously defined criteria. More...
 

Public Types

enum class  ArcTypeFilter {
  All = 0 , Reference , Payload , Inherit ,
  Specialize , Variant , ReferenceOrPayload , InheritOrSpecialize ,
  NotReferenceOrPayload , NotInheritOrSpecialize , NotVariant
}
 Choices for filtering composition arcs based on arc type. More...
 
enum class  DependencyTypeFilter { All = 0 , Direct , Ancestral }
 Choices for filtering composition arcs on dependency type. More...
 
enum class  ArcIntroducedFilter { All = 0 , IntroducedInRootLayerStack , IntroducedInRootLayerPrimSpec }
 Choices for filtering composition arcs based on where the arc is introduced. More...
 
enum class  HasSpecsFilter { All = 0 , HasSpecs , HasNoSpecs }
 Choices for filtering composition arcs on whether the node contributes specs to the prim. More...
 

Public Member Functions

USD_API UsdPrimCompositionQuery (const UsdPrim &prim, const Filter &filter=Filter())
 Create a prim composition query for the with the given option filter.
 
USD_API void SetFilter (const Filter &filter)
 Change the filter for this query.
 
USD_API Filter GetFilter () const
 Return a copy of the current filter parameters.
 
USD_API std::vector< UsdPrimCompositionQueryArcGetCompositionArcs ()
 Return a list of composition arcs for this query's prim using the current query filter.
 

Static Public Member Functions

static USD_API UsdPrimCompositionQuery GetDirectReferences (const UsdPrim &prim)
 Returns a prim composition query for the given prim with a preset filter that only returns reference arcs that are not ancestral.
 
static USD_API UsdPrimCompositionQuery GetDirectInherits (const UsdPrim &prim)
 Returns a prim composition query for the given prim with a preset filter that only returns inherit arcs that are not ancestral.
 
static USD_API UsdPrimCompositionQuery GetDirectRootLayerArcs (const UsdPrim &prim)
 Returns a prim composition query for the given prim with a preset filter that only returns direct arcs that were introduced by opinions defined in a layer in the root layer stack.
 

Detailed Description

Object for making optionally filtered composition queries about a prim.

It creates a list of strength ordering UsdPrimCompositionQueryArc that can be filtered by a combination of criteria and returned.

Invalidation

This object does not listen for change notification. If a consumer is holding on to a UsdPrimCompositionQuery, it is their responsibility to dispose of it in response to a resync change to the associated prim. Failing to do so may result in incorrect values or crashes due to dereferencing invalid objects.

Definition at line 260 of file primCompositionQuery.h.

Member Enumeration Documentation

◆ ArcIntroducedFilter

enum class ArcIntroducedFilter
strong

Choices for filtering composition arcs based on where the arc is introduced.


Definition at line 298 of file primCompositionQuery.h.

◆ ArcTypeFilter

enum class ArcTypeFilter
strong

Choices for filtering composition arcs based on arc type.

Definition at line 264 of file primCompositionQuery.h.

◆ DependencyTypeFilter

enum class DependencyTypeFilter
strong

Choices for filtering composition arcs on dependency type.

This can be direct (arc introduced at the prim's level in namespace) or ancestral (arc introduced by a namespace parent of the prim).

Definition at line 288 of file primCompositionQuery.h.

◆ HasSpecsFilter

enum class HasSpecsFilter
strong

Choices for filtering composition arcs on whether the node contributes specs to the prim.

Definition at line 313 of file primCompositionQuery.h.

Constructor & Destructor Documentation

◆ UsdPrimCompositionQuery()

USD_API UsdPrimCompositionQuery ( const UsdPrim prim,
const Filter filter = Filter() 
)

Create a prim composition query for the with the given option filter.

Member Function Documentation

◆ GetCompositionArcs()

USD_API std::vector< UsdPrimCompositionQueryArc > GetCompositionArcs ( )

Return a list of composition arcs for this query's prim using the current query filter.

The composition arcs are always returned in order from strongest to weakest regardless of the filter.

◆ GetDirectInherits()

static USD_API UsdPrimCompositionQuery GetDirectInherits ( const UsdPrim prim)
static

Returns a prim composition query for the given prim with a preset filter that only returns inherit arcs that are not ancestral.

◆ GetDirectReferences()

static USD_API UsdPrimCompositionQuery GetDirectReferences ( const UsdPrim prim)
static

Returns a prim composition query for the given prim with a preset filter that only returns reference arcs that are not ancestral.

◆ GetDirectRootLayerArcs()

static USD_API UsdPrimCompositionQuery GetDirectRootLayerArcs ( const UsdPrim prim)
static

Returns a prim composition query for the given prim with a preset filter that only returns direct arcs that were introduced by opinions defined in a layer in the root layer stack.

◆ GetFilter()

USD_API Filter GetFilter ( ) const

Return a copy of the current filter parameters.

◆ SetFilter()

USD_API void SetFilter ( const Filter filter)

Change the filter for this query.


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