2 * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2)
3 * Copyright (C) 2014 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.
24 import java.util.regex.Pattern;
27 import java.awt.datatransfer.*;
28 import java.awt.event.*;
29 import java.awt.geom.AffineTransform;
30 import java.awt.image.*;
33 import jalview.datamodel.*;
35 import jalview.util.MessageManager;
43 public class AnnotationLabels extends JPanel implements MouseListener,
44 MouseMotionListener, ActionListener
46 String TOGGLE_LABELSCALE = MessageManager.getString("label.scale_label_to_column");
48 String ADDNEW = MessageManager.getString("label.add_new_row");
50 String EDITNAME = MessageManager.getString("label.edit_label_description");
52 String HIDE = MessageManager.getString("label.hide_row");
54 String DELETE = MessageManager.getString("label.delete_row");
56 String SHOWALL = MessageManager.getString("label.show_all_hidden_rows");
58 String OUTPUT_TEXT = MessageManager.getString("label.export_annotation");
60 String COPYCONS_SEQ = MessageManager.getString("label.copy_consensus_sequence");
62 boolean resizePanel = false;
70 boolean resizing = false;
80 Font font = new Font("Arial", Font.PLAIN, 11);
82 private boolean hasHiddenRows;
85 * Creates a new AnnotationLabels object.
90 public AnnotationLabels(AlignmentPanel ap)
94 ToolTipManager.sharedInstance().registerComponent(this);
96 java.net.URL url = getClass().getResource("/images/idwidth.gif");
101 temp = java.awt.Toolkit.getDefaultToolkit().createImage(url);
106 MediaTracker mt = new MediaTracker(this);
107 mt.addImage(temp, 0);
109 } catch (Exception ex)
113 BufferedImage bi = new BufferedImage(temp.getHeight(this),
114 temp.getWidth(this), BufferedImage.TYPE_INT_RGB);
115 Graphics2D g = (Graphics2D) bi.getGraphics();
116 g.rotate(Math.toRadians(90));
117 g.drawImage(temp, 0, -bi.getWidth(this), this);
120 addMouseListener(this);
121 addMouseMotionListener(this);
122 addMouseWheelListener(ap.annotationPanel);
125 public AnnotationLabels(AlignViewport av)
136 public void setScrollOffset(int y)
143 * sets selectedRow to -2 if no annotation preset, -1 if no visible row is at
147 * coordinate position to search for a row
149 void getSelectedRow(int y)
152 AlignmentAnnotation[] aa = ap.av.getAlignment()
153 .getAlignmentAnnotation();
157 for (int i = 0; i < aa.length; i++)
165 height += aa[i].height;
183 public void actionPerformed(ActionEvent evt)
185 AlignmentAnnotation[] aa = ap.av.getAlignment()
186 .getAlignmentAnnotation();
188 if (evt.getActionCommand().equals(ADDNEW))
190 AlignmentAnnotation newAnnotation = new AlignmentAnnotation(null,
191 null, new Annotation[ap.av.getAlignment().getWidth()]);
193 if (!editLabelDescription(newAnnotation))
198 ap.av.getAlignment().addAnnotation(newAnnotation);
199 ap.av.getAlignment().setAnnotationIndex(newAnnotation, 0);
201 else if (evt.getActionCommand().equals(EDITNAME))
203 editLabelDescription(aa[selectedRow]);
206 else if (evt.getActionCommand().equals(HIDE))
208 aa[selectedRow].visible = false;
210 else if (evt.getActionCommand().equals(DELETE))
212 ap.av.getAlignment().deleteAnnotation(aa[selectedRow]);
214 else if (evt.getActionCommand().equals(SHOWALL))
216 for (int i = 0; i < aa.length; i++)
218 if (!aa[i].visible && aa[i].annotations != null)
220 aa[i].visible = true;
224 else if (evt.getActionCommand().equals(OUTPUT_TEXT))
226 new AnnotationExporter().exportAnnotations(ap,
227 new AlignmentAnnotation[]
228 { aa[selectedRow] }, null, null);
230 else if (evt.getActionCommand().equals(COPYCONS_SEQ))
232 SequenceI cons = null;
233 if (aa[selectedRow].groupRef != null)
235 cons = aa[selectedRow].groupRef.getConsensusSeq();
239 cons = av.getConsensusSeq();
243 copy_annotseqtoclipboard(cons);
247 else if (evt.getActionCommand().equals(TOGGLE_LABELSCALE))
249 aa[selectedRow].scaleColLabel = !aa[selectedRow].scaleColLabel;
252 ap.validateAnnotationDimensions(false);
256 // ap.paintAlignment(true);
265 boolean editLabelDescription(AlignmentAnnotation annotation)
267 EditNameDialog dialog = new EditNameDialog(annotation.label,
268 annotation.description, " Annotation Name ",
269 "Annotation Description ", "Edit Annotation Name/Description",
277 annotation.label = dialog.getName();
279 String text = dialog.getDescription();
280 if (text != null && text.length() == 0)
284 annotation.description = text;
295 public void mousePressed(MouseEvent evt)
297 getSelectedRow(evt.getY() - scrollOffset);
307 public void mouseReleased(MouseEvent evt)
309 int start = selectedRow;
310 getSelectedRow(evt.getY() - scrollOffset);
311 int end = selectedRow;
315 // Swap these annotations
316 AlignmentAnnotation startAA = ap.av.getAlignment()
317 .getAlignmentAnnotation()[start];
320 end = ap.av.getAlignment().getAlignmentAnnotation().length - 1;
322 AlignmentAnnotation endAA = ap.av.getAlignment()
323 .getAlignmentAnnotation()[end];
325 ap.av.getAlignment().getAlignmentAnnotation()[end] = startAA;
326 ap.av.getAlignment().getAlignmentAnnotation()[start] = endAA;
332 ap.annotationPanel.repaint();
341 public void mouseEntered(MouseEvent evt)
356 public void mouseExited(MouseEvent evt)
358 if (dragEvent == null)
371 public void mouseDragged(MouseEvent evt)
377 Dimension d = ap.annotationScroller.getPreferredSize();
378 int dif = evt.getY() - oldY;
380 dif /= ap.av.charHeight;
381 dif *= ap.av.charHeight;
383 if ((d.height - dif) > 20)
385 ap.annotationScroller.setPreferredSize(new Dimension(d.width,
387 d = ap.annotationSpaceFillerHolder.getPreferredSize();
388 ap.annotationSpaceFillerHolder.setPreferredSize(new Dimension(
389 d.width, d.height - dif));
390 ap.paintAlignment(true);
407 public void mouseMoved(MouseEvent evt)
409 resizePanel = evt.getY() < 10;
411 getSelectedRow(evt.getY() - scrollOffset);
414 && ap.av.getAlignment().getAlignmentAnnotation().length > selectedRow)
416 AlignmentAnnotation aa = ap.av.getAlignment()
417 .getAlignmentAnnotation()[selectedRow];
419 StringBuffer desc = new StringBuffer();
420 if (aa.description != null
421 && !aa.description.equals("New description"))
423 // TODO: we could refactor and merge this code with the code in
424 // jalview.gui.SeqPanel.mouseMoved(..) that formats sequence feature
426 desc.append(aa.getDescription(true).trim());
427 // check to see if the description is an html fragment.
428 if (desc.length() < 6
429 || (desc.substring(0, 6).toLowerCase().indexOf("<html>") < 0))
431 // clean the description ready for embedding in html
432 desc = new StringBuffer(Pattern.compile("<").matcher(desc)
433 .replaceAll("<"));
434 desc.insert(0, "<html>");
438 // remove terminating html if any
439 int i = desc.substring(desc.length() - 7).toLowerCase()
440 .lastIndexOf("</html>");
443 desc.setLength(desc.length() - 7 + i);
448 desc.append("<br/>");
454 // begin the tooltip's html fragment
455 desc.append("<html>");
459 // TODO: limit precision of score to avoid noise from imprecise doubles
460 // (64.7 becomes 64.7+/some tiny value).
461 desc.append(" Score: " + aa.score);
464 if (desc.length() > 6)
466 desc.append("</html>");
467 this.setToolTipText(desc.toString());
470 this.setToolTipText(null);
481 public void mouseClicked(MouseEvent evt)
483 AlignmentAnnotation[] aa = ap.av.getAlignment()
484 .getAlignmentAnnotation();
485 if (SwingUtilities.isLeftMouseButton(evt))
487 if (selectedRow > -1 && selectedRow < aa.length)
489 if (aa[selectedRow].groupRef != null)
491 if (evt.getClickCount() >= 2)
493 // todo: make the ap scroll to the selection - not necessary, first
494 // click highlights/scrolls, second selects
495 ap.seqPanel.ap.idPanel.highlightSearchResults(null);
496 ap.av.setSelectionGroup(// new SequenceGroup(
497 aa[selectedRow].groupRef); // );
498 ap.paintAlignment(false);
499 PaintRefresher.Refresh(ap, ap.av.getSequenceSetId());
500 ap.av.sendSelection();
504 ap.seqPanel.ap.idPanel
505 .highlightSearchResults(aa[selectedRow].groupRef
506 .getSequences(null));
510 else if (aa[selectedRow].sequenceRef != null)
512 if (evt.getClickCount() == 1)
514 ap.seqPanel.ap.idPanel.highlightSearchResults(Arrays
515 .asList(new SequenceI[]
516 { aa[selectedRow].sequenceRef }));
518 else if (evt.getClickCount() >= 2)
520 ap.seqPanel.ap.idPanel.highlightSearchResults(null);
521 SequenceGroup sg = ap.av.getSelectionGroup();
524 // we make a copy rather than edit the current selection if no modifiers pressed
525 // see Enhancement JAL-1557
526 if (!(evt.isControlDown() || evt.isShiftDown()))
528 sg = new SequenceGroup(sg);
530 sg.addSequence(aa[selectedRow].sequenceRef, false);
532 if (evt.isControlDown())
534 sg.addOrRemove(aa[selectedRow].sequenceRef, true);
536 // notionally, we should also add intermediate sequences from last added sequence ?
537 sg.addSequence(aa[selectedRow].sequenceRef, true);
541 sg = new SequenceGroup();
543 sg.setEndRes(ap.av.getAlignment().getWidth()-1);
544 sg.addSequence(aa[selectedRow].sequenceRef, false);
546 ap.av.setSelectionGroup(sg);
547 ap.av.sendSelection();
548 ap.paintAlignment(false);
549 PaintRefresher.Refresh(ap, ap.av.getSequenceSetId());
555 if (!SwingUtilities.isRightMouseButton(evt))
560 JPopupMenu pop = new JPopupMenu(
561 MessageManager.getString("label.annotations"));
562 JMenuItem item = new JMenuItem(ADDNEW);
563 item.addActionListener(this);
568 { // let the user make everything visible again
569 item = new JMenuItem(SHOWALL);
570 item.addActionListener(this);
573 pop.show(this, evt.getX(), evt.getY());
576 item = new JMenuItem(EDITNAME);
577 item.addActionListener(this);
579 item = new JMenuItem(HIDE);
580 item.addActionListener(this);
582 item = new JMenuItem(DELETE);
583 item.addActionListener(this);
587 item = new JMenuItem(SHOWALL);
588 item.addActionListener(this);
591 item = new JMenuItem(OUTPUT_TEXT);
592 item.addActionListener(this);
594 // TODO: annotation object should be typed for autocalculated/derived
596 if (selectedRow < aa.length)
598 if (!aa[selectedRow].autoCalculated)
600 if (aa[selectedRow].graph == AlignmentAnnotation.NO_GRAPH)
602 // display formatting settings for this row.
604 // av and sequencegroup need to implement same interface for
605 item = new JCheckBoxMenuItem(TOGGLE_LABELSCALE,
606 aa[selectedRow].scaleColLabel);
607 item.addActionListener(this);
611 else if (aa[selectedRow].label.indexOf("Consensus") > -1)
614 // av and sequencegroup need to implement same interface for
615 final JCheckBoxMenuItem cbmi = new JCheckBoxMenuItem(
616 "Ignore Gaps In Consensus",
617 (aa[selectedRow].groupRef != null) ? aa[selectedRow].groupRef
618 .getIgnoreGapsConsensus() : ap.av
619 .getIgnoreGapsConsensus());
620 final AlignmentAnnotation aaa = aa[selectedRow];
621 cbmi.addActionListener(new ActionListener()
623 public void actionPerformed(ActionEvent e)
625 if (aaa.groupRef != null)
627 // TODO: pass on reference to ap so the view can be updated.
628 aaa.groupRef.setIgnoreGapsConsensus(cbmi.getState());
629 ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
633 ap.av.setIgnoreGapsConsensus(cbmi.getState(), ap);
638 // av and sequencegroup need to implement same interface for
639 if (aaa.groupRef != null)
641 final JCheckBoxMenuItem chist = new JCheckBoxMenuItem(
642 "Show Group Histogram",
643 aa[selectedRow].groupRef.isShowConsensusHistogram());
644 chist.addActionListener(new ActionListener()
646 public void actionPerformed(ActionEvent e)
648 // TODO: pass on reference
654 aaa.groupRef.setShowConsensusHistogram(chist.getState());
656 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
660 final JCheckBoxMenuItem cprofl = new JCheckBoxMenuItem(
662 aa[selectedRow].groupRef.isShowSequenceLogo());
663 cprofl.addActionListener(new ActionListener()
665 public void actionPerformed(ActionEvent e)
667 // TODO: pass on reference
673 aaa.groupRef.setshowSequenceLogo(cprofl.getState());
675 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
679 final JCheckBoxMenuItem cproflnorm = new JCheckBoxMenuItem(
680 "Normalise Group Logo",
681 aa[selectedRow].groupRef.isNormaliseSequenceLogo());
682 cproflnorm.addActionListener(new ActionListener()
684 public void actionPerformed(ActionEvent e)
687 // TODO: pass on reference
693 aaa.groupRef.setNormaliseSequenceLogo(cproflnorm.getState());
694 // automatically enable logo display if we're clicked
695 aaa.groupRef.setshowSequenceLogo(true);
697 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
704 final JCheckBoxMenuItem chist = new JCheckBoxMenuItem(
705 "Show Histogram", av.isShowConsensusHistogram());
706 chist.addActionListener(new ActionListener()
708 public void actionPerformed(ActionEvent e)
710 // TODO: pass on reference
716 av.setShowConsensusHistogram(chist.getState());
717 ap.alignFrame.setMenusForViewport();
719 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
723 final JCheckBoxMenuItem cprof = new JCheckBoxMenuItem(
724 "Show Logo", av.isShowSequenceLogo());
725 cprof.addActionListener(new ActionListener()
727 public void actionPerformed(ActionEvent e)
729 // TODO: pass on reference
735 av.setShowSequenceLogo(cprof.getState());
736 ap.alignFrame.setMenusForViewport();
738 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
742 final JCheckBoxMenuItem cprofnorm = new JCheckBoxMenuItem(
743 "Normalise Logo", av.isNormaliseSequenceLogo());
744 cprofnorm.addActionListener(new ActionListener()
746 public void actionPerformed(ActionEvent e)
748 // TODO: pass on reference
754 av.setShowSequenceLogo(true);
755 av.setNormaliseSequenceLogo(cprofnorm.getState());
756 ap.alignFrame.setMenusForViewport();
758 // ap.annotationPanel.paint(ap.annotationPanel.getGraphics());
763 final JMenuItem consclipbrd = new JMenuItem(COPYCONS_SEQ);
764 consclipbrd.addActionListener(this);
765 pop.add(consclipbrd);
768 pop.show(this, evt.getX(), evt.getY());
772 * do a single sequence copy to jalview and the system clipboard
775 * sequence to be copied to clipboard
777 protected void copy_annotseqtoclipboard(SequenceI sq)
779 SequenceI[] seqs = new SequenceI[]
781 String[] omitHidden = null;
782 SequenceI[] dseqs = new SequenceI[]
783 { sq.getDatasetSequence() };
784 if (dseqs[0] == null)
786 dseqs[0] = new Sequence(sq);
787 dseqs[0].setSequence(jalview.analysis.AlignSeq.extractGaps(
788 jalview.util.Comparison.GapChars, sq.getSequenceAsString()));
790 sq.setDatasetSequence(dseqs[0]);
792 Alignment ds = new Alignment(dseqs);
793 if (av.hasHiddenColumns())
795 omitHidden = av.getColumnSelection().getVisibleSequenceStrings(0,
796 sq.getLength(), seqs);
799 String output = new FormatAdapter().formatSequences("Fasta", seqs,
802 Toolkit.getDefaultToolkit().getSystemClipboard()
803 .setContents(new StringSelection(output), Desktop.instance);
805 Vector hiddenColumns = null;
806 if (av.hasHiddenColumns())
808 hiddenColumns = new Vector();
809 for (int i = 0; i < av.getColumnSelection().getHiddenColumns().size(); i++)
811 int[] region = (int[]) av.getColumnSelection().getHiddenColumns()
814 hiddenColumns.addElement(new int[]
815 { region[0], region[1] });
819 Desktop.jalviewClipboard = new Object[]
820 { seqs, ds, // what is the dataset of a consensus sequence ? need to flag
821 // sequence as special.
831 public void paintComponent(Graphics g)
834 int width = getWidth();
837 width = ap.calculateIdWidth().width + 4;
840 Graphics2D g2 = (Graphics2D) g;
843 g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
844 RenderingHints.VALUE_ANTIALIAS_ON);
847 drawComponent(g2, true, width);
852 * Draw the full set of annotation Labels for the alignment at the given
856 * Graphics2D instance (needed for font scaling)
858 * Width for scaling labels
861 public void drawComponent(Graphics g, int width)
863 drawComponent(g, false, width);
866 private final boolean debugRedraw = false;
869 * Draw the full set of annotation Labels for the alignment at the given
873 * Graphics2D instance (needed for font scaling)
875 * - true indicates that only current visible area needs to be
878 * Width for scaling labels
880 public void drawComponent(Graphics g, boolean clip, int width)
882 if (av.getFont().getSize() < 10)
888 g.setFont(av.getFont());
891 FontMetrics fm = g.getFontMetrics(g.getFont());
892 g.setColor(Color.white);
893 g.fillRect(0, 0, getWidth(), getHeight());
895 g.translate(0, scrollOffset);
896 g.setColor(Color.black);
898 AlignmentAnnotation[] aa = av.getAlignment().getAlignmentAnnotation();
899 int fontHeight = g.getFont().getSize();
904 Font baseFont = g.getFont();
905 FontMetrics baseMetrics = fm;
906 int ofontH = fontHeight;
909 int[] visr = (ap != null && ap.annotationPanel != null) ? ap.annotationPanel
910 .getVisibleVRange() : null;
911 if (clip && visr != null)
916 boolean visible = true, before = false, after = false;
919 hasHiddenRows = false;
921 for (int i = 0; i < aa.length; i++)
926 hasHiddenRows = true;
939 System.out.println("before vis: " + i);
943 // don't draw what isn't visible
953 System.out.println("Scroll offset: " + sOffset
954 + " after vis: " + i);
958 // don't draw what isn't visible
962 g.setColor(Color.black);
964 offset = -aa[i].height / 2;
968 offset += fm.getHeight() / 2;
969 offset -= fm.getDescent();
972 offset += fm.getDescent();
974 x = width - fm.stringWidth(aa[i].label) - 3;
976 if (aa[i].graphGroup > -1)
979 // TODO: JAL-1291 revise rendering model so the graphGroup map is
980 // computed efficiently for all visible labels
981 for (int gg = 0; gg < aa.length; gg++)
983 if (aa[gg].graphGroup == aa[i].graphGroup)
988 if (groupSize * (fontHeight + 8) < aa[i].height)
990 graphExtras = (aa[i].height - (groupSize * (fontHeight + 8))) / 2;
995 float h = aa[i].height / (float) groupSize, s;
1002 fontHeight = -8 + (int) h;
1003 s = ((float) fontHeight) / (float) ofontH;
1004 Font f = baseFont.deriveFont(AffineTransform
1005 .getScaleInstance(s, s));
1007 fm = g.getFontMetrics();
1008 graphExtras = (aa[i].height - (groupSize * (fontHeight + 8))) / 2;
1013 for (int gg = 0; gg < aa.length; gg++)
1015 if (aa[gg].graphGroup == aa[i].graphGroup)
1017 x = width - fm.stringWidth(aa[gg].label) - 3;
1018 g.drawString(aa[gg].label, x, y - graphExtras);
1020 if (aa[gg]._linecolour != null)
1023 g.setColor(aa[gg]._linecolour);
1024 g.drawLine(x, y - graphExtras + 3,
1025 x + fm.stringWidth(aa[gg].label), y - graphExtras
1029 g.setColor(Color.black);
1030 graphExtras += fontHeight + 8;
1034 g.setFont(baseFont);
1036 fontHeight = ofontH;
1040 g.drawString(aa[i].label, x, y + offset);
1047 g.drawImage(image, 2, 0 - scrollOffset, this);
1049 else if (dragEvent != null && aa != null)
1051 g.setColor(Color.lightGray);
1052 g.drawString(aa[selectedRow].label, dragEvent.getX(),
1053 dragEvent.getY() - scrollOffset);
1056 if (!av.wrapAlignment && ((aa == null) || (aa.length < 1)))
1058 g.drawString(MessageManager.getString("label.right_click"), 2, 8);
1059 g.drawString(MessageManager.getString("label.to_add_annotation"), 2,