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 java.awt.Color;
24 import java.awt.Dimension;
26 import java.awt.Graphics;
27 import java.awt.Graphics2D;
28 import java.awt.Image;
29 import java.awt.RenderingHints;
30 import java.awt.event.InputEvent;
31 import java.awt.event.KeyEvent;
32 import java.awt.event.KeyListener;
33 import java.awt.event.MouseEvent;
34 import java.awt.event.MouseListener;
35 import java.awt.event.MouseMotionListener;
36 import java.awt.event.MouseWheelEvent;
37 import java.awt.event.MouseWheelListener;
38 import java.util.Arrays;
39 import java.util.Iterator;
40 import java.util.List;
42 import javax.swing.JPanel;
43 import javax.swing.ToolTipManager;
45 import jalview.api.RotatableCanvasI;
46 import jalview.datamodel.Point;
47 import jalview.datamodel.SequenceGroup;
48 import jalview.datamodel.SequenceI;
49 import jalview.datamodel.SequencePoint;
50 import jalview.math.RotatableMatrix;
51 import jalview.math.RotatableMatrix.Axis;
52 import jalview.util.ColorUtils;
53 import jalview.util.MessageManager;
54 import jalview.viewmodel.AlignmentViewport;
57 * Models a Panel on which a set of points, and optionally x/y/z axes, can be
58 * drawn, and rotated or zoomed with the mouse
60 public class RotatableCanvas extends JPanel
61 implements MouseListener, MouseMotionListener, KeyListener,
62 RotatableCanvasI, MouseWheelListener
64 private static final float ZOOM_OUT = 0.9f;
66 private static final float ZOOM_IN = 1.1f;
69 * pixels distance within which tooltip shows sequence name
71 private static final int NEARBY = 3;
73 private static final List<String> AXES = Arrays.asList("x", "y", "z");
75 private static final Color AXIS_COLOUR = Color.yellow;
77 private static final int DIMS = 3;
79 boolean drawAxes = true;
92 * the min-max [x, y, z] values of sequence points when the points
93 * were set on the object, or when the view is reset;
94 * x and y ranges are not recomputed as points are rotated, as this
95 * would make scaling (zoom) unstable, but z ranges are (for correct
96 * graduated colour brightness based on z-coordinate)
103 * a scale factor used in drawing; when equal to 1, the points span
104 * half the available width or height (whichever is less); increase this
105 * factor to zoom in, decrease it to zoom out
107 private float scaleFactor;
112 * sequences and their (x, y, z) PCA dimension values
114 List<SequencePoint> sequencePoints;
117 * x, y, z axis end points (PCA dimension values)
119 private Point[] axisEndPoints;
121 // fields for 'select rectangle' (JAL-1124)
127 AlignmentViewport av;
131 private boolean showLabels;
133 private Color bgColour;
135 private boolean applyToAllViews;
142 public RotatableCanvas(AlignmentPanel panel)
146 setAxisEndPoints(new Point[DIMS]);
147 setShowLabels(false);
148 setApplyToAllViews(false);
149 setBgColour(Color.BLACK);
152 ToolTipManager.sharedInstance().registerComponent(this);
154 addMouseListener(this);
155 addMouseMotionListener(this);
156 addMouseWheelListener(this);
160 * Refreshes the display with labels shown (or not)
164 public void showLabels(boolean show)
171 public void setPoints(List<SequencePoint> points, int np)
173 this.sequencePoints = points;
175 prefSize = getPreferredSize();
183 * Resets axes to the initial state: x-axis to the right, y-axis up, z-axis to
184 * back (so obscured in a 2-D display)
186 protected void resetAxes()
188 getAxisEndPoints()[0] = new Point(1f, 0f, 0f);
189 getAxisEndPoints()[1] = new Point(0f, 1f, 0f);
190 getAxisEndPoints()[2] = new Point(0f, 0f, 1f);
194 * Computes and saves the min-max ranges of x/y/z positions of the sequence
197 protected void findWidths()
199 float[] max = new float[DIMS];
200 float[] min = new float[DIMS];
202 max[0] = -Float.MAX_VALUE;
203 max[1] = -Float.MAX_VALUE;
204 max[2] = -Float.MAX_VALUE;
206 min[0] = Float.MAX_VALUE;
207 min[1] = Float.MAX_VALUE;
208 min[2] = Float.MAX_VALUE;
210 for (SequencePoint sp : sequencePoints)
212 max[0] = Math.max(max[0], sp.coord.x);
213 max[1] = Math.max(max[1], sp.coord.y);
214 max[2] = Math.max(max[2], sp.coord.z);
215 min[0] = Math.min(min[0], sp.coord.x);
216 min[1] = Math.min(min[1], sp.coord.y);
217 min[2] = Math.min(min[2], sp.coord.z);
225 * Answers the preferred size if it has been set, else 400 x 400
230 public Dimension getPreferredSize()
232 if (prefSize != null)
238 return new Dimension(400, 400);
243 * Answers the preferred size
246 * @see RotatableCanvas#getPreferredSize()
249 public Dimension getMinimumSize()
251 return getPreferredSize();
260 public void paintComponent(Graphics g1)
263 Graphics2D g = (Graphics2D) g1;
265 g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
266 RenderingHints.VALUE_ANTIALIAS_ON);
267 if (sequencePoints == null)
269 g.setFont(new Font("Verdana", Font.PLAIN, 18));
271 MessageManager.getString("label.calculating_pca") + "....",
272 20, getHeight() / 2);
277 * create the image at the beginning or after a resize
279 boolean resized = prefSize.width != getWidth()
280 || prefSize.height != getHeight();
281 if (img == null || resized)
283 prefSize.width = getWidth();
284 prefSize.height = getHeight();
286 img = createImage(getWidth(), getHeight());
287 ig = img.getGraphics();
298 g.drawImage(img, 0, 0, this);
303 * Resets the rotation and choice of axes to the initial state (without change
306 public void resetView()
315 * Draws lines for the x, y, z axes
319 public void drawAxes(Graphics g)
321 g.setColor(AXIS_COLOUR);
323 int midX = getWidth() / 2;
324 int midY = getHeight() / 2;
325 // float maxWidth = Math.max(Math.abs(seqMax[0] - seqMin[0]),
326 // Math.abs(seqMax[1] - seqMin[1]));
327 int pix = Math.min(getWidth(), getHeight());
328 float scaleBy = pix * getScaleFactor() / (2f);
330 for (int i = 0; i < DIMS; i++)
332 g.drawLine(midX, midY,
333 midX + (int) (getAxisEndPoints()[i].x * scaleBy * 0.25),
334 midY + (int) (getAxisEndPoints()[i].y * scaleBy * 0.25));
339 * Fills the background with the currently configured background colour
343 public void drawBackground(Graphics g)
345 g.setColor(getBgColour());
346 g.fillRect(0, 0, prefSize.width, prefSize.height);
350 * Draws points (6x6 squares) for the sequences of the PCA, and labels
351 * (sequence names) if configured to do so. The sequence points colours are
352 * taken from the sequence ids in the alignment (converting black to white).
353 * Sequences 'at the back' (z-coordinate is negative) are shaded slightly
354 * darker to help give a 3-D sensation.
358 public void drawScene(Graphics g1)
360 Graphics2D g = (Graphics2D) g1;
362 g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
363 RenderingHints.VALUE_ANTIALIAS_ON);
364 int pix = Math.min(getWidth(), getHeight());
365 float xWidth = Math.abs(seqMax[0] - seqMin[0]);
366 float yWidth = Math.abs(seqMax[1] - seqMin[1]);
367 float maxWidth = Math.max(xWidth, yWidth);
368 float scaleBy = pix * getScaleFactor() / (2f * maxWidth);
370 float[] centre = getCentre();
372 for (int i = 0; i < npoint; i++)
375 * sequence point colour as sequence id, but
376 * gray if sequence is currently selected
378 SequencePoint sp = sequencePoints.get(i);
379 Color sequenceColour = getSequencePointColour(sp);
380 g.setColor(sequenceColour);
382 int halfwidth = getWidth() / 2;
383 int halfheight = getHeight() / 2;
384 int x = (int) ((sp.coord.x - centre[0]) * scaleBy) + halfwidth;
385 int y = (int) ((sp.coord.y - centre[1]) * scaleBy) + halfheight;
386 g.fillRect(x - 3, y - 3, 6, 6);
390 g.setColor(Color.red);
391 g.drawString(sp.getSequence().getName(), x - 3, y - 4);
396 g.setColor(AXIS_COLOUR);
397 int midX = getWidth() / 2;
398 int midY = getHeight() / 2;
399 Iterator<String> axes = AXES.iterator();
400 for (Point p : getAxisEndPoints())
402 int x = midX + (int) (p.x * scaleBy * seqMax[0]);
403 int y = midY + (int) (p.y * scaleBy * seqMax[1]);
404 g.drawString(axes.next(), x - 3, y - 4);
407 // //Now the rectangle
408 // if (rectx2 != -1 && recty2 != -1) {
409 // g.setColor(Color.white);
411 // g.drawRect(rectx1,recty1,rectx2-rectx1,recty2-recty1);
416 * Determines the colour to use when drawing a sequence point. The colour is
417 * taken from the sequence id, with black converted to white, and then
418 * graduated from darker (at the back) to brighter (at the front) based on the
419 * z-axis coordinate of the point.
424 protected Color getSequencePointColour(SequencePoint sp)
426 SequenceI sequence = sp.getSequence();
427 Color sequenceColour = av.getSequenceColour(sequence);
428 if (sequenceColour == Color.black)
430 sequenceColour = Color.white;
432 if (av.getSelectionGroup() != null)
434 if (av.getSelectionGroup().getSequences(null).contains(sequence))
436 sequenceColour = Color.gray;
441 * graduate brighter for point in front of centre, darker if behind centre
443 float zCentre = (seqMin[2] + seqMax[2]) / 2f;
444 if (sp.coord.z > zCentre)
446 sequenceColour = ColorUtils.getGraduatedColour(sp.coord.z, 0,
447 sequenceColour, seqMax[2], sequenceColour.brighter());
449 else if (sp.coord.z < zCentre)
451 sequenceColour = ColorUtils.getGraduatedColour(sp.coord.z, seqMin[2],
452 sequenceColour.darker(), 0, sequenceColour);
455 return sequenceColour;
459 public void keyTyped(KeyEvent evt)
464 public void keyReleased(KeyEvent evt)
469 * Responds to up or down arrow key by zooming in or out, respectively
474 public void keyPressed(KeyEvent evt)
476 int keyCode = evt.getKeyCode();
477 boolean shiftDown = evt.isShiftDown();
479 if (keyCode == KeyEvent.VK_UP)
490 else if (keyCode == KeyEvent.VK_DOWN)
501 else if (shiftDown && keyCode == KeyEvent.VK_LEFT)
505 else if (shiftDown && keyCode == KeyEvent.VK_RIGHT)
509 else if (evt.getKeyChar() == 's')
511 // Cache.warn("DEBUG: Rectangle selection");
512 // todo not yet enabled as rectx2, recty2 are always -1
513 // need to set them in mouseDragged; JAL-1124
514 // if ((rectx2 != -1) && (recty2 != -1))
516 // rectSelect(rectx1, recty1, rectx2, recty2);
524 public void zoom(float factor)
528 setScaleFactor(getScaleFactor() * factor);
533 public void mouseClicked(MouseEvent evt)
538 public void mouseEntered(MouseEvent evt)
543 public void mouseExited(MouseEvent evt)
548 public void mouseReleased(MouseEvent evt)
553 * If the mouse press is at (within 2 pixels of) a sequence point, toggles
554 * (adds or removes) the corresponding sequence as a member of the viewport
555 * selection group. This supports configuring a group in the alignment by
556 * clicking on points in the PCA display.
559 public void mousePressed(MouseEvent evt)
572 SequenceI found = findSequenceAtPoint(x, y);
576 AlignmentPanel[] aps = getAssociatedPanels();
578 for (int a = 0; a < aps.length; a++)
580 if (aps[a].av.getSelectionGroup() != null)
582 aps[a].av.getSelectionGroup().addOrRemove(found, true);
586 aps[a].av.setSelectionGroup(new SequenceGroup());
587 aps[a].av.getSelectionGroup().addOrRemove(found, true);
588 aps[a].av.getSelectionGroup()
589 .setEndRes(aps[a].av.getAlignment().getWidth() - 1);
592 PaintRefresher.Refresh(this, av.getSequenceSetId());
593 // canonical selection is sent to other listeners
601 * Sets the tooltip to the name of the sequence within 2 pixels of the mouse
602 * position, or clears the tooltip if none found
605 public void mouseMoved(MouseEvent evt)
607 SequenceI found = findSequenceAtPoint(evt.getX(), evt.getY());
609 this.setToolTipText(found == null ? null : found.getName());
613 * Action handler for a mouse drag. Rotates the display around the X axis (for
614 * up/down mouse movement) and/or the Y axis (for left/right mouse movement).
619 public void mouseDragged(MouseEvent evt)
621 int xPos = evt.getX();
622 int yPos = evt.getY();
624 if (xPos == mouseX && yPos == mouseY)
629 int xDelta = xPos - mouseX;
630 int yDelta = yPos - mouseY;
632 // Check if this is a rectangle drawing drag
633 if ((evt.getModifiersEx() & InputEvent.BUTTON2_DOWN_MASK) != 0)
635 // rectx2 = evt.getX();
636 // recty2 = evt.getY();
640 rotate(xDelta, yDelta);
652 public void rotate(float x, float y)
654 if (x == 0f && y == 0f)
660 * get the identity transformation...
662 RotatableMatrix rotmat = new RotatableMatrix();
665 * rotate around the X axis for change in Y
666 * (mouse movement up/down); note we are equating a
667 * number of pixels with degrees of rotation here!
671 rotmat.rotate(y, Axis.X);
675 * rotate around the Y axis for change in X
676 * (mouse movement left/right)
680 rotmat.rotate(x, Axis.Y);
684 * apply the composite transformation to sequence points;
685 * update z min-max range (affects colour graduation), but not
686 * x or y min-max (as this would affect axis scaling)
688 float[] centre = getCentre();
689 float zMin = Float.MAX_VALUE;
690 float zMax = -Float.MAX_VALUE;
692 for (int i = 0; i < npoint; i++)
694 SequencePoint sp = sequencePoints.get(i);
695 sp.translate(-centre[0], -centre[1], -centre[2]);
697 // Now apply the rotation matrix
698 sp.coord = rotmat.vectorMultiply(sp.coord);
700 // Now translate back again
701 sp.translate(centre[0], centre[1], centre[2]);
703 zMin = Math.min(zMin, sp.coord.z);
704 zMax = Math.max(zMax, sp.coord.z);
711 * rotate the x/y/z axis positions
713 for (int i = 0; i < DIMS; i++)
715 getAxisEndPoints()[i] = rotmat.vectorMultiply(getAxisEndPoints()[i]);
720 * Answers the x/y/z coordinates that are midway between the maximum and
721 * minimum sequence point values
725 private float[] getCentre()
727 float xCentre = (seqMin[0] + seqMax[0]) / 2f;
728 float yCentre = (seqMin[1] + seqMax[1]) / 2f;
729 float zCentre = (seqMin[2] + seqMax[2]) / 2f;
731 return new float[] { xCentre, yCentre, zCentre };
735 * Adds any sequences whose displayed points are within the given rectangle to
736 * the viewport's current selection. Intended for key 's' after dragging to
737 * select a region of the PCA.
744 protected void rectSelect(int x1, int y1, int x2, int y2)
746 float[] centre = getCentre();
748 for (int i = 0; i < npoint; i++)
750 SequencePoint sp = sequencePoints.get(i);
751 int tmp1 = (int) (((sp.coord.x - centre[0]) * getScaleFactor())
752 + (getWidth() / 2.0));
753 int tmp2 = (int) (((sp.coord.y - centre[1]) * getScaleFactor())
754 + (getHeight() / 2.0));
756 if ((tmp1 > x1) && (tmp1 < x2) && (tmp2 > y1) && (tmp2 < y2))
760 SequenceI sequence = sp.getSequence();
761 if (!av.getSelectionGroup().getSequences(null).contains(sequence))
763 av.getSelectionGroup().addSequence(sequence, true);
771 * Answers the first sequence found whose point on the display is within 2
772 * pixels of the given coordinates, or null if none is found
779 protected SequenceI findSequenceAtPoint(int x, int y)
781 int halfwidth = getWidth() / 2;
782 int halfheight = getHeight() / 2;
785 int pix = Math.min(getWidth(), getHeight());
786 float xWidth = Math.abs(seqMax[0] - seqMin[0]);
787 float yWidth = Math.abs(seqMax[1] - seqMin[1]);
788 float maxWidth = Math.max(xWidth, yWidth);
789 float scaleBy = pix * getScaleFactor() / (2f * maxWidth);
791 float[] centre = getCentre();
793 for (int i = 0; i < npoint; i++)
795 SequencePoint sp = sequencePoints.get(i);
796 int px = (int) ((sp.coord.x - centre[0]) * scaleBy) + halfwidth;
797 int py = (int) ((sp.coord.y - centre[1]) * scaleBy) + halfheight;
799 if ((Math.abs(px - x) < NEARBY) && (Math.abs(py - y) < NEARBY))
808 return sequencePoints.get(found).getSequence();
817 * Answers the panel the PCA is associated with (all panels for this alignment
818 * if 'associate with all panels' is selected).
822 AlignmentPanel[] getAssociatedPanels()
824 if (isApplyToAllViews())
826 return PaintRefresher.getAssociatedPanels(av.getSequenceSetId());
830 return new AlignmentPanel[] { ap };
834 public Color getBackgroundColour()
836 return getBgColour();
840 * Zooms in or out in response to mouse wheel movement
843 public void mouseWheelMoved(MouseWheelEvent e)
845 double wheelRotation = e.getPreciseWheelRotation();
846 if (wheelRotation > 0)
851 else if (wheelRotation < 0)
859 * Answers the sequence point minimum [x, y, z] values. Note these are derived
860 * when sequence points are set, but x and y values are not updated on
861 * rotation (because this would result in changes to scaling).
865 public float[] getSeqMin()
871 * Answers the sequence point maximum [x, y, z] values. Note these are derived
872 * when sequence points are set, but x and y values are not updated on
873 * rotation (because this would result in changes to scaling).
877 public float[] getSeqMax()
883 * Sets the minimum and maximum [x, y, z] positions for sequence points. For
884 * use when restoring a saved PCA from state data.
889 public void setSeqMinMax(float[] min, float[] max)
895 public float getScaleFactor()
900 public void setScaleFactor(float scaleFactor)
902 this.scaleFactor = scaleFactor;
905 public boolean isShowLabels()
910 public void setShowLabels(boolean showLabels)
912 this.showLabels = showLabels;
915 public boolean isApplyToAllViews()
917 return applyToAllViews;
920 public void setApplyToAllViews(boolean applyToAllViews)
922 this.applyToAllViews = applyToAllViews;
925 public Point[] getAxisEndPoints()
927 return axisEndPoints;
930 public void setAxisEndPoints(Point[] axisEndPoints)
932 this.axisEndPoints = axisEndPoints;
935 public Color getBgColour()
940 public void setBgColour(Color bgColour)
942 this.bgColour = bgColour;