check_ancestral#
- omni.usd.check_ancestral(prim: Prim) bool#
Check if prim is brought into composition by its ancestor.
A prim is considered ancestral if it only exists because a composition arc (reference, inherit, etc.) on one of its ancestors brought it in. A prim that has a direct ``def`` specifier in the root layer stack is NOT ancestral, even if its parent has composition arcs that propagate ancestral nodes into this prim’s index.
- Parameters:
prim (Usd.Prim) – The prim to check.
- Returns:
True if it’s ancestral prim, or False otherwise.
- Return type:
bool