Skip to content

Commit 867b693

Browse files
committed
Update zoom tool
1 parent 5f6f8e1 commit 867b693

File tree

1 file changed

+59
-44
lines changed

1 file changed

+59
-44
lines changed

content/tutorials/zoom.en.md

Lines changed: 59 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,86 @@
11
---
22
title: Zoom
33
weight: 340
4-
description: How to manipulate zoom and lens
5-
keywords: [ "zoom", "lens", "dicom viewer", "pacs viewer" ]
4+
description: How to use zoom controls and magnifying lens
5+
keywords: ["zoom", "lens", "dicom viewer", "pacs viewer"]
66
---
77

8-
## <center>Zoom tool {{< svg-inline "static/tuto/icon/zoom.svg" >}}</center>
8+
## Zoom Tool {{< svg-inline "static/tuto/icon/zoom.svg" >}}
99

10-
The zoom tool can be associated with one of three mouse actions. In the image below, the zoom tool {{< svg-inline "static/tuto/icon/zoom.svg" >}} is associated with the middle mouse button. See also [zoom preferences](../dicom-2d-viewer/#preferences).
10+
### Basic Zoom Controls
1111

12-
The zoom factor can be modified from different locations:
12+
The zoom tool {{< svg-inline "static/tuto/icon/zoom.svg" >}} provides multiple ways to adjust image magnification:
1313

14-
* By dragging the cursor over the image with the configured mouse button
15-
* By scrolling the mouse wheel when configured
16-
* By selecting an item in the zoom dropdown button in the toolbar
17-
* From the context menu: right-click on the image > Zoom
18-
* Form the slider in the image tool panel
19-
* Using [Keyboard Shortcuts](../../basics/shortcuts) (_Ctrl + Plus (+)_, _Ctrl + Minus (-)_ and _Ctrl + Enter_) on the selected view
14+
* **Mouse Drag**: Drag with the configured mouse button (middle button by default)
15+
* **Mouse Wheel**: When enabled in preferences
16+
* **Toolbar Dropdown**: Select preset zoom levels
17+
* **Context Menu**: Right-click > Zoom
18+
* **Image Tool Panel**: Use the zoom slider
19+
* **Keyboard Shortcuts**:
20+
* `Ctrl + Plus (+)`: Zoom in
21+
* `Ctrl + Minus (-)`: Zoom out
22+
* `Ctrl + Enter`: Reset zoom
2023

21-
The context menu and the toolbar button allow you to select different zoom factors:
24+
{{% notice tip %}}
25+
Quick Access: Press `z` to instantly set zoom as the left mouse button action
26+
{{% /notice %}}
2227

23-
* Actual pixel size {{< svg-inline "static/tuto/icon/zoomOriginal.svg" >}}: display the image at a 1:1 ratio, where each pixel in the image corresponds to one pixel on the screen
24-
* Real world (see [below](#real-world-zoom)) {{< svg-inline "static/tuto/icon/zoomRealWorld.svg" >}}
25-
* Resize to best fit {{< svg-inline "static/tuto/icon/zoomBestFit.svg" >}}: scaling the image to make it fit the view area as closely as possible
28+
### Zoom Presets
2629

27-
{{% notice note %}}
28-
The zoom function always zooms in/out to the center of the screen regardless of where the cursor is. This mode provides greater positional accuracy in particular situations.
30+
The toolbar and context menu offer three preset zoom options:
31+
32+
* **Actual Pixels** {{< svg-inline "static/tuto/icon/zoomOriginal.svg" >}}: 1:1 ratio display
33+
* **Real-world Size** {{< svg-inline "static/tuto/icon/zoomRealWorld.svg" >}}: Physical size display
34+
* **Best Fit** {{< svg-inline "static/tuto/icon/zoomBestFit.svg" >}}: Scale to fit view area
2935

30-
Since "Resize to best fit" is the default mode for a view, the image will be centered when scrolling to the next image. You need to change the mode or the zoom factor to keep the image off the center when scrolling.
36+
{{% notice note %}}
37+
* Zoom operations always center on the screen, regardless of cursor position
38+
* Best Fit (default mode) recenters images when scrolling through a series
39+
* To maintain off-center positioning while scrolling, change the zoom mode or factor
40+
* To change the zoom interpolation method, see the [Preferences](../dicom-2d-viewer/#preferences) section
3141
{{% /notice %}}
3242

33-
![Zoom tool](/tuto/zoom-actions.jpg?classes=shadow&width=700px)
43+
![Zoom tool controls](/tuto/zoom-actions.jpg?classes=shadow&width=700px)
3444
<br>
35-
{{% notice tip %}}
36-
For selecting directly the zoom action of the mouse left button, enter "z" as a shortcut.
37-
{{% /notice %}}
3845

39-
### Real-world zoom {{< svg-inline "static/tuto/icon/zoomRealWorld.svg" >}} {#real-world-zoom}
40-
The real-world zoom allows displaying the content of the image at the same size of the real objects.
46+
### Real-world Size Display {{< svg-inline "static/tuto/icon/zoomRealWorld.svg" >}}
4147

42-
The feature requires calibrating the screen where the image is displayed. From the main menu, open _File > Preferences (Alt + P) > Monitors_ and click on _Spatial calibration_. Then enter a value that matches to the line length or the diagonal length of the screen.
48+
To display images at their actual physical size:
49+
50+
1. Open Preferences: _File > Preferences (Alt + P) > Monitors_
51+
2. Click _Spatial calibration_
52+
3. Enter your screen's line length or diagonal length
4353

4454
{{% notice note %}}
45-
Several screens can be calibrated. Each one has its own spatial calibration factor.
55+
Each monitor can have its own calibration setting
4656
{{% /notice %}}
4757

48-
## Magnifying lens {{< svg-inline "static/tuto/icon/zoomPan.svg" >}} {#magnifying-lens}
49-
The magnifying lens can be activated from the toggle button of the zoom toolbar (see the image below). It has several parameters accessible from the context menu.
58+
## Magnifying Lens {{< svg-inline "static/tuto/icon/zoomPan.svg" >}}
5059

51-
This lens can be used in many situations, for instance:
60+
The magnifying lens provides detailed inspection of specific image areas. Access it through the zoom toolbar's toggle button.
5261

53-
* to magnify a specific area
54-
* to compare two images from the same series (select `Freeze image`)
55-
* to display a specific area without the drawings (Unselect `Show Drawings`)
56-
* to compare different values of Window/Level (select `Freeze parameters` - see image below)
62+
![Lens example](/tuto/lens-drawing.jpg?classes=shadow&width=700px)
63+
<br>
5764

58-
{{% notice note %}}
59-
Using the mouse wheel on the lens changes the zoom factor. Double-clicking on the lens adjusts the zoom factor of the lens to the one of the main image.
60-
{{% /notice %}}
65+
### Key Features
6166

62-
![Lens](/tuto/lens-drawing.jpg?classes=shadow&width=700px)
63-
<br>
64-
Parameters of the context menu:
67+
* Magnify specific regions
68+
* View areas without drawings (`Show Drawings` toggle)
69+
* Compare different Window/Level settings (`Freeze parameters`)
70+
* Compare images from the same series (using `Freeze image`)
71+
72+
### Lens Controls
6573

66-
* *Synchronize to parent zoom:* When this option is activated, the zoom factor of the lens is permanently adjusted to the zoom factor of the main image (meaningful when using freeze parameters).
67-
* *Show Drawings:* Displays in the lens the visible drawings.
68-
* *Magnify:* Allows selecting a zoom magnitude.
69-
* *Image:* `Freeze parameters` allows you to keep the current image processing (c.f. Window/level, LUT or filter) and `Freeze image` allows you to keep the current image and its parameters.
74+
* **Mouse Wheel**: Adjust lens zoom
75+
* **Double-click**: Match lens zoom to main image
76+
* **Context Menu Options**:
77+
* *Hide Lens*: disable the lens
78+
* *Synchronize to parent zoom*: Match lens zoom to main image
79+
* *Show Drawings*: Toggle overlay visibility
80+
* *Magnify*: Select zoom level
81+
* *Image*: Control image and parameter freezing
82+
* **Freeze Parameters**: Maintains the current image processing settings (like Window/Level, LUT, or filters) while allowing you to scroll through different images. This is useful for comparing the same anatomical area with different processing settings.
83+
* **Freeze Image**: Captures and holds the current image and its processing parameters, letting you use it as a reference while viewing other images. This is particularly helpful when comparing different slices or time points of a study.
84+
* **Reset Freeze**: Clears any frozen parameters or images, allowing you to return to the default behavior where the lens reflects the current image and its processing settings.
7085

71-
![Lens freeze](/tuto/lens-freeze.jpg?classes=shadow&width=700px)
86+
![Lens with frozen parameters](/tuto/lens-freeze.jpg?classes=shadow&width=700px)

0 commit comments

Comments
 (0)