Stage operations
Server-side clip, warp, and extract on the OpenUSD session stage. Scenaven’s sidebar is built around that stage: the Scene card lists prims (sources, geometry, materials, derived results). What you select drives Selected prim — the inspector for that prim’s type and role.
Clip, warp, and extract are server-side operations: VTK runs on the session mesh, then new geometry (and related prims) are merged into the same stage. The tree updates — you see Clip, Warp, or Extract rows under Geometry — because the stage is the single source of truth, not a separate “filters list.”
You start them from the Scene card: select a VTK mesh row (UsdGeomMesh), then use the Selected prim header (shortcuts) and the operation panel below. Client-only choices — display style, colormap, opacity — do not re-run VTK; see Scene tree and Viewport controls.
Which operation to use
| You want to… | Choose |
|---|---|
| Show displacement, a mode shape, or an exaggerated deformation | Warp |
| Look inside the model, or cut it on X, Y, or Z | Planar clip |
| Hide the mesh without adding a new result | Eye on a scene-tree row (visibility) |
| Keep only a region you draw on screen | Extract cells or Extract points in Selected prim (VTK mesh row) — draw a region in the view |
Warp
- Select a mesh row (or Geometry) in the Scene card so Selected prim shows UsdGeomMesh.
- Click the Warp icon in the Selected prim header (VTK sessions only).
- Set Warp mode, Warp field, and Warp scale in the panel below Selected prim.
- The server builds the warped surface.
- A Warp row appears in the Scene card under Geometry.
Vector mode uses a vector field. Scalar mode uses a single value per point and needs a scale before the shape reads clearly.
Planar clip
- Select a mesh row so Selected prim shows UsdGeomMesh, then click the Clip icon in the header.
- In the panel below Selected prim:
- Enable planar clip — turn the cut on or off
- Clip axis — X, Y, or Z
- Clip offset — where the plane sits. 0 is the center of the model. Negative and positive move it along the axis
- Show clip plane in viewport — a plane you can drag
- Drag the plane in the view, then release. The server applies the new position.
- A Clip row appears when the surface is ready.
Use the eye icons to compare the full source with the cut.
Editing an operation you already made
Select the Clip or Warp row. The same panel opens below Selected prim, and a change rebuilds that result.
Select a mesh row and use the Clip or Warp shortcut again when you want to adjust from the owning geometry.
While the server works
On a volume, warp and clip are applied on the server:
- You may see *Applying clip filter* or *Applying warp filter*.
- Wait until the scene tree and the view refresh before you change the settings again.
- Move a slider, then pause. The server applies the value where you left it.
Changing color, opacity, or display style does not rebuild the mesh. Those stay in the browser.
Viewport toolbar (camera, display — no server compile)
The top Camera and Display menus change framing and how the surface is drawn; they do not re-run VTK. Extract shortcuts for server-side extract stay in Scene → Selected prim (see Viewport controls).
| Control | What it does |
|---|---|
| Camera / Display (viewport toolbar) | Framing, roll, and representation style |
| Extract cells / Extract points | In Selected prim on a mesh row — draw a region, then the server keeps the cells or points inside it |
| Point probe / Cell probe | With a field active — read a value where you click. The mesh is not rebuilt |
Troubleshooting
| What you see | Likely cause |
|---|---|
| No Clip / Warp icons in Selected prim | Nothing loaded yet, or the row is not a VTK UsdGeomMesh |
| The overlay never finishes | The server is disconnected or busy. Check Infrastructure |
| The view is empty after a clip | The source is hidden, or the plane misses the mesh. Move the offset |
| Warp looks unchanged | The scale is very small, or the field is the wrong one |
Related
- Why OpenUSD? — why the session is a stage
- Time animation — playing through time with clip or warp in the tree
- Scene tree — source, children, and visibility