| 1 |
.. _ima-menu-view: |
| 2 |
|
| 3 |
View options for Images |
| 4 |
======================= |
| 5 |
|
| 6 |
.. figure:: /images/shots/i_view.png |
| 7 |
|
| 8 |
Screenshot of the "View" menu. |
| 9 |
|
| 10 |
When the "Image Panel" is selected, the menus and toolbars are updated to |
| 11 |
provide image-related actions. |
| 12 |
|
| 13 |
The "View" menu allows you to visualize the current image or group of images. |
| 14 |
It also allows you to show/hide titles, to show/hide the contrast panel, to |
| 15 |
refresh the visualization, and so on. |
| 16 |
|
| 17 |
View in a new window |
| 18 |
^^^^^^^^^^^^^^^^^^^^ |
| 19 |
|
| 20 |
Open a new window to visualize the selected images. |
| 21 |
|
| 22 |
This option allows you to show the selected images in a separate window, |
| 23 |
in which you can visualize the data more comfortably (e.g., by maximizing the |
| 24 |
window) as well as to add or edit annotations. |
| 25 |
|
| 26 |
When you click on the button "Annotations" in the toolbar of the new window, |
| 27 |
the annotation editing mode is activated (see the section "Edit annotations" below). |
| 28 |
|
| 29 |
View images side-by-side |
| 30 |
^^^^^^^^^^^^^^^^^^^^^^^^ |
| 31 |
|
| 32 |
Open a new window to visualize the selected images side-by-side. |
| 33 |
|
| 34 |
This option allows you to show the selected images in a separate window, |
| 35 |
arranged in a grid layout, with synchronized zooming and panning. |
| 36 |
This is useful to compare multiple images simultaneously. |
| 37 |
|
| 38 |
Edit annotations |
| 39 |
^^^^^^^^^^^^^^^^ |
| 40 |
|
| 41 |
Open a new window to edit annotations. |
| 42 |
|
| 43 |
This option allows you to edit the annotations of the selected images in a |
| 44 |
separate window. This is equivalent to select the "View in a new window" option |
| 45 |
and then click on the "Annotations" button in the toolbar of the new window. |
| 46 |
|
| 47 |
Annotations are used to add text, lines, rectangles, ellipses, and other |
| 48 |
geometrical shapes to the images. They are useful to highlight regions of |
| 49 |
interest, to add comments, to mark points, and so on. |
| 50 |
|
| 51 |
.. note:: |
| 52 |
The annotations are saved in the metadata of the image, so they are |
| 53 |
persistent and will be displayed every time you visualize the image. |
| 54 |
|
| 55 |
.. figure:: /images/annotations/image_annotations1.png |
| 56 |
|
| 57 |
Annotations may be added in the separate view. |
| 58 |
|
| 59 |
The typical workflow to edit annotations is as follows: |
| 60 |
|
| 61 |
1. Select the "Edit annotations" option. |
| 62 |
2. In the new window, add annotations by clicking on the corresponding buttons |
| 63 |
at the bottom of the window. |
| 64 |
3. Eventually, customize the annotations by changing their properties (e.g., |
| 65 |
the text, the color, the position, etc.) using the "Parameters" option in the |
| 66 |
context menu of the annotations. |
| 67 |
4. When you are done, click on the "OK" button to save the annotations. This will |
| 68 |
close the window and the annotations will be saved in the metadata of the image |
| 69 |
and will be displayed in the main window. |
| 70 |
|
| 71 |
.. figure:: /images/annotations/image_annotations2.png |
| 72 |
|
| 73 |
Annotations are now part of the image metadata. |
| 74 |
|
| 75 |
.. note:: |
| 76 |
Annotations may be copied from an image to another by using the |
| 77 |
"copy/paste metadata" features. |
| 78 |
|
| 79 |
Auto-refresh |
| 80 |
^^^^^^^^^^^^ |
| 81 |
|
| 82 |
Automatically refresh the visualization when the data changes: |
| 83 |
|
| 84 |
- When enabled (default), the plot view is automatically refreshed when the |
| 85 |
data changes. |
| 86 |
|
| 87 |
- When disabled, the plot view is not refreshed until you manually refresh it |
| 88 |
by using the "Refresh manually" menu entry. |
| 89 |
|
| 90 |
Even though the refresh algorithm is optimized, it may still take some time to |
| 91 |
refresh the plot view when the data changes, especially when the data set is |
| 92 |
large. Therefore, you may want to disable the auto-refresh feature when you are |
| 93 |
working with large data sets, and enable it again when you are done. This will |
| 94 |
avoid unnecessary refreshes. |
| 95 |
|
| 96 |
Show only first selected image |
| 97 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 98 |
|
| 99 |
Toggle between showing all selected images or only the first one. |
| 100 |
|
| 101 |
When this option is enabled, only the first selected image is displayed in the plot |
| 102 |
view. This may be useful when multiple images are selected and focusing on a single |
| 103 |
image is (temporarily) preferred. |
| 104 |
|
| 105 |
Refresh manually |
| 106 |
^^^^^^^^^^^^^^^^ |
| 107 |
|
| 108 |
Refresh the visualization manually. |
| 109 |
|
| 110 |
This triggers a refresh of the plot view. It is useful when the auto-refresh |
| 111 |
feature is disabled, or when you want to force a refresh of the plot view. |
| 112 |
|
| 113 |
Show contrast panel |
| 114 |
^^^^^^^^^^^^^^^^^^^ |
| 115 |
|
| 116 |
Show/hide contrast adjustment panel. |
| 117 |
|
| 118 |
Show graphical object titles |
| 119 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 120 |
|
| 121 |
Show/hide titles of analysis results or annotations. |
| 122 |
|
| 123 |
This option allows you to show or hide the titles of the graphical objects |
| 124 |
(e.g., the titles of the analysis results or annotations). Hiding the titles |
| 125 |
can be useful when you want to visualize the data without any distractions, |
| 126 |
or if there are too many titles and they are overlapping. |