2 * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)
3 * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle
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 of the License, or (at your option) any later version.
11 * Jalview is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty
13 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
14 * PURPOSE. See the GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along with Jalview. If not, see <http://www.gnu.org/licenses/>.
21 import java.awt.event.*;
22 import java.awt.image.*;
23 import java.util.Hashtable;
27 import jalview.analysis.AAFrequency;
28 import jalview.analysis.StructureFrequency;
29 import jalview.datamodel.*;
30 import jalview.renderer.AnnotationRenderer;
31 import jalview.renderer.AwtRenderPanelI;
39 public class AnnotationPanel extends JPanel implements AwtRenderPanelI,
40 MouseListener, MouseMotionListener, ActionListener,
43 final String HELIX = "Helix";
45 final String SHEET = "Sheet";
48 * For RNA secondary structure "stems" aka helices
50 final String STEM = "RNA Helix";
52 final String LABEL = "Label";
54 final String REMOVE = "Remove Annotation";
56 final String COLOUR = "Colour";
58 public final Color HELIX_COLOUR = Color.red.darker();
60 public final Color SHEET_COLOUR = Color.green.darker().darker();
62 public final Color STEM_COLOUR = Color.blue.darker();
65 public AlignViewport av;
69 public int activeRow = -1;
71 public BufferedImage image;
73 public BufferedImage fadedImage;
77 public FontMetrics fm;
79 public int imgWidth = 0;
81 boolean fastPaint = false;
83 // Used For mouse Dragging and resizing graphs
84 int graphStretch = -1;
86 int graphStretchY = -1;
88 int min; // used by mouseDragged to see if user
90 int max; // used by mouseDragged to see if user
92 boolean mouseDragging = false;
101 public final AnnotationRenderer renderer;
104 * Creates a new AnnotationPanel object.
109 public AnnotationPanel(AlignmentPanel ap)
112 MAC = new jalview.util.Platform().isAMac();
114 ToolTipManager.sharedInstance().registerComponent(this);
115 ToolTipManager.sharedInstance().setInitialDelay(0);
116 ToolTipManager.sharedInstance().setDismissDelay(10000);
119 this.setLayout(null);
120 addMouseListener(this);
121 addMouseMotionListener(this);
122 ap.annotationScroller.getVerticalScrollBar()
123 .addAdjustmentListener(this);
124 renderer = new AnnotationRenderer();
127 public AnnotationPanel(AlignViewport av)
130 renderer = new AnnotationRenderer();
139 public void adjustmentValueChanged(AdjustmentEvent evt)
141 ap.alabels.setScrollOffset(-evt.getValue());
145 * Calculates the height of the annotation displayed in the annotation panel.
146 * Callers should normally call the ap.adjustAnnotationHeight method to ensure
147 * all annotation associated components are updated correctly.
150 public int adjustPanelHeight()
152 int height = calcPanelHeight();
153 this.setPreferredSize(new Dimension(1, height));
156 // revalidate only when the alignment panel is fully constructed
164 * calculate the height for visible annotation, revalidating bounds where
165 * necessary ABSTRACT GUI METHOD
167 * @return total height of annotation
169 public int calcPanelHeight()
171 // setHeight of panels
172 AlignmentAnnotation[] aa = av.alignment.getAlignmentAnnotation();
177 for (int i = 0; i < aa.length; i++)
181 System.err.println("Null annotation row: ignoring.");
193 aa[i].height += av.charHeight;
203 aa[i].height += aa[i].graphHeight;
206 if (aa[i].height == 0)
211 height += aa[i].height;
228 public void actionPerformed(ActionEvent evt)
230 AlignmentAnnotation[] aa = av.alignment.getAlignmentAnnotation();
235 Annotation[] anot = aa[activeRow].annotations;
237 if (anot.length < av.getColumnSelection().getMax())
239 Annotation[] temp = new Annotation[av.getColumnSelection().getMax() + 2];
240 System.arraycopy(anot, 0, temp, 0, anot.length);
242 aa[activeRow].annotations = anot;
245 if (evt.getActionCommand().equals(REMOVE))
247 for (int i = 0; i < av.getColumnSelection().size(); i++)
249 anot[av.getColumnSelection().columnAt(i)] = null;
252 else if (evt.getActionCommand().equals(LABEL))
254 String exMesg = collectAnnotVals(anot, av.getColumnSelection(), LABEL);
255 String label = JOptionPane.showInputDialog(this, "Enter label",
263 if ((label.length() > 0) && !aa[activeRow].hasText)
265 aa[activeRow].hasText = true;
268 for (int i = 0; i < av.getColumnSelection().size(); i++)
270 int index = av.getColumnSelection().columnAt(i);
272 if (!av.colSel.isVisible(index))
275 if (anot[index] == null)
277 anot[index] = new Annotation(label, "", ' ', 0); // TODO: verify that
284 anot[index].displayCharacter = label;
288 else if (evt.getActionCommand().equals(COLOUR))
290 Color col = JColorChooser.showDialog(this,
291 "Choose foreground colour", Color.black);
293 for (int i = 0; i < av.getColumnSelection().size(); i++)
295 int index = av.getColumnSelection().columnAt(i);
297 if (!av.colSel.isVisible(index))
300 if (anot[index] == null)
302 anot[index] = new Annotation("", "", ' ', 0);
305 anot[index].colour = col;
312 String symbol = "\u03B1";
314 if (evt.getActionCommand().equals(HELIX))
318 else if (evt.getActionCommand().equals(SHEET))
324 // Added by LML to color stems
325 else if (evt.getActionCommand().equals(STEM))
331 if (!aa[activeRow].hasIcons)
333 aa[activeRow].hasIcons = true;
336 String label = JOptionPane.showInputDialog(
337 "Enter a label for the structure?", symbol);
344 if ((label.length() > 0) && !aa[activeRow].hasText)
346 aa[activeRow].hasText = true;
349 for (int i = 0; i < av.getColumnSelection().size(); i++)
351 int index = av.getColumnSelection().columnAt(i);
353 if (!av.colSel.isVisible(index))
356 if (anot[index] == null)
358 anot[index] = new Annotation(label, "", type, 0);
361 anot[index].secondaryStructure = type;
362 anot[index].displayCharacter = label;
372 private String collectAnnotVals(Annotation[] anot,
373 ColumnSelection columnSelection, String label2)
375 String collatedInput = "";
377 for (int i = 0; i < columnSelection.size(); i++)
379 int index = columnSelection.columnAt(i);
380 // always check for current display state - just in case
381 if (!av.colSel.isVisible(index))
383 String tlabel = null;
384 if (anot[index] != null)
385 { // LML added stem code
386 if (label2.equals(HELIX) || label2.equals(SHEET)
387 || label2.equals(STEM) || label2.equals(LABEL))
389 tlabel = anot[index].description;
390 if (tlabel == null || tlabel.length() < 1)
392 if (label2.equals(HELIX) || label2.equals(SHEET)
393 || label2.equals(STEM))
395 tlabel = "" + anot[index].secondaryStructure;
399 tlabel = "" + anot[index].displayCharacter;
403 if (tlabel != null && !tlabel.equals(last))
405 if (last.length() > 0)
407 collatedInput += " ";
409 collatedInput += tlabel;
413 return collatedInput;
422 public void mousePressed(MouseEvent evt)
425 AlignmentAnnotation[] aa = av.alignment.getAlignmentAnnotation();
434 for (int i = 0; i < aa.length; i++)
438 height += aa[i].height;
441 if (evt.getY() < height)
447 else if (aa[i].graph > 0)
451 graphStretchY = evt.getY();
458 if (SwingUtilities.isRightMouseButton(evt) && activeRow != -1)
460 if (av.getColumnSelection() == null)
465 JPopupMenu pop = new JPopupMenu("Structure type");
468 * Just display the needed structure options
470 if (av.alignment.isNucleotide() == true)
472 item = new JMenuItem(STEM);
473 item.addActionListener(this);
478 item = new JMenuItem(HELIX);
479 item.addActionListener(this);
481 item = new JMenuItem(SHEET);
482 item.addActionListener(this);
485 item = new JMenuItem(LABEL);
486 item.addActionListener(this);
488 item = new JMenuItem(COLOUR);
489 item.addActionListener(this);
491 item = new JMenuItem(REMOVE);
492 item.addActionListener(this);
494 pop.show(this, evt.getX(), evt.getY());
504 ap.scalePanel.mousePressed(evt);
514 public void mouseReleased(MouseEvent evt)
518 mouseDragging = false;
519 ap.scalePanel.mouseReleased(evt);
528 public void mouseEntered(MouseEvent evt)
530 ap.scalePanel.mouseEntered(evt);
539 public void mouseExited(MouseEvent evt)
541 ap.scalePanel.mouseExited(evt);
550 public void mouseDragged(MouseEvent evt)
552 if (graphStretch > -1)
554 av.alignment.getAlignmentAnnotation()[graphStretch].graphHeight += graphStretchY
556 if (av.alignment.getAlignmentAnnotation()[graphStretch].graphHeight < 0)
558 av.alignment.getAlignmentAnnotation()[graphStretch].graphHeight = 0;
560 graphStretchY = evt.getY();
562 ap.paintAlignment(true);
566 ap.scalePanel.mouseDragged(evt);
576 public void mouseMoved(MouseEvent evt)
578 AlignmentAnnotation[] aa = av.alignment.getAlignmentAnnotation();
582 this.setToolTipText(null);
589 for (int i = 0; i < aa.length; i++)
593 height += aa[i].height;
596 if (evt.getY() < height)
606 this.setToolTipText(null);
610 int res = (evt.getX() / av.getCharWidth()) + av.getStartRes();
612 if (av.hasHiddenColumns)
614 res = av.getColumnSelection().adjustForHiddenColumns(res);
617 if (row > -1 && aa[row].annotations != null
618 && res < (int) aa[row].annotations.length)
620 if (aa[row].graphGroup > -1)
622 StringBuffer tip = new StringBuffer("<html>");
623 for (int gg = 0; gg < aa.length; gg++)
625 if (aa[gg].graphGroup == aa[row].graphGroup
626 && aa[gg].annotations[res] != null)
628 tip.append(aa[gg].label + " "
629 + aa[gg].annotations[res].description + "<br>");
632 if (tip.length() != 6)
634 tip.setLength(tip.length() - 4);
635 this.setToolTipText(tip.toString() + "</html>");
638 else if (aa[row].annotations[res] != null
639 && aa[row].annotations[res].description != null
640 && aa[row].annotations[res].description.length() > 0)
642 this.setToolTipText(aa[row].annotations[res].description);
646 // clear the tooltip.
647 this.setToolTipText(null);
650 if (aa[row].annotations[res] != null)
652 StringBuffer text = new StringBuffer("Sequence position "
655 if (aa[row].annotations[res].description != null)
657 text.append(" " + aa[row].annotations[res].description);
660 ap.alignFrame.statusBar.setText(text.toString());
665 this.setToolTipText(null);
675 public void mouseClicked(MouseEvent evt)
679 AlignmentAnnotation[] aa = av.alignment.getAlignmentAnnotation();
680 AlignmentAnnotation anot = aa[activeRow];
682 if (anot.description.equals("secondary structure"))
684 // System.out.println(anot.description+" "+anot.getRNAStruc());
689 // TODO mouseClicked-content and drawCursor are quite experimental!
690 public void drawCursor(Graphics graphics, SequenceI seq, int res, int x1,
693 int pady = av.charHeight / 5;
695 graphics.setColor(Color.black);
696 graphics.fillRect(x1, y1, av.charWidth, av.charHeight);
698 if (av.validCharWidth)
700 graphics.setColor(Color.white);
702 char s = seq.getCharAt(res);
704 charOffset = (av.charWidth - fm.charWidth(s)) / 2;
705 graphics.drawString(String.valueOf(s), charOffset + x1,
706 (y1 + av.charHeight) - pady);
717 public void paintComponent(Graphics g)
719 g.setColor(Color.white);
720 g.fillRect(0, 0, getWidth(), getHeight());
724 if (fastPaint || (getVisibleRect().width != g.getClipBounds().width)
725 || (getVisibleRect().height != g.getClipBounds().height))
727 g.drawImage(image, 0, 0, this);
732 imgWidth = (av.endRes - av.startRes + 1) * av.charWidth;
735 if (image == null || imgWidth != image.getWidth()
736 || image.getHeight(this) != getHeight())
738 image = new BufferedImage(imgWidth, ap.annotationPanel.getHeight(),
739 BufferedImage.TYPE_INT_RGB);
740 gg = (Graphics2D) image.getGraphics();
744 gg.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
745 RenderingHints.VALUE_ANTIALIAS_ON);
748 gg.setFont(av.getFont());
749 fm = gg.getFontMetrics();
750 gg.setColor(Color.white);
751 gg.fillRect(0, 0, imgWidth, image.getHeight());
754 drawComponent(gg, av.startRes, av.endRes + 1);
755 g.drawImage(image, 0, 0, this);
759 * non-Thread safe repaint
762 * repaint with horizontal shift in alignment
764 public void fastPaint(int horizontal)
767 if ((horizontal == 0) || gg == null
768 || av.alignment.getAlignmentAnnotation() == null
769 || av.alignment.getAlignmentAnnotation().length < 1
770 || av.updatingConsensus || av.updatingConservation)
775 gg.copyArea(0, 0, imgWidth, getHeight(), -horizontal * av.charWidth, 0);
777 int sr = av.startRes;
778 int er = av.endRes + 1;
781 if (horizontal > 0) // scrollbar pulled right, image to the left
783 transX = (er - sr - horizontal) * av.charWidth;
784 sr = er - horizontal;
786 else if (horizontal < 0)
788 er = sr - horizontal;
791 gg.translate(transX, 0);
793 drawComponent(gg, sr, er);
795 gg.translate(-transX, 0);
812 public void drawComponent(Graphics g, int startRes, int endRes)
814 if (av.updatingConsensus || av.updatingConservation)
820 // We'll keep a record of the old image,
821 // and draw a faded image until the calculation
823 if (fadedImage == null || fadedImage.getWidth() != imgWidth
824 || fadedImage.getHeight() != image.getHeight())
826 fadedImage = new BufferedImage(imgWidth, image.getHeight(),
827 BufferedImage.TYPE_INT_RGB);
829 Graphics2D fadedG = (Graphics2D) fadedImage.getGraphics();
831 fadedG.setColor(Color.white);
832 fadedG.fillRect(0, 0, imgWidth, image.getHeight());
834 fadedG.setComposite(AlphaComposite.getInstance(
835 AlphaComposite.SRC_OVER, .3f));
836 fadedG.drawImage(image, 0, 0, this);
846 g.setColor(Color.white);
847 g.fillRect(0, 0, (endRes - startRes) * av.charWidth, getHeight());
849 g.setFont(av.getFont());
852 fm = g.getFontMetrics();
855 if ((av.alignment.getAlignmentAnnotation() == null)
856 || (av.alignment.getAlignmentAnnotation().length < 1))
858 g.setColor(Color.white);
859 g.fillRect(0, 0, getWidth(), getHeight());
860 g.setColor(Color.black);
861 if (av.validCharWidth)
863 g.drawString("Alignment has no annotations", 20, 15);
868 renderer.drawComponent(this, av, g, activeRow, startRes, endRes);
872 public FontMetrics getFontMetrics()
878 public Image getFadedImage()
884 public int getFadedImageWidth()