hierarchy-has-root#
Code |
HI.001 |
---|---|
Validator |
|
Compatibility |
openusd |
Tags |
🔑 |
Summary#
Prim hierarchy must have a single root prim.
Description#
Asset hierarchies must be organized in a way that allows for a single, clear entry point for the entire prim hierarchy.
Why is it required?#
Ensures a single, clear entry point for the entire prim hierarchy
Prevents orphaned prims which will not inherit transformation or visibility from the root prim
Enables traversal and manipulation of the entire prim hierarchy
Examples#
# Invalid: Scattered Xforms without common root
def Xform "Xform1"
{
def Xform "Child1" {}
}
def Xform "Xform2" # Separate root Xform
{
def Xform "Child2" {}
}
# Valid: All Xforms under single root
def Xform "RootXform"
{
def Xform "Xform1"
{
def Xform "Child1" {}
}
def Xform "Xform2"
{
def Xform "Child2" {}
}
}
How to comply#
Ensure all prims in the asset are descendants of a single root prim
Avoid creating separate or disconnected prim hierarchies
Maintain a clear and organized hierarchy structure
Verify that all prims can be reached from the root prim