001// License: GPL. For details, see LICENSE file.
002package org.openstreetmap.josm.gui.layer.geoimage;
003
004import static org.openstreetmap.josm.tools.I18n.tr;
005
006import java.awt.BorderLayout;
007import java.awt.Component;
008import java.awt.Dimension;
009import java.awt.GridBagConstraints;
010import java.awt.GridBagLayout;
011import java.awt.event.ActionEvent;
012import java.awt.event.KeyEvent;
013import java.awt.event.WindowEvent;
014import java.text.DateFormat;
015
016import javax.swing.AbstractAction;
017import javax.swing.Box;
018import javax.swing.ImageIcon;
019import javax.swing.JButton;
020import javax.swing.JComponent;
021import javax.swing.JPanel;
022import javax.swing.JToggleButton;
023
024import org.openstreetmap.josm.Main;
025import org.openstreetmap.josm.gui.MapView;
026import org.openstreetmap.josm.gui.MapView.LayerChangeListener;
027import org.openstreetmap.josm.gui.dialogs.DialogsPanel.Action;
028import org.openstreetmap.josm.gui.dialogs.ToggleDialog;
029import org.openstreetmap.josm.gui.layer.Layer;
030import org.openstreetmap.josm.tools.ImageProvider;
031import org.openstreetmap.josm.tools.Shortcut;
032import org.openstreetmap.josm.tools.date.DateUtils;
033
034public final class ImageViewerDialog extends ToggleDialog implements LayerChangeListener {
035
036    private static final String COMMAND_ZOOM = "zoom";
037    private static final String COMMAND_CENTERVIEW = "centre";
038    private static final String COMMAND_NEXT = "next";
039    private static final String COMMAND_REMOVE = "remove";
040    private static final String COMMAND_REMOVE_FROM_DISK = "removefromdisk";
041    private static final String COMMAND_PREVIOUS = "previous";
042    private static final String COMMAND_COLLAPSE = "collapse";
043    private static final String COMMAND_FIRST = "first";
044    private static final String COMMAND_LAST = "last";
045    private static final String COMMAND_COPY_PATH = "copypath";
046
047    private ImageDisplay imgDisplay = new ImageDisplay();
048    private boolean centerView;
049
050    // Only one instance of that class is present at one time
051    private static volatile ImageViewerDialog dialog;
052
053    private boolean collapseButtonClicked;
054
055    static void newInstance() {
056        dialog = new ImageViewerDialog();
057    }
058
059    /**
060     * Replies the unique instance of this dialog
061     * @return the unique instance
062     */
063    public static ImageViewerDialog getInstance() {
064        if (dialog == null)
065            throw new AssertionError("a new instance needs to be created first");
066        return dialog;
067    }
068
069    private JButton btnNext;
070    private JButton btnPrevious;
071    private JButton btnCollapse;
072
073    private ImageViewerDialog() {
074        super(tr("Geotagged Images"), "geoimage", tr("Display geotagged images"), Shortcut.registerShortcut("tools:geotagged",
075        tr("Tool: {0}", tr("Display geotagged images")), KeyEvent.VK_Y, Shortcut.DIRECT), 200);
076        build();
077        MapView.addLayerChangeListener(this);
078    }
079
080    protected void build() {
081        JPanel content = new JPanel();
082        content.setLayout(new BorderLayout());
083
084        content.add(imgDisplay, BorderLayout.CENTER);
085
086        Dimension buttonDim = new Dimension(26, 26);
087
088        ImageAction prevAction = new ImageAction(COMMAND_PREVIOUS, ImageProvider.get("dialogs", "previous"), tr("Previous"));
089        btnPrevious = new JButton(prevAction);
090        btnPrevious.setPreferredSize(buttonDim);
091        Shortcut scPrev = Shortcut.registerShortcut(
092                "geoimage:previous", tr("Geoimage: {0}", tr("Show previous Image")), KeyEvent.VK_PAGE_UP, Shortcut.DIRECT);
093        final String APREVIOUS = "Previous Image";
094        Main.registerActionShortcut(prevAction, scPrev);
095        btnPrevious.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(scPrev.getKeyStroke(), APREVIOUS);
096        btnPrevious.getActionMap().put(APREVIOUS, prevAction);
097        btnPrevious.setEnabled(false);
098
099        final String DELETE_TEXT = tr("Remove photo from layer");
100        ImageAction delAction = new ImageAction(COMMAND_REMOVE, ImageProvider.get("dialogs", "delete"), DELETE_TEXT);
101        JButton btnDelete = new JButton(delAction);
102        btnDelete.setPreferredSize(buttonDim);
103        Shortcut scDelete = Shortcut.registerShortcut(
104                "geoimage:deleteimagefromlayer", tr("Geoimage: {0}", tr("Remove photo from layer")), KeyEvent.VK_DELETE, Shortcut.SHIFT);
105        Main.registerActionShortcut(delAction, scDelete);
106        btnDelete.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(scDelete.getKeyStroke(), DELETE_TEXT);
107        btnDelete.getActionMap().put(DELETE_TEXT, delAction);
108
109        ImageAction delFromDiskAction = new ImageAction(COMMAND_REMOVE_FROM_DISK,
110                ImageProvider.get("dialogs", "geoimage/deletefromdisk"), tr("Delete image file from disk"));
111        JButton btnDeleteFromDisk = new JButton(delFromDiskAction);
112        btnDeleteFromDisk.setPreferredSize(buttonDim);
113        Shortcut scDeleteFromDisk = Shortcut.registerShortcut(
114                "geoimage:deletefilefromdisk", tr("Geoimage: {0}", tr("Delete File from disk")), KeyEvent.VK_DELETE, Shortcut.CTRL_SHIFT);
115        final String ADELFROMDISK = "Delete image file from disk";
116        Main.registerActionShortcut(delFromDiskAction, scDeleteFromDisk);
117        btnDeleteFromDisk.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(scDeleteFromDisk.getKeyStroke(), ADELFROMDISK);
118        btnDeleteFromDisk.getActionMap().put(ADELFROMDISK, delFromDiskAction);
119
120        ImageAction copyPathAction = new ImageAction(COMMAND_COPY_PATH, ImageProvider.get("copy"), tr("Copy image path"));
121        JButton btnCopyPath = new JButton(copyPathAction);
122        btnCopyPath.setPreferredSize(buttonDim);
123        Shortcut scCopyPath = Shortcut.registerShortcut(
124                "geoimage:copypath", tr("Geoimage: {0}", tr("Copy image path")), KeyEvent.VK_C, Shortcut.ALT_CTRL_SHIFT);
125        final String ACOPYPATH = "Copy image path";
126        Main.registerActionShortcut(copyPathAction, scCopyPath);
127        btnCopyPath.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(scCopyPath.getKeyStroke(), ACOPYPATH);
128        btnCopyPath.getActionMap().put(ACOPYPATH, copyPathAction);
129
130        ImageAction nextAction = new ImageAction(COMMAND_NEXT, ImageProvider.get("dialogs", "next"), tr("Next"));
131        btnNext = new JButton(nextAction);
132        btnNext.setPreferredSize(buttonDim);
133        Shortcut scNext = Shortcut.registerShortcut(
134                "geoimage:next", tr("Geoimage: {0}", tr("Show next Image")), KeyEvent.VK_PAGE_DOWN, Shortcut.DIRECT);
135        final String ANEXT = "Next Image";
136        Main.registerActionShortcut(nextAction, scNext);
137        btnNext.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(scNext.getKeyStroke(), ANEXT);
138        btnNext.getActionMap().put(ANEXT, nextAction);
139        btnNext.setEnabled(false);
140
141        Main.registerActionShortcut(
142                new ImageAction(COMMAND_FIRST, null, null),
143                Shortcut.registerShortcut(
144                        "geoimage:first", tr("Geoimage: {0}", tr("Show first Image")), KeyEvent.VK_HOME, Shortcut.DIRECT)
145        );
146        Main.registerActionShortcut(
147                new ImageAction(COMMAND_LAST, null, null),
148                Shortcut.registerShortcut(
149                        "geoimage:last", tr("Geoimage: {0}", tr("Show last Image")), KeyEvent.VK_END, Shortcut.DIRECT)
150        );
151
152        JToggleButton tbCentre = new JToggleButton(new ImageAction(COMMAND_CENTERVIEW,
153                ImageProvider.get("dialogs", "centreview"), tr("Center view")));
154        tbCentre.setPreferredSize(buttonDim);
155
156        JButton btnZoomBestFit = new JButton(new ImageAction(COMMAND_ZOOM,
157                ImageProvider.get("dialogs", "zoom-best-fit"), tr("Zoom best fit and 1:1")));
158        btnZoomBestFit.setPreferredSize(buttonDim);
159
160        btnCollapse = new JButton(new ImageAction(COMMAND_COLLAPSE,
161                ImageProvider.get("dialogs", "collapse"), tr("Move dialog to the side pane")));
162        btnCollapse.setPreferredSize(new Dimension(20, 20));
163        btnCollapse.setAlignmentY(Component.TOP_ALIGNMENT);
164
165        JPanel buttons = new JPanel();
166        buttons.add(btnPrevious);
167        buttons.add(btnNext);
168        buttons.add(Box.createRigidArea(new Dimension(7, 0)));
169        buttons.add(tbCentre);
170        buttons.add(btnZoomBestFit);
171        buttons.add(Box.createRigidArea(new Dimension(7, 0)));
172        buttons.add(btnDelete);
173        buttons.add(btnDeleteFromDisk);
174        buttons.add(Box.createRigidArea(new Dimension(7, 0)));
175        buttons.add(btnCopyPath);
176
177        JPanel bottomPane = new JPanel();
178        bottomPane.setLayout(new GridBagLayout());
179        GridBagConstraints gc = new GridBagConstraints();
180        gc.gridx = 0;
181        gc.gridy = 0;
182        gc.anchor = GridBagConstraints.CENTER;
183        gc.weightx = 1;
184        bottomPane.add(buttons, gc);
185
186        gc.gridx = 1;
187        gc.gridy = 0;
188        gc.anchor = GridBagConstraints.PAGE_END;
189        gc.weightx = 0;
190        bottomPane.add(btnCollapse, gc);
191
192        content.add(bottomPane, BorderLayout.SOUTH);
193
194        createLayout(content, false, null);
195    }
196
197    @Override
198    public void destroy() {
199        MapView.removeLayerChangeListener(this);
200        super.destroy();
201    }
202
203    class ImageAction extends AbstractAction {
204        private final String action;
205
206        ImageAction(String action, ImageIcon icon, String toolTipText) {
207            this.action = action;
208            putValue(SHORT_DESCRIPTION, toolTipText);
209            putValue(SMALL_ICON, icon);
210        }
211
212        @Override
213        public void actionPerformed(ActionEvent e) {
214            if (COMMAND_NEXT.equals(action)) {
215                if (currentLayer != null) {
216                    currentLayer.showNextPhoto();
217                }
218            } else if (COMMAND_PREVIOUS.equals(action)) {
219                if (currentLayer != null) {
220                    currentLayer.showPreviousPhoto();
221                }
222            } else if (COMMAND_FIRST.equals(action) && currentLayer != null) {
223                currentLayer.showFirstPhoto();
224            } else if (COMMAND_LAST.equals(action) && currentLayer != null) {
225                currentLayer.showLastPhoto();
226            } else if (COMMAND_CENTERVIEW.equals(action)) {
227                centerView = ((JToggleButton) e.getSource()).isSelected();
228                if (centerView && currentEntry != null && currentEntry.getPos() != null) {
229                    Main.map.mapView.zoomTo(currentEntry.getPos());
230                }
231            } else if (COMMAND_ZOOM.equals(action)) {
232                imgDisplay.zoomBestFitOrOne();
233            } else if (COMMAND_REMOVE.equals(action)) {
234                if (currentLayer != null) {
235                    currentLayer.removeCurrentPhoto();
236                }
237            } else if (COMMAND_REMOVE_FROM_DISK.equals(action)) {
238                if (currentLayer != null) {
239                    currentLayer.removeCurrentPhotoFromDisk();
240                }
241            } else if (COMMAND_COPY_PATH.equals(action)) {
242                if (currentLayer != null) {
243                    currentLayer.copyCurrentPhotoPath();
244                }
245            } else if (COMMAND_COLLAPSE.equals(action)) {
246                collapseButtonClicked = true;
247                detachedDialog.getToolkit().getSystemEventQueue().postEvent(new WindowEvent(detachedDialog, WindowEvent.WINDOW_CLOSING));
248            }
249        }
250    }
251
252    public static void showImage(GeoImageLayer layer, ImageEntry entry) {
253        getInstance().displayImage(layer, entry);
254        if (layer != null) {
255            layer.checkPreviousNextButtons();
256        } else {
257            setPreviousEnabled(false);
258            setNextEnabled(false);
259        }
260    }
261
262    /**
263     * Enables (or disables) the "Previous" button.
264     * @param value {@code true} to enable the button, {@code false} otherwise
265     */
266    public static void setPreviousEnabled(boolean value) {
267        getInstance().btnPrevious.setEnabled(value);
268    }
269
270    /**
271     * Enables (or disables) the "Next" button.
272     * @param value {@code true} to enable the button, {@code false} otherwise
273     */
274    public static void setNextEnabled(boolean value) {
275        getInstance().btnNext.setEnabled(value);
276    }
277
278    private transient GeoImageLayer currentLayer;
279    private transient ImageEntry currentEntry;
280
281    public void displayImage(GeoImageLayer layer, ImageEntry entry) {
282        boolean imageChanged;
283
284        synchronized (this) {
285            // TODO: pop up image dialog but don't load image again
286
287            imageChanged = currentEntry != entry;
288
289            if (centerView && Main.isDisplayingMapView() && entry != null && entry.getPos() != null) {
290                Main.map.mapView.zoomTo(entry.getPos());
291            }
292
293            currentLayer = layer;
294            currentEntry = entry;
295        }
296
297        if (entry != null) {
298            if (imageChanged) {
299                // Set only if the image is new to preserve zoom and position if the same image is redisplayed
300                // (e.g. to update the OSD).
301                imgDisplay.setImage(entry.getFile(), entry.getExifOrientation());
302            }
303            setTitle(tr("Geotagged Images") + (entry.getFile() != null ? " - " + entry.getFile().getName() : ""));
304            StringBuilder osd = new StringBuilder(entry.getFile() != null ? entry.getFile().getName() : "");
305            if (entry.getElevation() != null) {
306                osd.append(tr("\nAltitude: {0} m", entry.getElevation().longValue()));
307            }
308            if (entry.getSpeed() != null) {
309                osd.append(tr("\nSpeed: {0} km/h", Math.round(entry.getSpeed())));
310            }
311            if (entry.getExifImgDir() != null) {
312                osd.append(tr("\nDirection {0}\u00b0", Math.round(entry.getExifImgDir())));
313            }
314            DateFormat dtf = DateUtils.getDateTimeFormat(DateFormat.SHORT, DateFormat.MEDIUM);
315            if (entry.hasExifTime()) {
316                osd.append(tr("\nEXIF time: {0}", dtf.format(entry.getExifTime())));
317            }
318            if (entry.hasGpsTime()) {
319                osd.append(tr("\nGPS time: {0}", dtf.format(entry.getGpsTime())));
320            }
321
322            imgDisplay.setOsdText(osd.toString());
323        } else {
324            // if this method is called to reinitialize dialog content with a blank image,
325            // do not actually show the dialog again with a blank image if currently hidden (fix #10672)
326            setTitle(tr("Geotagged Images"));
327            imgDisplay.setImage(null, null);
328            imgDisplay.setOsdText("");
329            return;
330        }
331        if (!isDialogShowing()) {
332            setIsDocked(false);     // always open a detached window when an image is clicked and dialog is closed
333            showDialog();
334        } else {
335            if (isDocked && isCollapsed) {
336                expand();
337                dialogsPanel.reconstruct(Action.COLLAPSED_TO_DEFAULT, this);
338            }
339        }
340    }
341
342    /**
343     * When an image is closed, really close it and do not pop
344     * up the side dialog.
345     */
346    @Override
347    protected boolean dockWhenClosingDetachedDlg() {
348        if (collapseButtonClicked) {
349            collapseButtonClicked = false;
350            return true;
351        }
352        return false;
353    }
354
355    @Override
356    protected void stateChanged() {
357        super.stateChanged();
358        if (btnCollapse != null) {
359            btnCollapse.setVisible(!isDocked);
360        }
361    }
362
363    /**
364     * Returns whether an image is currently displayed
365     * @return If image is currently displayed
366     */
367    public boolean hasImage() {
368        return currentEntry != null;
369    }
370
371    /**
372     * Returns the currently displayed image.
373     * @return Currently displayed image or {@code null}
374     * @since 6392
375     */
376    public static ImageEntry getCurrentImage() {
377        return getInstance().currentEntry;
378    }
379
380    /**
381     * Returns the layer associated with the image.
382     * @return Layer associated with the image
383     * @since 6392
384     */
385    public static GeoImageLayer getCurrentLayer() {
386        return getInstance().currentLayer;
387    }
388
389    @Override
390    public void activeLayerChange(Layer oldLayer, Layer newLayer) {
391        if (currentLayer == null && newLayer instanceof GeoImageLayer) {
392            ((GeoImageLayer) newLayer).showFirstPhoto();
393        }
394    }
395
396    @Override
397    public void layerAdded(Layer newLayer) {
398        if (currentLayer == null && newLayer instanceof GeoImageLayer) {
399            ((GeoImageLayer) newLayer).showFirstPhoto();
400        }
401    }
402
403    @Override
404    public void layerRemoved(Layer oldLayer) {
405        // Clear current image and layer if current layer is deleted
406        if (currentLayer != null && currentLayer.equals(oldLayer)) {
407            showImage(null, null);
408        }
409        // Check buttons state in case of layer merging
410        if (currentLayer != null && oldLayer instanceof GeoImageLayer) {
411            currentLayer.checkPreviousNextButtons();
412        }
413    }
414}