Revise image viewer documentation for clarity and updates

kwolbachia · web-flow · commit 262e51271060 · 2025-11-10T14:29:39.000+01:00
Updated image viewer documentation with new features and usage instructions.
diff --git a/_pages/plugins/image-viewer.md b/_pages/plugins/image-viewer.md
@@ -4,6 +4,7 @@ description: utility plugins and macros to control images contast and LUTs
 categories: [Annotation, Interactive, Macro, Microscopy, Montage, Utilities, Visualization]
 ---
 This Update Site provides utility plugins and macros to help with handling and visualization of microscopy images
+If you have a question, feedback or a bug to report, you can post it on the [Image.sc](https://forum.image.sc/t/looking-for-testers-channels-contrast-and-luts-manager-plugins/) Forum
 
 Features include:
 - Two plugins to control image contrast and LUTs (Look Up Tables)
@@ -22,8 +23,7 @@ In your imageJ app folder : place the **Image Viewer** folder on the ``plugins``
 
 All commands and plugins are located in the ``Plugins > Image Viewer`` menu       
 But the easiest way is to install the toolbar menu from Image_Viewer_Toolset under the red `>>` menu in the ImageJ window            
-![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Toolset.png?raw=true)     
-If you have a question, feedback or a bug to report, you can post it on the [Image.sc](https://forum.image.sc/t/looking-for-testers-channels-contrast-and-luts-manager-plugins/) Forum
+![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Toolset.png?raw=true){:width="300px"}              
 
 ___
 
@@ -39,7 +39,7 @@ You can:
   - **Min/Max:** Sets display range to the channel stack's min/max values
 - Interface with the **LUTs Manager** to apply LUT palettes or individual favorite LUTs
 You can change order of LUTs in a palette directly with the mouse from the palette menu     
-![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-palettes.png?raw=true)     
+![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-palettes.png?raw=true){:width="300px"}     
 - Access more options and built-in utilities for multi-channel images via the "More" button     
 ![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-More.png?raw=true)     
 
@@ -50,7 +50,7 @@ You can change order of LUTs in a palette directly with the mouse from the palet
 - Change LUT order with the mouse
 - Right-click on palette to move or remove LUTs
 - Empty palette channels default to "Grays"     
-![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-LUTs-Manager.png?raw=true){:width="400px"}         
+![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-LUTs-Manager.png?raw=true){:width="600px"}         
 #### LUTs Finder
 The plugin scans all LUTs in your ImageJ `luts` folder
 You can use the search bar and color buttons to filter the list
@@ -71,32 +71,84 @@ Each LUT comes with an **estimated** description of its properties:
 ### Multi Tool
 This Tool is a neutral tool 
 but it can perform many actions based on the mouse button, modifier keys (shift, ctrl, alt) and context:
-- **Without modifier keys:** Left-click moves image window; Or move / resize any ROI     
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Default-Main-Tool.mp4" %}  
-- **Middle mouse:** Switch multichannel display (composite/color)
-- **Ctrl:** Mimic rectangle tool     
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Ctrl-Rectangle.mp4" %}       
-- **Shift + Alt:** Local auto-contrast via box ROI around click     
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Local-Auto-Contrast.mp4" %}       
-- **Alt:** Navigate Z (slice/frame) anywhere in image     
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Alt-Slice.mp4" %}       
-- **Shift:** Adjust active channel contrast     
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Shift-Contrast.mp4" %}      
+##### **Windows**     
+     
+- **Move Window:**       
+  Left Click and Drag (outside ROI):       
+  Moves the image window position interactively.     
+     
+- **Reversible Full Screen:**       
+  Double Left Click:       
+  Maximizes/minimizes the image window, reversible to original size.     
+     
+##### **Composite Display Switch**     
+- **Switch Composite Display:**       
+  Middle Click on composite image:       
+  Toggle display mode between Composite and Color.     
+     
+##### **ROI**     
+- **Create Rectangular ROI:**       
+  Ctrl + Left Mouse Drag:       
+  Drag to create a rectangular selection.     
+     
+- **Handle Polygon/Point ROI:**       
+  Drag ROI handles using Left Mouse and modify selected selection / points.     
+     
+- **Remove ROI:**       
+  Ctrl + Click outside the ROI removes the current ROI.     
+     
+##### **Contrast**     
+- **Local Box Auto-Contrast:**       
+  Shift + Alt + Left Click (on non-RGB images):       
+  Creates a fixed-size box ROI and auto-adjusts contrast in its area.     
+     
+- **Live Contrast Adjustment:**       
+  Shift + Left Mouse Drag (non-RGB images):       
+  Drag pointer in the image to interactively adjust contrast.     
+     
+##### **Stack Browsing**     
+- **Live Scroll through Slices/Frames:**       
+  Alt + Left Mouse Drag (on stack/multi-frame images):       
+  Drag horizontally to scroll through slices or frames.     
+     
+##### **Preview Opener (Montage Browser)**      
+- **Open Image from Preview Opener:**      
+  Mouse Over thumbnails:       
+  Updates slice label showing the path/name of the selected thumbnail.      
+  Middle Click on a thumbnail in ‘Preview Opener’ window:       
+  Opens the corresponding file.       
+  Caps Lock ON: Opens image as ‘virtual stack’.       
+  Supports standard formats or uses Bio-Formats Importer if needed.     
+     
+##### Multi Tool Shortcuts Summary
+
+| Mouse & Keys       | Action                                          |
+|--------------------|------------------------------------------------|
+| Left Drag (no ROI) | Move image window                              |
+| Double Left Click  | Maximize/minimize image window                 |
+| Middle Click       | Composite display toggle / Preview opener open  |
+| Ctrl + Left Drag   | Create rectangle ROI                           |
+| Ctrl + Click out   | Remove current ROI                             |
+| Shift + Alt + Left | Box auto-contrast                  |
+| Shift + Left Drag  | Live contrast adjustment             |
+| Alt + Left Drag    | Stack/frame scroll                             |    
+
 ### Preview Opener
-This command creates a montage of opened images and saves it in their directory.  
-**How to use:**
-1. Open the images you want (virtual stacks supported)
+This command creates a thumbnail montage of opened images and saves it in their directory  
+Then the Multi Tool can interact with this montage to open the selected image 
+##### **How to use:**
+1. Open the images you want (virtual stacks supported) from a single folder
 2. Adjust display settings
 3. run the command `Create Preview Opener`
-{% include video src="https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Preview-Opener-.mp4" %}       
-With the **Multi Tool**, middle-click on a montage will open the image under the cursor—making it fast to find images within a folder
-**Notes:**
-- Montage title must include “Preview Opener” (you can add text before/after)
+The generated montage will auto-save in the images folder
+With the **Multi Tool**, middle-click on a montage to open the image under the cursor      
+###### **Notes:**
 - Keep the Preview Opener file in the images folder
+- Montage title must include “Preview Opener” (you can add text before/after)
 ### Other Commands
 A small collection of utility macros:
 - **Split View:** Quickly create clean multichannel montages       
-![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-SplitView.png?raw=true){:width="400px"}    
+![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-SplitView.png?raw=true){:width="500px"}    
 
 - **Auto Scale Bar:** Estimate and add scale bar. You can adjust the size and hide the text in options. This macro is adapted from [Aleš Kladnik](https://forum.image.sc/t/automatic-scale-bar-in-fiji-imagej/60774)     
 - **Auto-Contrast** recordable macro commands similar to the Channels and Contrast buttons
