[[TranslatedPages(outdated=Some preferences still need a description)]]
= Geotagged Images panel =

[[JOSMImage(dialogs/geoimage,48,link=,middle,margin-right=20)]] ''Keyboard shortcut'': **`Y`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]

This panel is a **viewer for photos** from a geoimage layer.

It shows all photos from a source layer, whether geotagged or not. Other source layers containing images like e.g. GPX waypoint images or the Mapillary plugin use this panel as well. Several source layers are represented in the panel via tabs.

[[Image(ImageViewer_r18621.jpg,​link=)]]

The dialog title shows the layer name and the name of the currently displayed image. Below are the image layer tabs (if needed) with the layer name and a button to remove the layer from the image viewer. The active tab is raised and indicated by a star (`*`) in front of the name. By clicking on the the tabs, you can switch quickly between image layers. The image currently displayed is highlighted in bright red in the map view. There is a selected image in each layer. These other selected images are highlighted in dark red in the map view.

The tabs are displayed in the same order as the layers, from lowest to highest. But if there is more than one row of tabs, the active tab is in the bottom row. When there is only one tab, the tab is hidden. In expert mode, the layer number is added to each tab, between square brackets. (Tabs exist since r18621.)


== Source Layer ==
{{{#!comment
following does not work for me with r18621
}}}
{{{#!comment
To change the source layer for the images displayed use the shortcut **`Ctrl+Alt+J`⤳`[0-9]`** or the context menu **Jump to next marker** from a [wikitr:/Help/Menu/PhotoLayer Geoimage layer] in the [wikitr:/Help/Dialog/LayerList Layer List].
}}}

A source layer can be added when an image of the layer is selected in the [wikitr:/Help/MapView Map view] and the current source layer is not the active layer. 
This may get confusing when navigating between several Geoimage layers.


== Zoom and position ==
Zooming is possible with the mouse wheel and left/right mouse button click or a left mouse button dragged rectangle selection.\\
The position can be adjusted with right mouse button drag.


== Buttons ==
The Geotagged Images dialog has several buttons which operate on the photo:

||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =||
||  [[JOSMImage(dialogs/first,24,middle,link=)]]  ||\
|| First ||\
||  **`Home`**  ||\
|| Shows the first image. ||\
||
||  [[JOSMImage(dialogs/previous,24,middle,link=)]]  ||\
|| Previous ||\
||  **`Page Up`**  ||\
|| Shows the previous image. ||\
||
||  [[JOSMImage(dialogs/next,24,middle,link=)]]  ||\
|| Next ||\
||  **`Page Down`**  ||\
|| Shows the next image. ||\
||
||  [[JOSMImage(dialogs/last,24,middle,link=)]]  ||\
|| Last ||\
||  **`End`**  ||\
|| Shows the last images. ||
||||
||  [[JOSMImage(dialogs/autoscale/selection)]]  ||\
|| Center view || ||\
|| Always scrolls the map to the location of the active image. ||\
||
||  [[JOSMImage(dialogs/zoom-best-fit)]]  ||\
|| Zoom best fit and 1:1 || ||\
|| Toggles image zoom between ''best fit'' and 1:1. For further zooming use the mouse wheel and for dragging right click + mouse moving. ||
||||
||  [[JOSMImage(dialogs/delete,24,middle,link=)]]  ||\
|| Remove photo from layer ||\
||  **`Shift+Delete`**  ||\
|| Removes the image from the layer. ||\
||
||  [[JOSMImage(dialogs/geoimage/deletefromdisk)]]  ||\
|| Delete image file from disk ||\
||  **`Ctrl+Shift+Del`**  ||\
|| Deletes the image from the storage medium. ||
||||
||  [[JOSMImage(copy,24,middle,link=)]]  ||\
|| Copy image path ||\
||  **`Ctrl+Alt+Shift+C`**  ||\
|| Copies the path to the local image file onto the clipboard (ready to "paste")
||  [[JOSMImage(external-link)]]  ||\
|| Open image in external viewer ||\
||    ||\
|| Open image in external viewer. ''(since r18300)'' ||
||||
||  [[JOSMImage(dialogs/layerlist/visibility)]]  ||\
|| Change visibility ||\
||    ||\
|| Adjusts Colorfulness, Gamma and Sharpness. ||\
||||
||||
||    ||\
||    ||\
||  **`Left`/`Right`/`Up`/`Down`**  ||\
|| Switch through the tabs of different source layers with arrow keys. (Does not work with Mac OS X look-and-feel.) ||\


== Advanced Preferences ==#AdvancedPreferences
||= **Property** =||= **Default** =||= **Explanation** =||
|| **`geoimage.maximum-width`** ||  `6000`  || The maximum width of images in pixels. Bigger images are automatically scaled down. ||
|| **`geoimage.maximum-zoom-scale`** ||  `2.0`  ||  ||
|| **`geoimage.use-mouse-clicks-to-zoom`** ||  `true`  || Enable left/right mouse button click to zoom ||
|| **`geoimage.zoom-step-factor`** ||  `1.5`  ||  ||
||||
|| **`clr.general.geoimage.selected.not.image.viewer`** ||  `#320000`  || Highlight color for images (one per geoimage layer) which are selected but not currently being viewed. For a change to take effect, the geoimage layer needs to be removed and re-added. ||

----
Back to [wikitr:/Help/Menu/Windows Windows menu] \\
Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
Back to [wikitr:/Help/Menu Main Menu] \\
Back to [wikitr:/Help Main Help]