A usdview plugin for inspecting UsdShade networks.

Copy the lib and plugin directories into your USD installation directory.

For Advanced Instructions see below.

usdshadeview visualizes UsdShade NodeGraphs and Materials (which are specialized node graphs) in an interactive Qt dialog:

The dialog can be shown by right clicking a prim of one of both types, which brings up a new option in the context menu:

The network shown in the dialog has a layout depending on network topology, and node colors are based on the classification (USDA, MaterialX, MDL, OSL, node graph, unknown). Child node graphs can be entered using the "E" button.

It is also possible to right click value widgets, which exposes following actions:

In the main graph dialog, the menu bar offers following features:

• View → Filter Output: filter nodes and connections to a single output
• Tools → Bake to Texture: (only for MaterialX materials) invoke UsdBakeMtlx
• Tools → Export as Image: save the scene with a transparent background

Note: To display thumbnails for EXRs, the OpenImageIO python package has to be additionally installed.

Clicking the "?" button of a node widget opens up the node definition dialog which lists all inputs and outputs with their respective documentation.

The information is only available for nodes registered in the Sdr registry.

A list of all nodes in the Sdr registry can be accessed from the usdview menu bar Window → Sdr Nodes submenu.

Clicking on an entry brings up its node definition dialog.

I have tested this plugin on Windows and macOS with PySide2 and PySide6, and Python 3.7, 3.9 and 3.11.

It has been verified to be compatible with OpenUSD versions down to v22.11.

The plugin can be used outside of the build tree by setting following environment variables:

• PYTHONPATH to include <REPO_ROOT>/lib/python
• PXR_PLUGINPATH_NAME to include <REPO_ROOT>/plugin/usd/usdshadeview/resources

Apache 2.0