Include dependency graph for primFlags.h:

This graph shows which files directly or indirectly include this file:

Functions
Usd_Term	operator! (Usd_PrimFlags flag)

Usd_PrimFlagsConjunction	operator && (Usd_Term lhs, Usd_Term rhs)

Usd_PrimFlagsConjunction	operator && (const Usd_PrimFlagsConjunction &conjunction, Usd_Term rhs)

Usd_PrimFlagsConjunction	operator && (Usd_Term lhs, const Usd_PrimFlagsConjunction &conjunction)

Usd_PrimFlagsConjunction	operator && (Usd_PrimFlags lhs, Usd_PrimFlags rhs)

Usd_PrimFlagsDisjunction	operator\|\| (Usd_Term lhs, Usd_Term rhs)

Usd_PrimFlagsDisjunction	operator\|\| (const Usd_PrimFlagsDisjunction &disjunction, Usd_Term rhs)

Usd_PrimFlagsDisjunction	operator\|\| (Usd_Term lhs, const Usd_PrimFlagsDisjunction &disjunction)

Usd_PrimFlagsDisjunction	operator\|\| (Usd_PrimFlags lhs, Usd_PrimFlags rhs)

Usd_PrimFlagsPredicate	UsdTraverseInstanceProxies (Usd_PrimFlagsPredicate predicate)
	This function is used to allow the prim traversal functions listed under Prim predicate flags to traverse beneath instance prims and return descendants that pass the specified `predicate` as instance proxy prims. More...

Usd_PrimFlagsPredicate	UsdTraverseInstanceProxies ()
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Convenience method equivalent to calling UsdTraverseInstanceProxies with the UsdPrimDefaultPredicate that is used by default for prim traversals. More...

Variables
unspecified	UsdPrimIsActive
	Tests UsdPrim::IsActive() More...

unspecified	UsdPrimIsLoaded
	Tests UsdPrim::IsLoaded() More...

unspecified	UsdPrimIsModel
	Tests UsdPrim::IsModel() More...

unspecified	UsdPrimIsGroup
	Tests UsdPrim::IsGroup() More...

unspecified	UsdPrimIsAbstract
	Tests UsdPrim::IsAbstract() More...

unspecified	UsdPrimIsDefined
	Tests UsdPrim::IsDefined() More...

unspecified	UsdPrimIsInstance
	Tests UsdPrim::IsInstance() More...

unspecified	UsdPrimHasDefiningSpecifier
	Tests UsdPrim::HasDefiningSpecifier() More...

unspecified	UsdPrimDefaultPredicate
	The default predicate used for prim traversals in methods like UsdPrim::GetChildren, UsdStage::Traverse, and by UsdPrimRange. More...

unspecified	UsdPrimAllPrimsPredicate
	Predicate that includes all prims. More...

Detailed Description

Provides terms for UsdPrim flags that can be combined to form either a conjunction (via &&) or a disjunction (via ||). The result is a predicate functor object that tests those flags on the passed prim. Currently UsdPrim::GetFilteredChildren(), UsdPrim::GetNextFilteredSibling(), UsdPrim::GetFilteredDescendants(), and UsdPrimRange() accept these predicates to filter out unwanted prims.

For example:

// Get only loaded model children.

prim.GetFilteredChildren(UsdPrimIsModel && UsdPrimIsLoaded)

For performance, these predicates are implemented by a bitwise test, so arbitrary boolean expressions cannot be represented. The set of boolean expressions that can be represented are conjunctions with possibly negated terms (or disjunctions, by De Morgan's law). Here are some examples of valid expressions:

// simple conjunction.
(UsdPrimIsLoaded && UsdPrimIsGroup)
// conjunction with negated term.
(UsdPrimIsDefined && !UsdPrimIsAbstract)
// disjunction with negated term.
(!UsdPrimIsDefined || !UsdPrimIsActive)
// negated conjunction gives a disjunction.
!(UsdPrimIsLoaded && UsdPrimIsModel)
// negated conjunction gives a disjunction, which is further extended.
(!(UsdPrimIsLoaded && UsdPrimIsModel) || UsdPrimIsAbstract)
// equivalent to above.
(!UsdPrimIsLoaded || !UsdPrimIsModel || UsdPrimIsAbstract)

Here are some examples of invalid expressions:

// error: cannot || a term with a conjunction.
(UsdPrimIsLoaded && UsdPrimIsModel) || UsdPrimIsAbstract
// error: cannot && disjunctions.
(!UsdPrimIsDefined || UsdPrimIsAbstract) && (UsdPrimIsModel || !UsdPrimIsActive)

The following variables provide the clauses that can be combined and negated to produce predicates:

Definition in file primFlags.h.

Function Documentation

◆ UsdTraverseInstanceProxies() [1/2]

Usd_PrimFlagsPredicate UsdTraverseInstanceProxies ( Usd_PrimFlagsPredicate predicate )

inline

This function is used to allow the prim traversal functions listed under Prim predicate flags to traverse beneath instance prims and return descendants that pass the specified predicate as instance proxy prims.

For example:

// Return all children of the specified prim.  
// If prim is an instance, return all children as instance proxy prims.
prim.GetFilteredChildren(
    UsdTraverseInstanceProxies(UsdPrimAllPrimsPredicate))
// Return children of the specified prim that pass the default predicate.
// If prim is an instance, return the children that pass this predicate
// as instance proxy prims.
prim.GetFilteredChildren(UsdTraverseInstanceProxies());
// Return all model or group children of the specified prim.
// If prim is an instance, return the children that pass this predicate 
// as instance proxy prims.
prim.GetFilteredChildren(UsdTraverseInstanceProxies(UsdPrimIsModel || UsdPrimIsGroup));

Users may also call Usd_PrimFlagsPredicate::TraverseInstanceProxies to enable traversal beneath instance prims. This function is equivalent to:

predicate.TraverseInstanceProxies(true);

However, this function may be more convenient, especially when calling a prim traversal function with a default-constructed tautology predicate.

Definition at line 576 of file primFlags.h.

◆ UsdTraverseInstanceProxies() [2/2]

Usd_PrimFlagsPredicate UsdTraverseInstanceProxies ( )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Convenience method equivalent to calling UsdTraverseInstanceProxies with the UsdPrimDefaultPredicate that is used by default for prim traversals.

Definition at line 586 of file primFlags.h.