|
1 | 1 | --- |
2 | 2 | title: Zoom |
3 | 3 | 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"] |
6 | 6 | --- |
7 | 7 |
|
8 | | -## <center>Zoom tool {{< svg-inline "static/tuto/icon/zoom.svg" >}}</center> |
| 8 | +## Zoom Tool {{< svg-inline "static/tuto/icon/zoom.svg" >}} |
9 | 9 |
|
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 |
11 | 11 |
|
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: |
13 | 13 |
|
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 |
20 | 23 |
|
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 %}} |
22 | 27 |
|
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 |
26 | 29 |
|
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 |
29 | 35 |
|
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 |
31 | 41 | {{% /notice %}} |
32 | 42 |
|
33 | | - |
| 43 | + |
34 | 44 | <br> |
35 | | -{{% notice tip %}} |
36 | | -For selecting directly the zoom action of the mouse left button, enter "z" as a shortcut. |
37 | | -{{% /notice %}} |
38 | 45 |
|
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" >}} |
41 | 47 |
|
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 |
43 | 53 |
|
44 | 54 | {{% 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 |
46 | 56 | {{% /notice %}} |
47 | 57 |
|
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" >}} |
50 | 59 |
|
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. |
52 | 61 |
|
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 | + |
| 63 | +<br> |
57 | 64 |
|
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 |
61 | 66 |
|
62 | | - |
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 |
65 | 73 |
|
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. |
70 | 85 |
|
71 | | - |
| 86 | + |
0 commit comments