Views (Inspecting / Authoring)

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.

Spreadsheet Editor

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).

_images/sheet_usdview.gif
https://user-images.githubusercontent.com/8294116/99145748-57e57380-26c5-11eb-847f-ea01f023caf0.gif
https://user-images.githubusercontent.com/8294116/115137690-e0987f00-a06a-11eb-9ba3-1e7df3c0163c.gif

Connections Viewer

From a given prim, recursively traverse its connections through UsdShade.ConnectableAPI. Every node represents a prim, with its name at the top, followed by each of its inputs and outputs. Outputs are marked as red. Inputs are blue (light for non connected inputs, dark for ones with incoming connections).

_images/connections_viewer_usdview.gif
_images/connections_viewer_hou.jpg
_images/connections_viewer_maya.jpg

Prim Composition

Uses existing USD Prim utilities (Usd.PrimCompositionQuery, PrimIndex.DumpToDotGraph, PrimIndex.DumpToString) to help inspect composition arc details beyond what is possible by default in USD view. To visualize the composition graph, the graphviz library needs to be available on the environment.

_images/prim_composition_usdview.gif
https://user-images.githubusercontent.com/8294116/223416152-d7c456d1-6995-48e4-93e0-a89f89200d4e.gif
https://user-images.githubusercontent.com/8294116/115137817-9fed3580-a06b-11eb-81d6-07d7c0fd854d.gif

Setting an Edit Target

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.

  1. 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.

  2. 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.

https://user-images.githubusercontent.com/8294116/156912114-a24b81f4-63b1-4b62-9d84-9e2c07aaef5c.gif
  1. 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.

  2. 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.

https://user-images.githubusercontent.com/8294116/158165374-fe42d80e-8d32-48a4-a628-f6255b5a9e55.gif
  1. 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.

  2. 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.

https://user-images.githubusercontent.com/8294116/158165402-c1dd5119-fe78-4332-8ded-1495703345f9.gif

Layer Stack Composition

Similar to Prim Composition, but available for the whole stage or multiple prims at once. This helps answer questions like:

  • What prims are being affected by layers X and Y?

_images/layerstack_composition_usdview.gif
https://user-images.githubusercontent.com/8294116/131242061-a42c2637-b550-4e1f-89e5-2328f8491333.gif
https://user-images.githubusercontent.com/8294116/131242058-68f20283-0894-463b-9af0-914941356f8c.gif

In the above example, we’re inspecting Animal Logic’s USD ALab.

  1. On the upper left, all used layers in the composition of the inspected stage or prims are listed.

  2. On the upper right, all prims that are affected by the current selected layers are listed.

  3. On the bottom, a composition arcs graph is displayed for the selected layers plus the neighbors (predecessors and successors) for each of their layerStacks.

    • Nodes in the network represent layerStacks.

    • 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 above the network view.

      _images/layerstack_composition_arc_filter_options.jpg
    • 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:

      _images/layerstack_composition_options_default.jpg

      To (note the outputs of books_magazines01_surfacing and books_magazines01_modelling):

      _images/layerstack_composition_options_precise_source_layer.jpg

Warning

Time for computing this graph increases with stage complexity. So for larger stages, it is recommended to start the widget with the prims of interest rather than the complete stage:

https://user-images.githubusercontent.com/8294116/131242428-7b06729d-f96e-4b92-b02f-1608e99859bd.gif

Layer Content Browser

Uses sdffilter and usdtree 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.

https://user-images.githubusercontent.com/8294116/231415967-c960d036-05e6-42d3-905f-d673f8cf2579.gif

The browser can be opened from USDView’s Composition tab (as shown above), as well as from the Layer Stack Composition’s layer tree:

https://user-images.githubusercontent.com/8294116/156912110-a573d9a6-6aed-4b8a-b492-dbaad2613283.gif

Images from formats supported by Qt through QtGui.QImageReader.supportedImageFormats will also be displayed:

_images/layer_content_browser_image_tab_update.gif

Environment Variables

The Grill defaults to an interactive graph explorer for views like the ConnectionViewer, LayerStack Composition and Taxonomy Editor. Previously, these views used to load static SVG images, leveraging QtWebEngine for performance. However, some environments do not bring QtWebEngine with them, and others lead to crashes (see thegrill#36 as an example).

In order to help with these issues and to bring interactivity to graph views, thegrill#35 introduced a custom GraphView inheriting from QGraphicsView.

When needed, the following environment variables will bring the old SVG behavior and prevent QtWebEngine crashes:

GRILL_GRAPH_VIEW_VIA_SVG

Enable this with a boolean value to inspect graphs as SVG images. A value of 0 will restore the default interactive GraphViewer:

_images/connections_viewer_interactive.jpg
_images/layerstack_composition_interactive.jpg
_images/connections_viewer_svg.jpg
_images/layerstack_composition_svg.jpg

If you come across any reason to inspect images as SVG, please reach out on GitHub as this will help assess if this should be removed or better integrated beyond an environment variable.

GRILL_SVG_VIEW_AS_PIXMAP

Enable this with a boolean value to load SVG images as QPixmap (thus avoiding use of QtWebEngine):

_images/prim_composition_svg.jpg
_images/prim_composition_pixmap.jpg