NA-MIC Project Weeks

Back to Projects List

Interactive rhombicuboctahedron volume orientation marker

Key Investigators

• Martin Bellehumeur (Radical Imaging, Germany)

Project Description

Make an orientation marker for OHIF whose 26 surfaces (6 faces, 8 corners and 12 edges) can be clicked to reorient the volume in 3D/VRT viewport.

Objective

Enhanced usability of 3D viewport.
Provide volume orientation control when the rotate tool is rotating the clipping planes.

Approach and Plan

Seek advice on implementation.

Progress and Next Steps

Implementing a cornerstone tool named “Orientation controller’ for volume 3D viewports. It uses a VTK.js-based widget architecture.

1. vtkOrientationControllerWidget (packages/tools/src/utilities/vtkjs/OrientationControllerWidget/)
   • Core widget managing VTK actors and interaction
   • Creates and manages vtkActor instances for the polyhedron
   • Handles mouse picking via vtkCellPicker
   • Manages actor lifecycle (add/remove from viewports)
   • Handles positioning and sizing relative to viewport corners
2. AnnotatedRhombicuboctahedronActor (packages/tools/src/utilities/vtkjs/AnnotatedRhombicuboctahedronActor/)
   • Generates the 26-faced polyhedron geometry
   • Creates VTK actors with textured faces and labels
   • Supports main faces (6), edge faces (12), and corner faces (8)
   • Applies anatomical labels (L/R, A/P, S/I) using LPS convention
3. OrientationController Tool (packages/tools/src/tools/OrientationController.ts)
   • Cornerstone3D tool extending BaseTool
   • Wraps the VTK widget for integration
   • Manages tool lifecycle (enable/disable)
   • Handles configuration updates and viewport synchronization

Test in OHIF

Illustrations

No response

Background and References

Acknowledgements

This project is supported by Freie Universität Berlin

No response