Kitware / VolView

Kitware VolView: an all-in-one radiological viewer!
https://volview.kitware.com
Apache License 2.0
186 stars 60 forks source link

Scriptable Annotation Workflows #390

Open PaulHax opened 1 year ago

PaulHax commented 1 year ago

User can press a key, say r and VolView activates the Rectangle tool. Implement for all tools in ToolBar. Keys should be configurable.

Try to follow HistomicsUI.

o, r, i, c, p, l, b: Switch to point, rectangle, ellipse, circle, polygon, line, or brush drawing mode. If already in that mode, turn off drawing mode.

https://github.com/DigitalSlideArchive/HistomicsUI/blob/master/docs/controls.rst

floryst commented 1 year ago

I will also add on keyboard shortcuts for mouse controls (W/L, zoom, pan).

aylward commented 1 year ago

A few considerations...

If we're going to support annotation, we need to think about workflows:

1) Define keystrokes for cycling between mouse modes, rather than a key for each mode. The concern with one key per mode is that we will run out of keys. Or have the annotation modes be capital letters while tweaks to a mode's settings are lower-case letters. Compatibility with HistomicsTK isn't an issue since it is for a very different audience. We should instead focus on radiological standards and workflows.

2) Window and level key controls should have settings that choose if each keystroke makes a large, medium, or small change in the intensity window/level. For example, A large step is 5% of the intensity range, a medium step is 0.1% of intensity range, and a small step is 0.01% of range. A single key cycles between being in small, medium, or large step mode. The current mode is indicated in the corner annotation of each window (perhaps ">>>" to indicate large step mode, ">>" for medium, and ">" for small.

3) We should do this in a way that supports scripting a sequence of modes...e.g., first mode is painting, with a radius of 10mm, using the "tumor" color; second mode is making a ruler measurement called "distance from tumor"; and third mode is painting a 3D needle of diameter 3mm; and the fourth mode is save all annotations to a file.

s

On Wed, Aug 9, 2023 at 4:58 PM Forrest Li @.***> wrote:

I will also add on keyboard shortcuts for mouse controls (W/L, zoom, pan).

— Reply to this email directly, view it on GitHub https://github.com/Kitware/VolView/issues/390#issuecomment-1672139600, or unsubscribe https://github.com/notifications/unsubscribe-auth/AACEJLY4F6767ZSIYMOYFFDXUP2WFANCNFSM6AAAAAA3KMO6AU . You are receiving this because you are subscribed to this thread.Message ID: @.***>

-- Stephen R. Aylward, Ph.D. Chair, MONAI Advisory Board Senior Director, Strategic Initiatives, Kitware