Scene Views Modernization

Support
,
1

image
image1920×1032 368 KB

What are Scene Views?

Scene Views store snapshots of visualization settings of the scene content. By default, the scene view stores the current view layout, camera viewpoint in 3D views, slice position in 2D views, and display settings of all nodes (visibility, color, transparency, etc.), along with a short description. They serve as visual bookmarks, which can be used to quickly review and share interesting details of the scene.

What’s New?

In the latest stable and nightly releases, scene views have been reworked to internally use hidden “sequence” nodes (managed by Sequences module). This allows much faster and more robust storage compared to previous generations of this feature.

When the scene is saved, scene view data is automatically saved into a Private subfolder adjacent to the .mrml scene file, containing sequences for all the scene views. When loading an existing scene, scene views are automatically converted into the new format.

For Users

Scene views can be created by enabling the “Capture/Restore” toolbar and selecting the middle “Capture and name a scene view” option.

image

image
image646×618 43.7 KB

Scene views can be restored, deleted or edited within the scene views module.

image
image657×162 19.7 KB

For Developers

Scene views are controlled by one or more hidden sequence browser node, controlling sequences for each display node in the scene.

By default, only display/view/etc. nodes are stored in scene views, however it is possible to add any node type to a scene view. (See vtkSlicerSceneViewsModuleLogic::CreateSceneView()).

Simplified Python API

# Create a scene view with optional screenshot
slicer.modules.sceneviews.logic().CreateSceneView(
    name="My Snapshot",
    description="Before surgery planning",
    screenshotType=0,
    screenshot=None)
# Restore by index or name
slicer.modules.sceneviews.logic().RestoreSceneView(0)
slicer.modules.sceneviews.logic().RestoreSceneView("My Snapshot")

Acknowledgements

Development was funded in part by a Children’s Hospital of Philadelphia (CHOP) Cardiac Center Innovation Grant, a CHOP Cardiac Center Research Grant, a CHOP Frontier Grant, NIH R01 HL153166 and T32GM008562.

2 Likes