Skip to content

Latest commit

 

History

History
116 lines (62 loc) · 6.01 KB

README.md

File metadata and controls

116 lines (62 loc) · 6.01 KB
Raw

Back to Projects List

Interactive Slice Intersections

Key Investigators

  • David García-Mato (Ebatinca S.L., Las Palmas de Gran Canaria, Spain)
  • Kyle Sunderland (PerkLab, Queen's University, Kingston, ON, Canada)
  • Csaba Pinter (Ebatinca S.L., Las Palmas de Gran Canaria, Spain)
  • Andras Lasso (PerkLab, Queen's University, Kingston, ON, Canada)

Project Description

Current slice navigation is based on hotkeys like Shift+drag for moving the 3D cursor, or Ctrl+Alt+drag&drop for rotation of the slice planes when slice intersections are shown. It would be great to have these features available more explicitly that could be used directly with the mouse, avoiding the use of keyboard.

In this project, we want to develop an interactive slice intersections mode to enable users to navigate slices using interaction handles (similar to markups translation/rotation).

Details:

  • Unlike the intersection lines, the interactive slice representation lines will be drawn from one window border to the opposite, with dash line for the part that does not correspond to the intersection of the planes.
  • When the mouse is over the line, a widget appears with translation arrows under the mouse and rotation arrows close to it, with the tip of the arrows oriented towards the center of intersection
  • If we click on the translation arrows and move the mouse, the line is translated (these are under the mouse so that this basic feature can be done basically by quick drag&drop)
  • If we click on the rotation arrows and move the mouse, the 2 lines are rotated to keep the current angle (the user would need to move the mouse to get to these arrows providing the more advanced feature)
  • There is no distinction for the direction of the movement, both sides of the arrows allow to move in both directions
  • When the mouse goes close to the intersection center, the widget representation is different (circle at the center, 4 arrows ?) and we can translate both lines (like pressing Shift key)
  • When the mouse is over a handle it is highlighted
  • When we click on the widget and start moving the mouse, the widget representation is hidden or made mostly transparent (not the lines) to see the underlying image
  • We would like to have access to some interaction events, like StartInteractionEvent, ModifiedEvent, EndInteractionEvent at least.

A sketch is shown on the "Illustrations" section below.

More information in this GitHub issue: here

Objective

  1. Create base classes to control interaction handles.

  2. Develop the interactive slice intersections mode.

  3. Customize slice interaction handles.

  4. Test it on sample images.

Approach and Plan

  1. Explore the rendering pipeline for current Markups interaction handles (i.e., MarkupsInteractionPipeline class in vtkSlicerMarkupsWidgetRepresentation). ✔️

  2. Move base class and display options to a lower level. ✔️

  3. Create new classes vtkMRMLSliceIntersectionInteractionWidget and vtkMRMLSliceIntersectionInteractionRepresentation in DisplayableManager. ✔️

  4. Customize handles to control slice intersection in an intuitive manner. ✔️

  5. Create new vtkMRMLSliceDisplayNode ✔️

  6. Create property in vtkMRMLSliceDisplayNode to control handles visibility mode ✔️

Progress and Next Steps

  1. Migrate pipelines for generic widget interaction handles from Markups module to new base classes in DisplayableManager (vtkMRMLInteractionWidget and vtkMRMLInteractionWidgetRepresentation). ✔️

  2. Improve base interaction classes to allow easy implementation of custom interaction handles. ✔️

  3. Implement interaction handles test case for manipulating transform nodes. ✔️

    BEFORE

    BEFORE

    AFTER

    AFTER

  4. Create new classes to render interaction handles for interactive slice intersection: vtkMRMLSliceIntersectionInteractionWidget and vtkMRMLSliceIntersectionInteractionRepresentation. ✔️

  5. Add new option in ViewersToolbar to select interactive slice intersection mode. This option is only enabled and visible when slice intersection mode is active. ✔️

    drawing

  6. Render interaction handles in slice views and enable interactions.

    HANDLES

  7. Modify interactions to update slice intersections. Currently, sliceToRAS transform of the slice node is being updated. ✔️

  8. Customize handles for interactive slice intersection. ✔️

  9. Test new mode in sample images ✔️

  10. Integrate in Slicer. Pull request: Slicer/Slicer#6008

Illustrations

Final video:

2022-01-20.14-02-16.mp4

Background and References

  • GitHub issue: here

  • Slicer branch for interactive slice intersection: here

  • Current branch for migration of interaction handles: here