Skip to content

ShapeWorks Studio Viewer Controls

At the bottom of the viewers are the controls for the viewers:

ShapeWorks Studio Viewer Controls

Each button has tooltips with descriptions. The controls from left to right are:

  • Autoview / reset view
  • Views dropdown for snapping the camera to an axis-aligned orientation
  • Cutting plane visibility
  • Landmark visibility
  • Glyph visibility with dropdown for glyph size and detail
  • Isosurface visibility with dropdown for surface opacity (of each domain), bounding box, and scale bar
  • View mode (original/groomed/reconstructed)
  • Align (whether to align each object based on the alignment strategy)
  • Compare mode (e.g. compare original vs groomed)
  • Number of views in lightbox (1,2,4,9,16,25,36,49,64)

Axis-aligned views

The Views dropdown next to Reset View snaps the 3D camera to an axis-aligned orientation and fits it to the scene. The change applies to every viewer in the lightbox at once, so a multi-sample view stays consistent.

Item labels follow the orientation-marker preference: when the medical cube marker is shown they are anatomical (Left, Right, Posterior, Anterior, Superior, Inferior); with the triad marker, or with no marker, they are axis labels (X+, X-, Y+, Y-, Z+, Z-).

Views dropdown

The same orientations are on the keyboard while the 3D view has focus — lower-case for the positive direction, shift for the negative:

Key Axis Anatomical
x / Shift+X X+ / X- Left / Right
y / Shift+Y Y+ / Y- Posterior / Anterior
z / Shift+Z Z+ / Z- Superior / Inferior

Bounding box and scale bar

The isosurface visibility dropdown carries two display options for judging the physical size of the data:

  • Show bounding box — draws the bounding box of the displayed shape.
  • Show scale bar — overlays a labeled ruler in world coordinates, with a Scale bar font slider to size the labels.

Bounding box and scale bar

Both are preferences, so they persist across sessions.

Glyph sizing

Glyph size is available from the glyph visibility dropdown, either set manually or left on auto.

Both the slider and the automatic size scale to the largest dimension of the displayed shape rather than to a fixed range of world units. The slider spans 0.1% to 10% of that dimension, so glyphs stay usable on anatomies that are very small or very large. Auto sizing also works before optimization — with only initial landmarks or cutting-plane points placed, glyphs are sized from the shape's bounding box instead of from particles.

Comparing mesh types

The comparison mode toggle also has a dropdown with additional controls:

Comparison Controls

Comparison can be performed either as an overlay (with individual opacity controls):

Overlay Comparison

Or comparison can be performed showing a surface to surface distance:

Surface Comparison

Feature maps and scalars controls

When feature volumes or meshes with scalars are loaded, or other scalar values are present, the extended panel will be displayed:

ShapeWorks Studio Viewer Extended Controls

This adds the feature map / scalar selection and a checkbox to apply a uniform scale to all viewers, vs local scale for each. Additionally, the auto range can be turned off and specified range can be set.

Image volume support

When image volumes are provided, another extended panel will be displayed:

ShapeWorks Studio Viewer Image Controls

  • Image selection
  • Plane direction (X/Y/Z)
  • Enabled 2D/3D viewere mode
  • Shared Brightness/Contrast between viewers
  • Sync slice position between viewers

ShapeWorks Studio Viewer Image Support

Keyboard Shortcuts

The keyboard shortcuts are available from the Help -> Keyboard Shortcuts menu item.

ShapeWorks Studio Keyboard Shortcuts

Point selection

As shown in the keyboard shortcuts panel, you can hover over a particle and press the '1' key. This will select this point on all viewers.

The selected point will become white and all other points will change to a color based on the distance to the chosen point.

ShapeWorks Studio Particle Selection

To turn off this display, press '1' while hovering over something other than a particle.

Additionally, after selecting a point, you may select another point by pressing '2' while hovering. This will set the first point to white, the second point to yellow and the rest to black. This is an easy way to see how particlar particles vary and correspond across shapes.

ShapeWorks Studio Particle Selection2