src/jalview/gui/AnnotationLabels.java

   1 /*
   2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
   4  *
   5  * This file is part of Jalview.
   6  *
   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.
  11  *
  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.
  16  *
  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.
  20  */
  21 package jalview.gui;
  22
  23 import jalview.analysis.AlignSeq;
  24 import jalview.analysis.AlignmentUtils;
  25 import jalview.datamodel.Alignment;
  26 import jalview.datamodel.AlignmentAnnotation;
  27 import jalview.datamodel.Annotation;
  28 import jalview.datamodel.HiddenColumns;
  29 import jalview.datamodel.Sequence;
  30 import jalview.datamodel.SequenceGroup;
  31 import jalview.datamodel.SequenceI;
  32 import jalview.io.FileFormat;
  33 import jalview.io.FormatAdapter;
  34 import jalview.util.Comparison;
  35 import jalview.util.MessageManager;
  36 import jalview.util.Platform;
  37
  38 import java.awt.Color;
  39 import java.awt.Cursor;
  40 import java.awt.Dimension;
  41 import java.awt.Font;
  42 import java.awt.FontMetrics;
  43 import java.awt.Graphics;
  44 import java.awt.Graphics2D;
  45 import java.awt.RenderingHints;
  46 import java.awt.Toolkit;
  47 import java.awt.datatransfer.StringSelection;
  48 import java.awt.event.ActionEvent;
  49 import java.awt.event.ActionListener;
  50 import java.awt.event.MouseEvent;
  51 import java.awt.event.MouseListener;
  52 import java.awt.event.MouseMotionListener;
  53 import java.awt.geom.AffineTransform;
  54 import java.util.Arrays;
  55 import java.util.Collections;
  56 import java.util.Iterator;
  57
  58 import javax.swing.JCheckBoxMenuItem;
  59 import javax.swing.JMenuItem;
  60 import javax.swing.JPanel;
  61 import javax.swing.JPopupMenu;
  62 import javax.swing.SwingUtilities;
  63 import javax.swing.ToolTipManager;
  64
  65 /**
  66  * The panel that holds the labels for alignment annotations, providing
  67  * tooltips, context menus, drag to reorder rows, and drag to adjust panel
  68  * height
  69  */
  70 public class AnnotationLabels extends JPanel
  71         implements MouseListener, MouseMotionListener, ActionListener
  72 {
  73   private static final String HTML_END_TAG = "</html>";
  74
  75   private static final String HTML_START_TAG = "<html>";
  76
  77   /**
  78    * width in pixels within which height adjuster arrows are shown and active
  79    */
  80   private static final int HEIGHT_ADJUSTER_WIDTH = 50;
  81
  82   /**
  83    * height in pixels for allowing height adjuster to be active
  84    */
  85   private static int HEIGHT_ADJUSTER_HEIGHT = 10;
  86
  87   private static final Font font = new Font("Arial", Font.PLAIN, 11);
  88
  89   private static final String TOGGLE_LABELSCALE = MessageManager
  90           .getString("label.scale_label_to_column");
  91
  92   private static final String ADDNEW = MessageManager
  93           .getString("label.add_new_row");
  94
  95   private static final String EDITNAME = MessageManager
  96           .getString("label.edit_label_description");
  97
  98   private static final String HIDE = MessageManager
  99           .getString("label.hide_row");
 100
 101   private static final String DELETE = MessageManager
 102           .getString("label.delete_row");
 103
 104   private static final String SHOWALL = MessageManager
 105           .getString("label.show_all_hidden_rows");
 106
 107   private static final String OUTPUT_TEXT = MessageManager
 108           .getString("label.export_annotation");
 109
 110   private static final String COPYCONS_SEQ = MessageManager
 111           .getString("label.copy_consensus_sequence");
 112
 113   private final boolean debugRedraw = false;
 114
 115   private AlignmentPanel ap;
 116
 117   AlignViewport av;
 118
 119   private MouseEvent dragEvent;
 120
 121   private int oldY;
 122
 123   private int selectedRow;
 124
 125   private int scrollOffset = 0;
 126
 127   private boolean hasHiddenRows;
 128
 129   private boolean resizePanel = false;
 130
 131   /**
 132    * Creates a new AnnotationLabels object
 133    *
 134    * @param ap
 135    */
 136   public AnnotationLabels(AlignmentPanel ap)
 137   {
 138     this.ap = ap;
 139     av = ap.av;
 140     ToolTipManager.sharedInstance().registerComponent(this);
 141
 142     addMouseListener(this);
 143     addMouseMotionListener(this);
 144     addMouseWheelListener(ap.getAnnotationPanel());
 145   }
 146
 147   public AnnotationLabels(AlignViewport av)
 148   {
 149     this.av = av;
 150   }
 151
 152   /**
 153    * DOCUMENT ME!
 154    *
 155    * @param y
 156    *          DOCUMENT ME!
 157    */
 158   public void setScrollOffset(int y)
 159   {
 160     scrollOffset = y;
 161     repaint();
 162   }
 163
 164   /**
 165    * sets selectedRow to -2 if no annotation preset, -1 if no visible row is at
 166    * y
 167    *
 168    * @param y
 169    *          coordinate position to search for a row
 170    */
 171   void getSelectedRow(int y)
 172   {
 173     int height = 0;
 174     AlignmentAnnotation[] aa = ap.av.getAlignment()
 175             .getAlignmentAnnotation();
 176     selectedRow = -2;
 177     if (aa != null)
 178     {
 179       for (int i = 0; i < aa.length; i++)
 180       {
 181         selectedRow = -1;
 182         if (!aa[i].visible)
 183         {
 184           continue;
 185         }
 186
 187         height += aa[i].height;
 188
 189         if (y < height)
 190         {
 191           selectedRow = i;
 192
 193           break;
 194         }
 195       }
 196     }
 197   }
 198
 199   /**
 200    * DOCUMENT ME!
 201    *
 202    * @param evt
 203    *          DOCUMENT ME!
 204    */
 205   @Override
 206   public void actionPerformed(ActionEvent evt)
 207   {
 208     AlignmentAnnotation[] aa = ap.av.getAlignment()
 209             .getAlignmentAnnotation();
 210
 211     boolean fullRepaint = false;
 212     if (evt.getActionCommand().equals(ADDNEW))
 213     {
 214       AlignmentAnnotation newAnnotation = new AlignmentAnnotation(null,
 215               null, new Annotation[ap.av.getAlignment().getWidth()]);
 216
 217       if (!editLabelDescription(newAnnotation))
 218       {
 219         return;
 220       }
 221
 222       ap.av.getAlignment().addAnnotation(newAnnotation);
 223       ap.av.getAlignment().setAnnotationIndex(newAnnotation, 0);
 224       fullRepaint = true;
 225     }
 226     else if (evt.getActionCommand().equals(EDITNAME))
 227     {
 228       String name = aa[selectedRow].label;
 229       editLabelDescription(aa[selectedRow]);
 230       if (!name.equalsIgnoreCase(aa[selectedRow].label))
 231       {
 232         fullRepaint = true;
 233       }
 234     }
 235     else if (evt.getActionCommand().equals(HIDE))
 236     {
 237       aa[selectedRow].visible = false;
 238     }
 239     else if (evt.getActionCommand().equals(DELETE))
 240     {
 241       ap.av.getAlignment().deleteAnnotation(aa[selectedRow]);
 242       ap.av.getCalcManager().removeWorkerForAnnotation(aa[selectedRow]);
 243       fullRepaint = true;
 244     }
 245     else if (evt.getActionCommand().equals(SHOWALL))
 246     {
 247       for (int i = 0; i < aa.length; i++)
 248       {
 249         if (!aa[i].visible && aa[i].annotations != null)
 250         {
 251           aa[i].visible = true;
 252         }
 253       }
 254       fullRepaint = true;
 255     }
 256     else if (evt.getActionCommand().equals(OUTPUT_TEXT))
 257     {
 258       new AnnotationExporter(ap).exportAnnotation(aa[selectedRow]);
 259     }
 260     else if (evt.getActionCommand().equals(COPYCONS_SEQ))
 261     {
 262       SequenceI cons = null;
 263       if (aa[selectedRow].groupRef != null)
 264       {
 265         cons = aa[selectedRow].groupRef.getConsensusSeq();
 266       }
 267       else
 268       {
 269         cons = av.getConsensusSeq();
 270       }
 271       if (cons != null)
 272       {
 273         copy_annotseqtoclipboard(cons);
 274       }
 275
 276     }
 277     else if (evt.getActionCommand().equals(TOGGLE_LABELSCALE))
 278     {
 279       aa[selectedRow].scaleColLabel = !aa[selectedRow].scaleColLabel;
 280     }
 281
 282     ap.refresh(fullRepaint);
 283
 284   }
 285
 286   /**
 287    * DOCUMENT ME!
 288    *
 289    * @param e
 290    *          DOCUMENT ME!
 291    */
 292   boolean editLabelDescription(AlignmentAnnotation annotation)
 293   {
 294     // TODO i18n
 295     EditNameDialog dialog = new EditNameDialog(annotation.label,
 296             annotation.description, "       Annotation Name ",
 297             "Annotation Description ", "Edit Annotation Name/Description",
 298             ap.alignFrame);
 299
 300     if (!dialog.accept)
 301     {
 302       return false;
 303     }
 304
 305     annotation.label = dialog.getName();
 306
 307     String text = dialog.getDescription();
 308     if (text != null && text.length() == 0)
 309     {
 310       text = null;
 311     }
 312     annotation.description = text;
 313
 314     return true;
 315   }
 316
 317   @Override
 318   public void mousePressed(MouseEvent evt)
 319   {
 320     getSelectedRow(evt.getY() - getScrollOffset());
 321     oldY = evt.getY();
 322     if (evt.isPopupTrigger())
 323     {
 324       showPopupMenu(evt);
 325     }
 326   }
 327
 328   /**
 329    * Build and show the Pop-up menu at the right-click mouse position
 330    *
 331    * @param evt
 332    */
 333   void showPopupMenu(MouseEvent evt)
 334   {
 335     evt.consume();
 336     final AlignmentAnnotation[] aa = ap.av.getAlignment()
 337             .getAlignmentAnnotation();
 338
 339     JPopupMenu pop = new JPopupMenu(
 340             MessageManager.getString("label.annotations"));
 341     JMenuItem item = new JMenuItem(ADDNEW);
 342     item.addActionListener(this);
 343     pop.add(item);
 344     if (selectedRow < 0)
 345     {
 346       if (hasHiddenRows)
 347       { // let the user make everything visible again
 348         item = new JMenuItem(SHOWALL);
 349         item.addActionListener(this);
 350         pop.add(item);
 351       }
 352       pop.show(this, evt.getX(), evt.getY());
 353       return;
 354     }
 355     item = new JMenuItem(EDITNAME);
 356     item.addActionListener(this);
 357     pop.add(item);
 358     item = new JMenuItem(HIDE);
 359     item.addActionListener(this);
 360     pop.add(item);
 361     // JAL-1264 hide all sequence-specific annotations of this type
 362     if (selectedRow < aa.length)
 363     {
 364       if (aa[selectedRow].sequenceRef != null)
 365       {
 366         final String label = aa[selectedRow].label;
 367         JMenuItem hideType = new JMenuItem();
 368         String text = MessageManager.getString("label.hide_all") + " "
 369                 + label;
 370         hideType.setText(text);
 371         hideType.addActionListener(new ActionListener()
 372         {
 373           @Override
 374           public void actionPerformed(ActionEvent e)
 375           {
 376             AlignmentUtils.showOrHideSequenceAnnotations(
 377                     ap.av.getAlignment(), Collections.singleton(label),
 378                     null, false, false);
 379             ap.refresh(true);
 380           }
 381         });
 382         pop.add(hideType);
 383       }
 384     }
 385     item = new JMenuItem(DELETE);
 386     item.addActionListener(this);
 387     pop.add(item);
 388     if (hasHiddenRows)
 389     {
 390       item = new JMenuItem(SHOWALL);
 391       item.addActionListener(this);
 392       pop.add(item);
 393     }
 394     item = new JMenuItem(OUTPUT_TEXT);
 395     item.addActionListener(this);
 396     pop.add(item);
 397     // TODO: annotation object should be typed for autocalculated/derived
 398     // property methods
 399     if (selectedRow < aa.length)
 400     {
 401       final String label = aa[selectedRow].label;
 402       if (!aa[selectedRow].autoCalculated)
 403       {
 404         if (aa[selectedRow].graph == AlignmentAnnotation.NO_GRAPH)
 405         {
 406           // display formatting settings for this row.
 407           pop.addSeparator();
 408           // av and sequencegroup need to implement same interface for
 409           item = new JCheckBoxMenuItem(TOGGLE_LABELSCALE,
 410                   aa[selectedRow].scaleColLabel);
 411           item.addActionListener(this);
 412           pop.add(item);
 413         }
 414       }
 415       else if (label.indexOf("Consensus") > -1)
 416       {
 417         addConsensusMenuOptions(ap, aa[selectedRow], pop);
 418
 419         final JMenuItem consclipbrd = new JMenuItem(COPYCONS_SEQ);
 420         consclipbrd.addActionListener(this);
 421         pop.add(consclipbrd);
 422       }
 423     }
 424     pop.show(this, evt.getX(), evt.getY());
 425   }
 426
 427   /**
 428    * A helper method that adds menu options for calculation and visualisation of
 429    * group and/or alignment consensus annotation to a popup menu. This is
 430    * designed to be reusable for either unwrapped mode (popup menu is shown on
 431    * component AnnotationLabels), or wrapped mode (popup menu is shown on
 432    * IdPanel when the mouse is over an annotation label).
 433    *
 434    * @param ap
 435    * @param ann
 436    * @param pop
 437    */
 438   static void addConsensusMenuOptions(AlignmentPanel ap,
 439           AlignmentAnnotation ann,
 440           JPopupMenu pop)
 441   {
 442     pop.addSeparator();
 443
 444     final JCheckBoxMenuItem cbmi = new JCheckBoxMenuItem(
 445             MessageManager.getString("label.ignore_gaps_consensus"),
 446             (ann.groupRef != null) ? ann.groupRef.getIgnoreGapsConsensus()
 447                     : ap.av.isIgnoreGapsConsensus());
 448     final AlignmentAnnotation aaa = ann;
 449     cbmi.addActionListener(new ActionListener()
 450     {
 451       @Override
 452       public void actionPerformed(ActionEvent e)
 453       {
 454         if (aaa.groupRef != null)
 455         {
 456           aaa.groupRef.setIgnoreGapsConsensus(cbmi.getState());
 457           ap.getAnnotationPanel()
 458                   .paint(ap.getAnnotationPanel().getGraphics());
 459         }
 460         else
 461         {
 462           ap.av.setIgnoreGapsConsensus(cbmi.getState(), ap);
 463         }
 464         ap.alignmentChanged();
 465       }
 466     });
 467     pop.add(cbmi);
 468
 469     if (aaa.groupRef != null)
 470     {
 471       /*
 472        * group consensus options
 473        */
 474       final JCheckBoxMenuItem chist = new JCheckBoxMenuItem(
 475               MessageManager.getString("label.show_group_histogram"),
 476               ann.groupRef.isShowConsensusHistogram());
 477       chist.addActionListener(new ActionListener()
 478       {
 479         @Override
 480         public void actionPerformed(ActionEvent e)
 481         {
 482           aaa.groupRef.setShowConsensusHistogram(chist.getState());
 483           ap.repaint();
 484         }
 485       });
 486       pop.add(chist);
 487       final JCheckBoxMenuItem cprofl = new JCheckBoxMenuItem(
 488               MessageManager.getString("label.show_group_logo"),
 489               ann.groupRef.isShowSequenceLogo());
 490       cprofl.addActionListener(new ActionListener()
 491       {
 492         @Override
 493         public void actionPerformed(ActionEvent e)
 494         {
 495           aaa.groupRef.setshowSequenceLogo(cprofl.getState());
 496           ap.repaint();
 497         }
 498       });
 499       pop.add(cprofl);
 500       final JCheckBoxMenuItem cproflnorm = new JCheckBoxMenuItem(
 501               MessageManager.getString("label.normalise_group_logo"),
 502               ann.groupRef.isNormaliseSequenceLogo());
 503       cproflnorm.addActionListener(new ActionListener()
 504       {
 505         @Override
 506         public void actionPerformed(ActionEvent e)
 507         {
 508           aaa.groupRef.setNormaliseSequenceLogo(cproflnorm.getState());
 509           // automatically enable logo display if we're clicked
 510           aaa.groupRef.setshowSequenceLogo(true);
 511           ap.repaint();
 512         }
 513       });
 514       pop.add(cproflnorm);
 515     }
 516     else
 517     {
 518       /*
 519        * alignment consensus options
 520        */
 521       final JCheckBoxMenuItem chist = new JCheckBoxMenuItem(
 522               MessageManager.getString("label.show_histogram"),
 523               ap.av.isShowConsensusHistogram());
 524       chist.addActionListener(new ActionListener()
 525       {
 526         @Override
 527         public void actionPerformed(ActionEvent e)
 528         {
 529           ap.av.setShowConsensusHistogram(chist.getState());
 530           ap.alignFrame.setMenusForViewport();
 531           ap.repaint();
 532         }
 533       });
 534       pop.add(chist);
 535       final JCheckBoxMenuItem cprof = new JCheckBoxMenuItem(
 536               MessageManager.getString("label.show_logo"),
 537               ap.av.isShowSequenceLogo());
 538       cprof.addActionListener(new ActionListener()
 539       {
 540         @Override
 541         public void actionPerformed(ActionEvent e)
 542         {
 543           ap.av.setShowSequenceLogo(cprof.getState());
 544           ap.alignFrame.setMenusForViewport();
 545           ap.repaint();
 546         }
 547       });
 548       pop.add(cprof);
 549       final JCheckBoxMenuItem cprofnorm = new JCheckBoxMenuItem(
 550               MessageManager.getString("label.normalise_logo"),
 551               ap.av.isNormaliseSequenceLogo());
 552       cprofnorm.addActionListener(new ActionListener()
 553       {
 554         @Override
 555         public void actionPerformed(ActionEvent e)
 556         {
 557           ap.av.setShowSequenceLogo(true);
 558           ap.av.setNormaliseSequenceLogo(cprofnorm.getState());
 559           ap.alignFrame.setMenusForViewport();
 560           ap.repaint();
 561         }
 562       });
 563       pop.add(cprofnorm);
 564     }
 565   }
 566
 567   /**
 568    * Reorders annotation rows after a drag of a label
 569    *
 570    * @param evt
 571    */
 572   @Override
 573   public void mouseReleased(MouseEvent evt)
 574   {
 575     if (evt.isPopupTrigger())
 576     {
 577       showPopupMenu(evt);
 578       return;
 579     }
 580
 581     int start = selectedRow;
 582     getSelectedRow(evt.getY() - getScrollOffset());
 583     int end = selectedRow;
 584
 585     /*
 586      * if dragging to resize instead, start == end
 587      */
 588     if (start != end)
 589     {
 590       // Swap these annotations
 591       AlignmentAnnotation startAA = ap.av.getAlignment()
 592               .getAlignmentAnnotation()[start];
 593       if (end == -1)
 594       {
 595         end = ap.av.getAlignment().getAlignmentAnnotation().length - 1;
 596       }
 597       AlignmentAnnotation endAA = ap.av.getAlignment()
 598               .getAlignmentAnnotation()[end];
 599
 600       ap.av.getAlignment().getAlignmentAnnotation()[end] = startAA;
 601       ap.av.getAlignment().getAlignmentAnnotation()[start] = endAA;
 602     }
 603
 604     resizePanel = false;
 605     dragEvent = null;
 606     repaint();
 607     ap.getAnnotationPanel().repaint();
 608   }
 609
 610   /**
 611    * Removes the height adjuster image on leaving the panel, unless currently
 612    * dragging it
 613    */
 614   @Override
 615   public void mouseExited(MouseEvent evt)
 616   {
 617     if (resizePanel && dragEvent == null)
 618     {
 619       resizePanel = false;
 620       repaint();
 621     }
 622   }
 623
 624   /**
 625    * A mouse drag may be either an adjustment of the panel height (if flag
 626    * resizePanel is set on), or a reordering of the annotation rows. The former
 627    * is dealt with by this method, the latter in mouseReleased.
 628    *
 629    * @param evt
 630    */
 631   @Override
 632   public void mouseDragged(MouseEvent evt)
 633   {
 634     dragEvent = evt;
 635
 636     if (resizePanel)
 637     {
 638       Dimension d = ap.annotationScroller.getPreferredSize();
 639       int dif = evt.getY() - oldY;
 640
 641       dif /= ap.av.getCharHeight();
 642       dif *= ap.av.getCharHeight();
 643
 644       if ((d.height - dif) > 20)
 645       {
 646         ap.annotationScroller
 647                 .setPreferredSize(new Dimension(d.width, d.height - dif));
 648         d = ap.annotationSpaceFillerHolder.getPreferredSize();
 649         ap.annotationSpaceFillerHolder
 650                 .setPreferredSize(new Dimension(d.width, d.height - dif));
 651         ap.paintAlignment(true, false);
 652       }
 653
 654       ap.addNotify();
 655     }
 656     else
 657     {
 658       repaint();
 659     }
 660   }
 661
 662   /**
 663    * Updates the tooltip as the mouse moves over the labels
 664    *
 665    * @param evt
 666    */
 667   @Override
 668   public void mouseMoved(MouseEvent evt)
 669   {
 670     showOrHideAdjuster(evt);
 671
 672     getSelectedRow(evt.getY() - getScrollOffset());
 673
 674     if (selectedRow > -1 && ap.av.getAlignment()
 675             .getAlignmentAnnotation().length > selectedRow)
 676     {
 677       AlignmentAnnotation aa = ap.av.getAlignment()
 678               .getAlignmentAnnotation()[selectedRow];
 679
 680       String desc = getTooltip(aa);
 681       this.setToolTipText(desc);
 682       ap.alignFrame.setStatus(aa.label);
 683     }
 684   }
 685
 686   /**
 687    * Answers a tooltip, formatted as html, containing the annotation description
 688    * (prefixed by associated sequence id if applicable), and the annotation
 689    * (non-positional) score if it has one. Answers null if neither description
 690    * nor score is found.
 691    *
 692    * @param aa
 693    * @return
 694    */
 695   static String getTooltip(AlignmentAnnotation aa)
 696   {
 697     if (aa == null)
 698     {
 699       return null;
 700     }
 701     StringBuilder tooltip = new StringBuilder();
 702     if (aa.description != null && !aa.description.equals("New description"))
 703     {
 704       // TODO: we could refactor and merge this code with the code in
 705       // jalview.gui.SeqPanel.mouseMoved(..) that formats sequence feature
 706       // tooltips
 707       String desc = aa.getDescription(true).trim();
 708       if (!desc.toLowerCase().startsWith(HTML_START_TAG))
 709       {
 710         tooltip.append(HTML_START_TAG);
 711         desc = desc.replace("<", "&lt;");
 712       }
 713       else if (desc.toLowerCase().endsWith(HTML_END_TAG))
 714       {
 715         desc = desc.substring(0, desc.length() - HTML_END_TAG.length());
 716       }
 717       tooltip.append(desc);
 718     }
 719     else
 720     {
 721       // begin the tooltip's html fragment
 722       tooltip.append(HTML_START_TAG);
 723     }
 724     if (aa.hasScore())
 725     {
 726       if (tooltip.length() > HTML_START_TAG.length())
 727       {
 728         tooltip.append("<br/>");
 729       }
 730       // TODO: limit precision of score to avoid noise from imprecise
 731       // doubles
 732       // (64.7 becomes 64.7+/some tiny value).
 733       tooltip.append(" Score: ").append(String.valueOf(aa.score));
 734     }
 735
 736     if (tooltip.length() > HTML_START_TAG.length())
 737     {
 738       return tooltip.append(HTML_END_TAG).toString();
 739     }
 740
 741     /*
 742      * nothing in the tooltip (except "<html>")
 743      */
 744     return null;
 745   }
 746
 747   /**
 748    * Shows the height adjuster image if the mouse moves into the top left
 749    * region, or hides it if the mouse leaves the regio
 750    *
 751    * @param evt
 752    */
 753   protected void showOrHideAdjuster(MouseEvent evt)
 754   {
 755     boolean was = resizePanel;
 756     resizePanel = evt.getY() < HEIGHT_ADJUSTER_HEIGHT && evt.getX() < HEIGHT_ADJUSTER_WIDTH;
 757
 758     if (resizePanel != was)
 759     {
 760       setCursor(Cursor.getPredefinedCursor(
 761               resizePanel ? Cursor.S_RESIZE_CURSOR
 762                       : Cursor.DEFAULT_CURSOR));
 763       repaint();
 764     }
 765   }
 766
 767   @Override
 768   public void mouseClicked(MouseEvent evt)
 769   {
 770     final AlignmentAnnotation[] aa = ap.av.getAlignment()
 771             .getAlignmentAnnotation();
 772     if (!evt.isPopupTrigger() && SwingUtilities.isLeftMouseButton(evt))
 773     {
 774       if (selectedRow > -1 && selectedRow < aa.length)
 775       {
 776         if (aa[selectedRow].groupRef != null)
 777         {
 778           if (evt.getClickCount() >= 2)
 779           {
 780             // todo: make the ap scroll to the selection - not necessary, first
 781             // click highlights/scrolls, second selects
 782             ap.getSeqPanel().ap.getIdPanel().highlightSearchResults(null);
 783             // process modifiers
 784             SequenceGroup sg = ap.av.getSelectionGroup();
 785             if (sg == null || sg == aa[selectedRow].groupRef
 786                     || !(Platform.isControlDown(evt) || evt.isShiftDown()))
 787             {
 788               if (Platform.isControlDown(evt) || evt.isShiftDown())
 789               {
 790                 // clone a new selection group from the associated group
 791                 ap.av.setSelectionGroup(
 792                         new SequenceGroup(aa[selectedRow].groupRef));
 793               }
 794               else
 795               {
 796                 // set selection to the associated group so it can be edited
 797                 ap.av.setSelectionGroup(aa[selectedRow].groupRef);
 798               }
 799             }
 800             else
 801             {
 802               // modify current selection with associated group
 803               int remainToAdd = aa[selectedRow].groupRef.getSize();
 804               for (SequenceI sgs : aa[selectedRow].groupRef.getSequences())
 805               {
 806                 if (jalview.util.Platform.isControlDown(evt))
 807                 {
 808                   sg.addOrRemove(sgs, --remainToAdd == 0);
 809                 }
 810                 else
 811                 {
 812                   // notionally, we should also add intermediate sequences from
 813                   // last added sequence ?
 814                   sg.addSequence(sgs, --remainToAdd == 0);
 815                 }
 816               }
 817             }
 818
 819             ap.paintAlignment(false, false);
 820             PaintRefresher.Refresh(ap, ap.av.getSequenceSetId());
 821             ap.av.sendSelection();
 822           }
 823           else
 824           {
 825             ap.getSeqPanel().ap.getIdPanel().highlightSearchResults(
 826                     aa[selectedRow].groupRef.getSequences(null));
 827           }
 828           return;
 829         }
 830         else if (aa[selectedRow].sequenceRef != null)
 831         {
 832           if (evt.getClickCount() == 1)
 833           {
 834             ap.getSeqPanel().ap.getIdPanel()
 835                     .highlightSearchResults(Arrays.asList(new SequenceI[]
 836                     { aa[selectedRow].sequenceRef }));
 837           }
 838           else if (evt.getClickCount() >= 2)
 839           {
 840             ap.getSeqPanel().ap.getIdPanel().highlightSearchResults(null);
 841             SequenceGroup sg = ap.av.getSelectionGroup();
 842             if (sg != null)
 843             {
 844               // we make a copy rather than edit the current selection if no
 845               // modifiers pressed
 846               // see Enhancement JAL-1557
 847               if (!(Platform.isControlDown(evt) || evt.isShiftDown()))
 848               {
 849                 sg = new SequenceGroup(sg);
 850                 sg.clear();
 851                 sg.addSequence(aa[selectedRow].sequenceRef, false);
 852               }
 853               else
 854               {
 855                 if (Platform.isControlDown(evt))
 856                 {
 857                   sg.addOrRemove(aa[selectedRow].sequenceRef, true);
 858                 }
 859                 else
 860                 {
 861                   // notionally, we should also add intermediate sequences from
 862                   // last added sequence ?
 863                   sg.addSequence(aa[selectedRow].sequenceRef, true);
 864                 }
 865               }
 866             }
 867             else
 868             {
 869               sg = new SequenceGroup();
 870               sg.setStartRes(0);
 871               sg.setEndRes(ap.av.getAlignment().getWidth() - 1);
 872               sg.addSequence(aa[selectedRow].sequenceRef, false);
 873             }
 874             ap.av.setSelectionGroup(sg);
 875             ap.paintAlignment(false, false);
 876             PaintRefresher.Refresh(ap, ap.av.getSequenceSetId());
 877             ap.av.sendSelection();
 878           }
 879
 880         }
 881       }
 882       return;
 883     }
 884   }
 885
 886   /**
 887    * do a single sequence copy to jalview and the system clipboard
 888    *
 889    * @param sq
 890    *          sequence to be copied to clipboard
 891    */
 892   protected void copy_annotseqtoclipboard(SequenceI sq)
 893   {
 894     SequenceI[] seqs = new SequenceI[] { sq };
 895     String[] omitHidden = null;
 896     SequenceI[] dseqs = new SequenceI[] { sq.getDatasetSequence() };
 897     if (dseqs[0] == null)
 898     {
 899       dseqs[0] = new Sequence(sq);
 900       dseqs[0].setSequence(AlignSeq.extractGaps(Comparison.GapChars,
 901               sq.getSequenceAsString()));
 902
 903       sq.setDatasetSequence(dseqs[0]);
 904     }
 905     Alignment ds = new Alignment(dseqs);
 906     if (av.hasHiddenColumns())
 907     {
 908       Iterator<int[]> it = av.getAlignment().getHiddenColumns()
 909               .getVisContigsIterator(0, sq.getLength(), false);
 910       omitHidden = new String[] { sq.getSequenceStringFromIterator(it) };
 911     }
 912
 913     int[] alignmentStartEnd = new int[] { 0, ds.getWidth() - 1 };
 914     if (av.hasHiddenColumns())
 915     {
 916       alignmentStartEnd = av.getAlignment().getHiddenColumns()
 917               .getVisibleStartAndEndIndex(av.getAlignment().getWidth());
 918     }
 919
 920     String output = new FormatAdapter().formatSequences(FileFormat.Fasta,
 921             seqs, omitHidden, alignmentStartEnd);
 922
 923     Toolkit.getDefaultToolkit().getSystemClipboard()
 924             .setContents(new StringSelection(output), Desktop.instance);
 925
 926     HiddenColumns hiddenColumns = null;
 927
 928     if (av.hasHiddenColumns())
 929     {
 930       hiddenColumns = new HiddenColumns(
 931               av.getAlignment().getHiddenColumns());
 932     }
 933
 934     Desktop.jalviewClipboard = new Object[] { seqs, ds, // what is the dataset
 935                                                         // of a consensus
 936                                                         // sequence ? need to
 937                                                         // flag
 938         // sequence as special.
 939         hiddenColumns };
 940   }
 941
 942   /**
 943    * DOCUMENT ME!
 944    *
 945    * @param g1
 946    *          DOCUMENT ME!
 947    */
 948   @Override
 949   public void paintComponent(Graphics g)
 950   {
 951
 952     int width = getWidth();
 953     if (width == 0)
 954     {
 955       width = ap.calculateIdWidth().width + 4;
 956     }
 957
 958     Graphics2D g2 = (Graphics2D) g;
 959     if (av.antiAlias)
 960     {
 961       g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
 962               RenderingHints.VALUE_ANTIALIAS_ON);
 963     }
 964
 965     drawComponent(g2, true, width);
 966
 967   }
 968
 969   /**
 970    * Draw the full set of annotation Labels for the alignment at the given
 971    * cursor
 972    *
 973    * @param g
 974    *          Graphics2D instance (needed for font scaling)
 975    * @param width
 976    *          Width for scaling labels
 977    *
 978    */
 979   public void drawComponent(Graphics g, int width)
 980   {
 981     drawComponent(g, false, width);
 982   }
 983
 984   /**
 985    * Draw the full set of annotation Labels for the alignment at the given
 986    * cursor
 987    *
 988    * @param g
 989    *          Graphics2D instance (needed for font scaling)
 990    * @param clip
 991    *          - true indicates that only current visible area needs to be
 992    *          rendered
 993    * @param width
 994    *          Width for scaling labels
 995    */
 996   public void drawComponent(Graphics g, boolean clip, int width)
 997   {
 998     if (av.getFont().getSize() < 10)
 999     {
1000       g.setFont(font);
1001     }
1002     else
1003     {
1004       g.setFont(av.getFont());
1005     }
1006
1007     FontMetrics fm = g.getFontMetrics(g.getFont());
1008     g.setColor(Color.white);
1009     g.fillRect(0, 0, getWidth(), getHeight());
1010
1011     g.translate(0, getScrollOffset());
1012     g.setColor(Color.black);
1013
1014     AlignmentAnnotation[] aa = av.getAlignment().getAlignmentAnnotation();
1015     int fontHeight = g.getFont().getSize();
1016     int y = 0;
1017     int x = 0;
1018     int graphExtras = 0;
1019     int offset = 0;
1020     Font baseFont = g.getFont();
1021     FontMetrics baseMetrics = fm;
1022     int ofontH = fontHeight;
1023     int sOffset = 0;
1024     int visHeight = 0;
1025     int[] visr = (ap != null && ap.getAnnotationPanel() != null)
1026             ? ap.getAnnotationPanel().getVisibleVRange()
1027             : null;
1028     if (clip && visr != null)
1029     {
1030       sOffset = visr[0];
1031       visHeight = visr[1];
1032     }
1033     boolean visible = true, before = false, after = false;
1034     if (aa != null)
1035     {
1036       hasHiddenRows = false;
1037       int olY = 0;
1038       for (int i = 0; i < aa.length; i++)
1039       {
1040         visible = true;
1041         if (!aa[i].visible)
1042         {
1043           hasHiddenRows = true;
1044           continue;
1045         }
1046         olY = y;
1047         y += aa[i].height;
1048         if (clip)
1049         {
1050           if (y < sOffset)
1051           {
1052             if (!before)
1053             {
1054               if (debugRedraw)
1055               {
1056                 System.out.println("before vis: " + i);
1057               }
1058               before = true;
1059             }
1060             // don't draw what isn't visible
1061             continue;
1062           }
1063           if (olY > visHeight)
1064           {
1065
1066             if (!after)
1067             {
1068               if (debugRedraw)
1069               {
1070                 System.out.println(
1071                         "Scroll offset: " + sOffset + " after vis: " + i);
1072               }
1073               after = true;
1074             }
1075             // don't draw what isn't visible
1076             continue;
1077           }
1078         }
1079         g.setColor(Color.black);
1080
1081         offset = -aa[i].height / 2;
1082
1083         if (aa[i].hasText)
1084         {
1085           offset += fm.getHeight() / 2;
1086           offset -= fm.getDescent();
1087         }
1088         else
1089         {
1090           offset += fm.getDescent();
1091         }
1092
1093         x = width - fm.stringWidth(aa[i].label) - 3;
1094
1095         if (aa[i].graphGroup > -1)
1096         {
1097           int groupSize = 0;
1098           // TODO: JAL-1291 revise rendering model so the graphGroup map is
1099           // computed efficiently for all visible labels
1100           for (int gg = 0; gg < aa.length; gg++)
1101           {
1102             if (aa[gg].graphGroup == aa[i].graphGroup)
1103             {
1104               groupSize++;
1105             }
1106           }
1107           if (groupSize * (fontHeight + 8) < aa[i].height)
1108           {
1109             graphExtras = (aa[i].height - (groupSize * (fontHeight + 8)))
1110                     / 2;
1111           }
1112           else
1113           {
1114             // scale font to fit
1115             float h = aa[i].height / (float) groupSize, s;
1116             if (h < 9)
1117             {
1118               visible = false;
1119             }
1120             else
1121             {
1122               fontHeight = -8 + (int) h;
1123               s = ((float) fontHeight) / (float) ofontH;
1124               Font f = baseFont
1125                       .deriveFont(AffineTransform.getScaleInstance(s, s));
1126               g.setFont(f);
1127               fm = g.getFontMetrics();
1128               graphExtras = (aa[i].height - (groupSize * (fontHeight + 8)))
1129                       / 2;
1130             }
1131           }
1132           if (visible)
1133           {
1134             for (int gg = 0; gg < aa.length; gg++)
1135             {
1136               if (aa[gg].graphGroup == aa[i].graphGroup)
1137               {
1138                 x = width - fm.stringWidth(aa[gg].label) - 3;
1139                 g.drawString(aa[gg].label, x, y - graphExtras);
1140
1141                 if (aa[gg]._linecolour != null)
1142                 {
1143
1144                   g.setColor(aa[gg]._linecolour);
1145                   g.drawLine(x, y - graphExtras + 3,
1146                           x + fm.stringWidth(aa[gg].label),
1147                           y - graphExtras + 3);
1148                 }
1149
1150                 g.setColor(Color.black);
1151                 graphExtras += fontHeight + 8;
1152               }
1153             }
1154           }
1155           g.setFont(baseFont);
1156           fm = baseMetrics;
1157           fontHeight = ofontH;
1158         }
1159         else
1160         {
1161           g.drawString(aa[i].label, x, y + offset);
1162         }
1163       }
1164     }
1165
1166     if (!resizePanel && dragEvent != null && aa != null)
1167     {
1168       g.setColor(Color.lightGray);
1169       g.drawString(aa[selectedRow].label, dragEvent.getX(),
1170               dragEvent.getY() - getScrollOffset());
1171     }
1172
1173     if (!av.getWrapAlignment() && ((aa == null) || (aa.length < 1)))
1174     {
1175       g.drawString(MessageManager.getString("label.right_click"), 2, 8);
1176       g.drawString(MessageManager.getString("label.to_add_annotation"), 2,
1177               18);
1178     }
1179   }
1180
1181   public int getScrollOffset()
1182   {
1183     return scrollOffset;
1184   }
1185
1186   @Override
1187   public void mouseEntered(MouseEvent e)
1188   {
1189   }
1190 }