Skip to content

Commit 45fdfb2

Browse files
kwolbachiakwolbachia
authored
Refactor image viewer documentation
1 parent b6c5e0d commit 45fdfb2

File tree

1 file changed

+39
-52
lines changed

1 file changed

+39
-52
lines changed

‎_pages/plugins/image-viewer.md‎

Lines changed: 39 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,7 @@ All commands and plugins are located in the ``Plugins > Image Viewer`` menu
2525
But the easiest way is to install the toolbar menu from Image_Viewer_Toolset under the red `>>` menu in the ImageJ window
2626
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Toolset.png?raw=true){:width="300px"}
2727

28-
___
29-
30-
### Channels and Contrast
28+
# Channels and Contrast
3129
This plugin combines imageJ's "Brightness and Contrast" and "Channels Tool" functionalities to manage visualization of the active image
3230
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-Channels-and-Contrast.png?raw=true)
3331
You can:
@@ -37,90 +35,91 @@ You can:
3735
- Use two types of auto-contrast:
3836
- **Auto:** Uses imageJ "Enhance Contrast" command with a default of 0.1% saturated pixels (adjustable via "More" button). For stacks, contrast is based on displayed slice only
3937
- **Min/Max:** Sets display range to the channel stack's min/max values
40-
- Interface with the **LUTs Manager** to apply LUT palettes or individual favorite LUTs
38+
- Interface with the **LUTs Manager** to apply LUT palettes or individual favorite LUTs
4139
You can change order of LUTs in a palette directly with the mouse from the palette menu
4240
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-palettes.png?raw=true){:width="300px"}
4341
- Access more options and built-in utilities for multi-channel images via the "More" button
44-
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-More.png?raw=true)
42+
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-CC-More.png?raw=true){:width="200"}
4543

46-
### LUTs Manager
47-
#### Multichannel Palettes
44+
# LUTs Manager
45+
#### Multichannel Palettes:
4846
- Create and edit LUT sets
4947
- Add LUTs by drag-and-drop from **LUTs Finder**
5048
- Change LUT order with the mouse
5149
- Right-click on palette to move or remove LUTs
5250
- Empty palette channels default to "Grays"
5351
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-LUTs-Manager.png?raw=true){:width="600px"}
5452
#### LUTs Finder
55-
The plugin scans all LUTs in your ImageJ `luts` folder
56-
You can use the search bar and color buttons to filter the list
57-
The Favorite LUTs are stored and accessible from the Channels and Contrast plugin
58-
**Apply a LUT:**
59-
- Double-click a LUT or press **Enter** to apply to your image
60-
**LUT preview bands:**
61-
- Check for uniformity in color transitions for good contrast visibility
62-
**LUT properties:**
63-
Each LUT comes with an **estimated** description of its properties:
53+
All LUTs in your ImageJ `luts` folder are scanned
54+
You can use the search bar and color buttons to filter the list
55+
Favorite LUTs are stored and accessible from the Channels and Contrast plugin
56+
**Apply a LUT:** Double-click a LUT or press **Enter** to apply to your image
57+
**LUT preview bands:** Check for uniformity in color transitions for good contrast visibility
58+
**LUT properties:**
59+
Each LUT comes with an **estimated** description of its properties:
6460
- **Basic:** Identifies classic 'pure' LUTs (Red, Green, Blue, Cyan, etc.)
6561
- **Linear, Non-uniform:** Whether the perceptual brightness progression is linear
6662
- **Diverging:** Transitions from one color through a neutral midpoint to another color
6763
- **Isoluminant:** Changes in color but keeps the luminance consistent across the LUT
6864
- **Cyclic:** If the first and last colors are the same
6965
- **Luminance values:** Estimation of perceptual luminosity of the LUT min and max colors
7066

71-
### Multi Tool
67+
# Preview Opener
68+
This command creates a thumbnail montage of opened images and saves it in their directory
69+
Then the Multi Tool can interact with this montage to open the selected image
70+
##### **How to use:**
71+
1. Open the images you want (virtual stacks supported) from a single folder
72+
2. Adjust display settings
73+
3. run the command `Create Preview Opener`
74+
The generated montage will auto-save in the images folder
75+
With the **Multi Tool**, middle-click on a montage to open the image under the cursor
76+
###### **Notes:**
77+
- Keep the Preview Opener file in the images folder
78+
- Montage title must include “Preview Opener” (you can add text before/after)
79+
80+
# Multi Tool
7281
This Tool is a neutral tool
7382
but it can perform many actions based on the mouse button, modifier keys (shift, ctrl, alt) and context:
74-
##### **Windows**
75-
83+
### **Windows**
7684
- **Move Window:**
7785
Left Click and Drag (outside ROI):
7886
Moves the image window position interactively.
79-
8087
- **Reversible Full Screen:**
8188
Double Left Click:
8289
Maximizes/minimizes the image window, reversible to original size.
8390

84-
##### **Composite Display Switch**
91+
### **Composite Display Switch**
8592
- **Switch Composite Display:**
8693
Middle Click on composite image:
8794
Toggle display mode between Composite and Color.
88-
89-
##### **ROI**
95+
### **ROI**
9096
- **Create Rectangular ROI:**
9197
Ctrl + Left Mouse Drag:
92-
Drag to create a rectangular selection.
93-
98+
Drag to create a rectangular selection.
9499
- **Handle Polygon/Point ROI:**
95-
Drag ROI handles using Left Mouse and modify selected selection / points.
96-
100+
Drag ROI handles using Left Mouse and modify selected selection / points.
97101
- **Remove ROI:**
98102
Ctrl + Click outside the ROI removes the current ROI.
99-
100-
##### **Contrast**
103+
### **Contrast**
101104
- **Local Box Auto-Contrast:**
102105
Shift + Alt + Left Click (on non-RGB images):
103106
Creates a fixed-size box ROI and auto-adjusts contrast in its area.
104-
105107
- **Live Contrast Adjustment:**
106108
Shift + Left Mouse Drag (non-RGB images):
107109
Drag pointer in the image to interactively adjust contrast.
108-
109-
##### **Stack Browsing**
110+
### **Stack Browsing**
110111
- **Live Scroll through Slices/Frames:**
111112
Alt + Left Mouse Drag (on stack/multi-frame images):
112113
Drag horizontally to scroll through slices or frames.
113114

114-
##### **Preview Opener (Montage Browser)**
115+
### **Preview Opener interaction**
115116
- **Open Image from Preview Opener:**
116-
Mouse Over thumbnails:
117-
Updates slice label showing the path/name of the selected thumbnail.
118-
Middle Click on a thumbnail in ‘Preview Opener’ window:
119-
Opens the corresponding file.
117+
Mouse Over thumbnails will update top left label showing the file name of the selected image.
118+
Middle Click on a thumbnail to open the corresponding file.
120119
Caps Lock ON: Opens image as ‘virtual stack’.
121120
Supports standard formats or uses Bio-Formats Importer if needed.
122121

123-
##### Multi Tool Shortcuts Summary
122+
### Multi Tool Shortcuts Summary
124123

125124
| Mouse & Keys | Action |
126125
|--------------------|------------------------------------------------|
@@ -133,22 +132,10 @@ but it can perform many actions based on the mouse button, modifier keys (shift,
133132
| Shift + Left Drag | Live contrast adjustment |
134133
| Alt + Left Drag | Stack/frame scroll |
135134

136-
### Preview Opener
137-
This command creates a thumbnail montage of opened images and saves it in their directory
138-
Then the Multi Tool can interact with this montage to open the selected image
139-
##### **How to use:**
140-
1. Open the images you want (virtual stacks supported) from a single folder
141-
2. Adjust display settings
142-
3. run the command `Create Preview Opener`
143-
The generated montage will auto-save in the images folder
144-
With the **Multi Tool**, middle-click on a montage to open the image under the cursor
145-
###### **Notes:**
146-
- Keep the Preview Opener file in the images folder
147-
- Montage title must include “Preview Opener” (you can add text before/after)
148135
### Other Commands
149-
A small collection of utility macros:
136+
A collection of utility macros:
150137
- **Split View:** Quickly create clean multichannel montages
151138
![](https://github.com/imagej/imagej.github.io/blob/main/media/Image-Viewer/Image-Viewer-SplitView.png?raw=true){:width="500px"}
152139

153140
- **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)
154-
- **Auto-Contrast** recordable macro commands similar to the Channels and Contrast buttons
141+
- **Auto-Contrast** recordable macro commands reproducing the **Channels and Contrast** buttons

0 commit comments

Comments
 (0)