2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
7 * Jalview is free software: you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation, either version 3
10 * of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19 * The Jalview Authors are detailed in the 'AUTHORS' file.
23 import jalview.bin.Cache;
24 import jalview.renderer.OverviewRenderer;
25 import jalview.util.MessageManager;
26 import jalview.util.Platform;
27 import jalview.viewmodel.OverviewDimensions;
28 import jalview.viewmodel.OverviewDimensionsHideHidden;
29 import jalview.viewmodel.OverviewDimensionsShowHidden;
30 import jalview.viewmodel.ViewportListenerI;
32 import java.awt.BorderLayout;
33 import java.awt.Cursor;
34 import java.awt.Dimension;
35 import java.awt.event.ActionEvent;
36 import java.awt.event.ActionListener;
37 import java.awt.event.ComponentAdapter;
38 import java.awt.event.ComponentEvent;
39 import java.awt.event.MouseAdapter;
40 import java.awt.event.MouseEvent;
41 import java.awt.event.MouseMotionAdapter;
42 import java.beans.PropertyChangeEvent;
44 import javax.swing.JCheckBoxMenuItem;
45 import javax.swing.JPanel;
46 import javax.swing.JPopupMenu;
47 import javax.swing.SwingUtilities;
50 * Panel displaying an overview of the full alignment, with an interactive box
51 * representing the viewport onto the alignment.
56 public class OverviewPanel extends JPanel
57 implements Runnable, ViewportListenerI
59 private OverviewDimensions od;
61 private OverviewCanvas oviewCanvas;
63 private AlignViewport av;
65 private AlignmentPanel ap;
67 private JCheckBoxMenuItem displayToggle;
69 private boolean showHidden = true;
71 private boolean draggingBox = false;
73 private ProgressPanel progressPanel;
76 * Creates a new OverviewPanel object.
79 * The alignment panel which is shown in the overview panel
81 public OverviewPanel(AlignmentPanel alPanel)
86 showHidden = Cache.getDefault(Preferences.SHOW_OV_HIDDEN_AT_START,
90 od = new OverviewDimensionsShowHidden(av.getRanges(),
91 (av.isShowAnnotation()
92 && av.getAlignmentConservationAnnotation() != null));
96 od = new OverviewDimensionsHideHidden(av.getRanges(),
97 (av.isShowAnnotation()
98 && av.getAlignmentConservationAnnotation() != null));
101 setLayout(new BorderLayout());
102 progressPanel = new ProgressPanel(OverviewRenderer.UPDATE,
103 MessageManager.getString("label.oview_calc"), getWidth());
104 this.add(progressPanel, BorderLayout.SOUTH);
105 oviewCanvas = new OverviewCanvas(od, av, progressPanel);
107 add(oviewCanvas, BorderLayout.CENTER);
109 av.getRanges().addPropertyChangeListener(this);
111 // without this the overview window does not size to fit the overview canvas
112 setPreferredSize(new Dimension(od.getWidth(), od.getHeight()));
114 addComponentListener(new ComponentAdapter()
117 public void componentResized(ComponentEvent evt)
119 // Resize is called on the initial display of the overview.
120 // This code adjusts sizes to account for the progress bar if it has not
121 // already been accounted for, which triggers another resize call for
122 // the correct sizing, at which point the overview image is updated.
123 // (This avoids a double recalculation of the image.)
124 if (getWidth() == od.getWidth() && getHeight() == od.getHeight()
125 + progressPanel.getHeight())
127 updateOverviewImage();
131 if ((getWidth() > 0) && (getHeight() > 0))
133 od.setWidth(getWidth());
134 od.setHeight(getHeight() - progressPanel.getHeight());
137 setPreferredSize(new Dimension(od.getWidth(),
138 od.getHeight() + progressPanel.getHeight()));
144 addMouseMotionListener(new MouseMotionAdapter()
147 public void mouseDragged(MouseEvent evt)
149 if (!SwingUtilities.isRightMouseButton(evt))
153 // set the mouse position as a fixed point in the box
154 // and drag relative to that position
155 od.adjustViewportFromMouse(evt.getX(), evt.getY(),
156 av.getAlignment().getHiddenSequences(),
157 av.getAlignment().getHiddenColumns());
161 od.updateViewportFromMouse(evt.getX(), evt.getY(),
162 av.getAlignment().getHiddenSequences(),
163 av.getAlignment().getHiddenColumns());
169 public void mouseMoved(MouseEvent evt)
171 if (od.isPositionInBox(evt.getX(), evt.getY()))
173 // display drag cursor at mouse position
174 setCursor(Cursor.getPredefinedCursor(Cursor.MOVE_CURSOR));
179 setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
184 addMouseListener(new MouseAdapter()
187 public void mousePressed(MouseEvent evt)
189 if (SwingUtilities.isRightMouseButton(evt))
191 if (!Platform.isAMac())
198 if (!od.isPositionInBox(evt.getX(), evt.getY()))
200 // don't do anything if the mouse press is in the overview's box
201 // (wait to see if it's a drag instead)
202 // otherwise update the viewport
203 od.updateViewportFromMouse(evt.getX(), evt.getY(),
204 av.getAlignment().getHiddenSequences(),
205 av.getAlignment().getHiddenColumns());
210 od.setDragPoint(evt.getX(), evt.getY(),
211 av.getAlignment().getHiddenSequences(),
212 av.getAlignment().getHiddenColumns());
218 public void mouseReleased(MouseEvent evt)
227 public void mouseClicked(MouseEvent evt)
229 if (SwingUtilities.isRightMouseButton(evt))
238 * Displays the popup menu and acts on user input
240 private void showPopupMenu(MouseEvent e)
242 JPopupMenu popup = new JPopupMenu();
243 ActionListener menuListener = new ActionListener()
246 public void actionPerformed(ActionEvent event)
248 // switch on/off the hidden columns view
249 toggleHiddenColumns();
250 displayToggle.setSelected(showHidden);
253 displayToggle = new JCheckBoxMenuItem(
254 MessageManager.getString("label.togglehidden"));
255 displayToggle.setEnabled(true);
256 displayToggle.setSelected(showHidden);
257 popup.add(displayToggle);
258 displayToggle.addActionListener(menuListener);
259 popup.show(this, e.getX(), e.getY());
263 * Toggle overview display between showing hidden columns and hiding hidden columns
265 private void toggleHiddenColumns()
270 od = new OverviewDimensionsHideHidden(av.getRanges(),
271 (av.isShowAnnotation()
272 && av.getAlignmentConservationAnnotation() != null));
277 od = new OverviewDimensionsShowHidden(av.getRanges(),
278 (av.isShowAnnotation()
279 && av.getAlignmentConservationAnnotation() != null));
281 oviewCanvas.resetOviewDims(od);
282 updateOverviewImage();
287 * Updates the overview image when the related alignment panel is updated
289 public void updateOverviewImage()
291 if (oviewCanvas == null)
294 * panel has been disposed
299 if ((getWidth() > 0) && (getHeight() > 0))
301 od.setWidth(getWidth());
302 od.setHeight(getHeight() - progressPanel.getHeight());
305 setPreferredSize(new Dimension(od.getWidth(),
306 od.getHeight() + progressPanel.getHeight()));
308 if (oviewCanvas.restartDraw())
313 Thread thread = new Thread(this);
323 if (oviewCanvas != null)
325 oviewCanvas.draw(av.isShowSequenceFeatures(),
326 (av.isShowAnnotation()
327 && av.getAlignmentConservationAnnotation() != null),
328 ap.getSeqPanel().seqCanvas.getFeatureRenderer());
334 * Update the overview panel box when the associated alignment panel is
338 private void setBoxPosition()
342 od.setBoxPosition(av.getAlignment().getHiddenSequences(),
343 av.getAlignment().getHiddenColumns());
349 public void propertyChange(PropertyChangeEvent evt)
355 * Removes this object as a property change listener, and nulls references
357 protected void dispose()
361 av.getRanges().removePropertyChangeListener(this);
362 oviewCanvas.dispose();
365 progressPanel = null;