Scene tree

The Scene card is the OpenUSD stage hierarchy for your session: the structure the server wrote after conversion and each compile, shown as a nested list—not a separate list from the 3D view.

You do not upload USD yourself; the server builds the stage from your VTK data. The card reads that layout and keeps selection, visibility, and Selected prim (display and fields on the active row) in sync with what you click in the viewport.

What you see

What appears Meaning
Dataset name (top-level row) A loaded file or example—the source for that asset
Geometry Mesh hierarchy, assembly parts, and filter results for that dataset
Materials UsdShade Material rows (Default, per-part, or filter materials such as ClipMaterial)
Assembly parts Named pieces when the model is split on the server
Clip, Warp, Extract rows Filter and compile results under Geometry

Each dataset expands into Geometry and Materials as siblings—not a single flat list with materials off to the side.

Internal layout rows such as bare Asset_0 xforms are hidden. Labels use your dataset name or prim names, not raw internal asset ids. Rows show a small type chip (Mesh, Material, Xform, …) beside the label.

With more than one file in the scene (Open adds to the scene), each source appears in the same tree. Click any visible mesh in the viewport—the cursor becomes a pointer over selectable geometry—to activate the matching row here.

PreviewSurface shader rows under a material are hidden; select the Material row itself.

What to click

  • Click a geometry row (or a mesh in the view) to make that object active. Selected prim shows display controls (style, edges, points, bounding box) and—for VTK mesh rows—Clip, Warp, Extract shortcuts in the header.
  • Click a Material row to inspect the shader (opacity, diffuse, roughness, metallic, VTK scalars on the bound mesh). The tree highlights the material row while the session still targets the bound mesh for edits.
  • Double-click a source row, or use fit to canvas (camera framing in the viewport), to frame that model in the view.

Dataset and Materials folder rows expand and collapse only—they are not selectable targets.

Select a Clip or Warp row under Geometry to edit that filter’s settings in Selected prim (same panel as the header shortcuts).

Row Extra action (beside Eye when shown) What it does
Geometry, part, or filter mesh Material (sphere icon) Jumps to the bound Material row, opens Materials if needed, and shows the material inspector in Selected prim
Material Geometry (mesh icon) Clears material-only highlight, selects the bound mesh in Geometry, and switches Selected prim to display mode

When you select a mesh (in the tree or viewport), that mesh’s material moves to the top of the Materials list for that dataset; other materials stay below, sorted by name. Clicking a Material row alone does not reorder the list.

A viewport pick that changes the active mesh clears material-only highlight and follows the picked prim (paths like …/Part vs …/Part/Mesh are matched automatically).

Expand and collapse

  • Chevron on a row with children expands or collapses that branch.
  • The expand / collapse control in the Scene card header applies to all dataset branches at once. Hover it for a short hint; one click toggles between fully expanded and fully collapsed.
  • Search (header icon) filters rows by dataset label, prim name, or path.

Toggling visibility on a dataset row hides or shows the whole subtree and collapses that dataset branch (including Geometry and Materials).

When a dataset branch is expanded, selection highlight stays on the active prim row—not on the collapsed dataset row.

Row actions

Control Action
Eye Show or hide that layer in the viewport (geometry and filter rows; not on Material rows)
Material On mesh rows—open the bound material (see table above)
Geometry On Material rows—select the bound mesh in display mode
Trash Remove a source from a multi-asset scene (when shown), or remove a derived filter row

Selected prim (below the tree in the Scene card) shows USD type, stage path, and inspector controls for the highlighted row.

VTK dataset info (ℹ️) in the top viewport toolbar is separate: it summarizes arrays and topology for the selected row when that tool is available.

Some prims are inspect-only (highlight when selected, no Eye)—for example when there is no matching session row for visibility. Use Selected prim to read metadata.

While a Material row is highlighted for inspect, clip/warp/extract settings insets stay hidden; use a Geometry row or the Geometry action to return to mesh editing shortcuts.

Show and hide

  • Hide a source to focus on a clip, warp, or part on its own (the dataset Eye affects the whole subtree).
  • Hide a child row under Geometry to compare it with the full model.
  • Materials do not have visibility toggles—hide the mesh row that uses the material.

How filters show up

When you compile a filter, the server writes the result into the OpenUSD scene. The Scene card updates under Geometry—often as a named row beside the owning source, not nested inside another filter.

  1. Load data → source row, Geometry, and Materials appear
  2. Add a clip → Clip (and related prims, often with a ClipMaterial under Materials) appear
  3. Add a warp → Warp appears as its own result from the same source

A warp is not nested inside a clip; each is its own compile output.

On assembly datasets (multiple parts under one source), each part can have its own Clip row. Clipping the cube does not remove the sphere’s clip—the tree keeps a separate clip under each part you authored.

When the tree looks wrong

What you see What it means
Empty hint only Nothing loaded. Use Open or Examples
Sparse tree, no fields yet Geometry or metadata still arriving. Wait a moment
Filter finished, no new row Server did not apply it. Check the sidebar message and Infrastructure
Material row missing Materials appear after preview bindings are indexed; try selecting the mesh and expanding Materials