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.util.MessageManager;
24 import jalview.util.Platform;
25 import jalview.viewmodel.OverviewDimensions;
26 import jalview.viewmodel.OverviewDimensionsHideHidden;
27 import jalview.viewmodel.OverviewDimensionsShowHidden;
28 import jalview.viewmodel.ViewportListenerI;
30 import java.awt.BorderLayout;
31 import java.awt.Cursor;
32 import java.awt.Dimension;
33 import java.awt.event.ActionEvent;
34 import java.awt.event.ActionListener;
35 import java.awt.event.ComponentAdapter;
36 import java.awt.event.ComponentEvent;
37 import java.awt.event.MouseAdapter;
38 import java.awt.event.MouseEvent;
39 import java.awt.event.MouseMotionAdapter;
40 import java.beans.PropertyChangeEvent;
42 import javax.swing.JCheckBoxMenuItem;
43 import javax.swing.JPanel;
44 import javax.swing.JPopupMenu;
45 import javax.swing.SwingUtilities;
48 * Panel displaying an overview of the full alignment, with an interactive box
49 * representing the viewport onto the alignment.
54 public class OverviewPanel extends JPanel
55 implements Runnable, ViewportListenerI
57 private OverviewDimensions od;
59 private OverviewCanvas oviewCanvas;
61 private AlignViewport av;
63 private AlignmentPanel ap;
65 private JCheckBoxMenuItem displayToggle;
67 private boolean showHidden = true;
69 private boolean draggingBox = false;
72 * Creates a new OverviewPanel object.
75 * The alignment panel which is shown in the overview panel
77 public OverviewPanel(AlignmentPanel alPanel)
82 od = new OverviewDimensionsShowHidden(av.getRanges(),
83 (av.isShowAnnotation()
84 && av.getAlignmentConservationAnnotation() != null));
86 setSize(od.getWidth(), od.getHeight());
88 oviewCanvas = new OverviewCanvas(od, av);
89 setLayout(new BorderLayout());
90 add(oviewCanvas, BorderLayout.CENTER);
92 av.getRanges().addPropertyChangeListener(this);
94 addComponentListener(new ComponentAdapter()
97 public void componentResized(ComponentEvent evt)
99 if ((getWidth() != od.getWidth())
100 || (getHeight() != (od.getHeight())))
102 updateOverviewImage();
108 addMouseMotionListener(new MouseMotionAdapter()
111 public void mouseDragged(MouseEvent evt)
113 if (!SwingUtilities.isRightMouseButton(evt))
117 // set the mouse position as a fixed point in the box
118 // and drag relative to that position
119 od.adjustViewportFromMouse(evt.getX(), evt.getY(),
120 av.getAlignment().getHiddenSequences(),
121 av.getAlignment().getHiddenColumns());
125 od.updateViewportFromMouse(evt.getX(), evt.getY(),
126 av.getAlignment().getHiddenSequences(),
127 av.getAlignment().getHiddenColumns());
133 public void mouseMoved(MouseEvent evt)
135 if (od.isPositionInBox(evt.getX(), evt.getY()))
137 // display drag cursor at mouse position
138 setCursor(Cursor.getPredefinedCursor(Cursor.MOVE_CURSOR));
143 setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR));
148 addMouseListener(new MouseAdapter()
151 public void mousePressed(MouseEvent evt)
153 if (SwingUtilities.isRightMouseButton(evt))
155 if (!Platform.isAMac())
161 // if (!av.getWrapAlignment())
163 if (!od.isPositionInBox(evt.getX(), evt.getY()))
165 // don't do anything if the mouse press is in the overview's box
166 // (wait to see if it's a drag instead)
167 // otherwise update the viewport
168 od.updateViewportFromMouse(evt.getX(), evt.getY(),
169 av.getAlignment().getHiddenSequences(),
170 av.getAlignment().getHiddenColumns());
175 od.setDragPoint(evt.getX(), evt.getY(),
176 av.getAlignment().getHiddenSequences(),
177 av.getAlignment().getHiddenColumns());
183 public void mouseReleased(MouseEvent evt)
192 public void mouseClicked(MouseEvent evt)
194 if (SwingUtilities.isRightMouseButton(evt))
201 updateOverviewImage();
205 * Displays the popup menu and acts on user input
207 private void showPopupMenu(MouseEvent e)
209 JPopupMenu popup = new JPopupMenu();
210 ActionListener menuListener = new ActionListener()
213 public void actionPerformed(ActionEvent event)
215 // switch on/off the hidden columns view
216 toggleHiddenColumns();
217 displayToggle.setSelected(showHidden);
220 displayToggle = new JCheckBoxMenuItem(
221 MessageManager.getString("label.togglehidden"));
222 displayToggle.setEnabled(true);
223 displayToggle.setSelected(showHidden);
224 popup.add(displayToggle);
225 displayToggle.addActionListener(menuListener);
226 popup.show(this, e.getX(), e.getY());
230 * Toggle overview display between showing hidden columns and hiding hidden columns
232 private void toggleHiddenColumns()
237 od = new OverviewDimensionsHideHidden(av.getRanges(),
238 (av.isShowAnnotation()
239 && av.getAlignmentConservationAnnotation() != null));
244 od = new OverviewDimensionsShowHidden(av.getRanges(),
245 (av.isShowAnnotation()
246 && av.getAlignmentConservationAnnotation() != null));
248 oviewCanvas.resetOviewDims(od);
249 updateOverviewImage();
254 * Updates the overview image when the related alignment panel is updated
256 public void updateOverviewImage()
258 if (oviewCanvas == null)
261 * panel has been disposed
266 if ((getWidth() > 0) && (getHeight() > 0))
268 od.setWidth(getWidth());
269 od.setHeight(getHeight());
272 setPreferredSize(new Dimension(od.getWidth(), od.getHeight()));
274 if (oviewCanvas.restartDraw())
279 Thread thread = new Thread(this);
287 oviewCanvas.draw(av.isShowSequenceFeatures(),
288 (av.isShowAnnotation()
289 && av.getAlignmentConservationAnnotation() != null),
290 ap.getSeqPanel().seqCanvas.getFeatureRenderer());
295 * Update the overview panel box when the associated alignment panel is
299 private void setBoxPosition()
301 od.setBoxPosition(av.getAlignment().getHiddenSequences(),
302 av.getAlignment().getHiddenColumns());
307 public void propertyChange(PropertyChangeEvent evt)
313 * Removes this object as a property change listener, and nulls references
315 protected void dispose()
319 av.getRanges().removePropertyChangeListener(this);