The grill.views
package provides Qt
widgets to author and inspect USD
scene graphs.
Convenience launchers and menus for USDView, Houdini and Maya are provided (appearing under the 👨🍳 Grill
menu), but any DCC or environment with USD
and PySide2
should be able to use the widgets.
Tabular representation of a USD stage. Ability to quickly inspect and edit prims in bulk is the main motivation for this view to exist. Copy pasting functionality like in other spreadsheet applications should be possible (via csv clipboards).
Uses existing USD Prim utilities to present extended composition arc details than the ones visible by default on USD view.
To visualize the composition graph, the graphviz
library needs to be available on the environment.
The Prim Composition
tree exposes a context menu with a Set as Edit Target
item.
This redirect edits under the selected arc by setting the current stage’s Edit Target.
In the examples below, prims under ChairB_2
and CheerioA_164
have their displayColor, doc
and active
properties modified in USDView
, Houdini
and Maya
respectively, and changes are inspected via the Layer Content Browser
view.
The reference
arc targeting the Chair.geom.usd
layer is set as Edit Target.
When displayColor is modified, the changes are visible on both ChairB_1
and ChairB_2
, since they share the composition arc and the layer being modified.
The root
arc targeting the Kitchen_set.usd
layer is set as Edit Target.
Once the displayColor is modified, the changes are visible on ChairB_2
only, since nothing else shares that arc.
The payload
arc targeting the Cheerio_payload.usd
layer is set as Edit Target.
When doc
of the CheerioA_164
prim is modified, the changes are visible on all CheerioA_*
prims, since they share the composition arc and the layer being modified.
The root
arc targeting the anonymous houdini LOP layer is set as Edit Target.
Once the doc
is modified, the changes are visible on CheerioA_164
only, since nothing else shares that arc.
The payload
arc targeting the Chair_payload.usd
layer is set as Edit Target.
When active
property is modified, the changes are visible on both ChairB_1
and ChairB_2
, since they share the composition arc and the layer being modified.
The root
arc targeting the Kitchen_set.usd
layer is set as Edit Target.
Once the active
property is modified, the changes are visible on ChairB_2
only, since nothing else shares that arc.
Similar to Prim Composition
, but available for the whole stage by
creating a graph of layer stacks. This helps answer questions like:
What prims are being affected by layers X and Y?
In the above example, we’re inspecting Animal Logic’s USD ALab.
On the upper left, all used layers in the current stage are listed.
On the upper right, all prims that are affected by the selected layers are listed.
On the bottom, a composition arcs graph is displayed for the selected layers plus the neighbors (predecessors and successors) for each of them.
Nodes in the network represent layer stacks.
Edges are the composition arcs between them (it follows the same color scheme as the ones provided by Pcp.PrimIndex.DumpToDotGraph).
Options to filter composition arcs are provided on the up left corner of the network view.
The additional option Precise Source Layer
(off by default) exists to draw the edge source from the layer from the stack that introduces it.
This allows to go from this:
To (note the outputs of books_magazines01_surfacing
and books_magazines01_modelling
):
Hint
It is also possible to compute the graph from currently selected prims:
Uses sdffilter to display content from USD layers (regardless of format or if they have been saved on disk).
Array attributes and time samples have their contents reduced to a maximum of 6 entries.
The following example browses the contents of the layers that modify the displayColor
property of the ChairB_2
(as presented on Setting an Edit Target).
The Layer Content Browser
widget can be opened from the USDView Composition
tab (as shown above), as well as from the layer tree of the Layer Stack Composition widget: