JAL-2077 fix: convenience method and checks for CMD+Click to toggle selections
[jalview.git] / src / jalview / appletgui / IdPanel.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.appletgui;
22
23 import jalview.datamodel.Sequence;
24 import jalview.datamodel.SequenceFeature;
25 import jalview.datamodel.SequenceGroup;
26 import jalview.datamodel.SequenceI;
27 import jalview.util.UrlLink;
28 import jalview.viewmodel.AlignmentViewport;
29
30 import java.awt.BorderLayout;
31 import java.awt.Panel;
32 import java.awt.event.InputEvent;
33 import java.awt.event.MouseEvent;
34 import java.awt.event.MouseListener;
35 import java.awt.event.MouseMotionListener;
36 import java.util.List;
37 import java.util.Vector;
38
39 public class IdPanel extends Panel implements MouseListener,
40         MouseMotionListener
41 {
42
43   protected IdCanvas idCanvas;
44
45   protected AlignmentViewport av;
46
47   protected AlignmentPanel alignPanel;
48
49   ScrollThread scrollThread = null;
50
51   int lastid = -1;
52
53   boolean mouseDragging = false;
54
55   java.util.Vector links = new java.util.Vector();
56
57   public IdPanel(AlignViewport av, AlignmentPanel parent)
58   {
59     this.av = av;
60     alignPanel = parent;
61     idCanvas = new IdCanvas(av);
62     setLayout(new BorderLayout());
63     add(idCanvas, BorderLayout.CENTER);
64     idCanvas.addMouseListener(this);
65     idCanvas.addMouseMotionListener(this);
66
67     String label, url;
68     // TODO: add in group link parameter
69     if (av.applet != null)
70     {
71       for (int i = 1; i < 10; i++)
72       {
73         label = av.applet.getParameter("linkLabel_" + i);
74         url = av.applet.getParameter("linkURL_" + i);
75
76         if (label != null && url != null)
77         {
78           links.addElement(label + "|" + url);
79         }
80
81       }
82     }
83     {
84       // upgrade old SRS link
85       int srsPos = links
86               .indexOf("SRS|http://srs.ebi.ac.uk/srsbin/cgi-bin/wgetz?-newId+(([uniprot-all:$SEQUENCE_ID$]))+-view+SwissEntry");
87       if (srsPos > -1)
88       {
89         links.setElementAt(
90                 "EMBL-EBI Search|http://www.ebi.ac.uk/ebisearch/search.ebi?db=allebi&query=$SEQUENCE_ID$",
91                 srsPos);
92       }
93     }
94     if (links.size() < 1)
95     {
96       links = new java.util.Vector();
97       links.addElement("EMBL-EBI Search|http://www.ebi.ac.uk/ebisearch/search.ebi?db=allebi&query=$SEQUENCE_ID$");
98     }
99   }
100
101   Tooltip tooltip;
102
103   @Override
104   public void mouseMoved(MouseEvent e)
105   {
106     int seq = alignPanel.seqPanel.findSeq(e);
107
108     SequenceI sequence = av.getAlignment().getSequenceAt(seq);
109
110     // look for non-pos features
111     StringBuffer tooltiptext = new StringBuffer();
112     if (sequence != null)
113     {
114       if (sequence.getDescription() != null)
115       {
116         tooltiptext.append(sequence.getDescription());
117         tooltiptext.append("\n");
118       }
119
120       SequenceFeature sf[] = sequence.getSequenceFeatures();
121       for (int sl = 0; sf != null && sl < sf.length; sl++)
122       {
123         if (sf[sl].begin == sf[sl].end && sf[sl].begin == 0)
124         {
125           boolean nl = false;
126           if (sf[sl].getFeatureGroup() != null)
127           {
128             tooltiptext.append(sf[sl].getFeatureGroup());
129             nl = true;
130           }
131           ;
132           if (sf[sl].getType() != null)
133           {
134             tooltiptext.append(" ");
135             tooltiptext.append(sf[sl].getType());
136             nl = true;
137           }
138           ;
139           if (sf[sl].getDescription() != null)
140           {
141             tooltiptext.append(" ");
142             tooltiptext.append(sf[sl].getDescription());
143             nl = true;
144           }
145           ;
146           if (!Float.isNaN(sf[sl].getScore()) && sf[sl].getScore() != 0f)
147           {
148             tooltiptext.append(" Score = ");
149             tooltiptext.append(sf[sl].getScore());
150             nl = true;
151           }
152           ;
153           if (sf[sl].getStatus() != null && sf[sl].getStatus().length() > 0)
154           {
155             tooltiptext.append(" (");
156             tooltiptext.append(sf[sl].getStatus());
157             tooltiptext.append(")");
158             nl = true;
159           }
160           ;
161           if (nl)
162           {
163             tooltiptext.append("\n");
164           }
165         }
166       }
167     }
168     if (tooltiptext.length() == 0)
169     {
170       // nothing to display - so clear tooltip if one is visible
171       if (tooltip != null)
172       {
173         tooltip.setVisible(false);
174       }
175       tooltip = null;
176       tooltiptext = null;
177       return;
178     }
179     if (tooltip == null)
180     {
181       tooltip = new Tooltip(sequence.getDisplayId(true) + "\n"
182               + tooltiptext.toString(), idCanvas);
183     }
184     else
185     {
186       tooltip.setTip(sequence.getDisplayId(true) + "\n"
187               + tooltiptext.toString());
188     }
189     tooltiptext = null;
190   }
191
192   @Override
193   public void mouseDragged(MouseEvent e)
194   {
195     mouseDragging = true;
196
197     int seq = Math.max(0, alignPanel.seqPanel.findSeq(e));
198
199     if (seq < lastid)
200     {
201       selectSeqs(lastid - 1, seq);
202     }
203     else if (seq > lastid)
204     {
205       selectSeqs(lastid + 1, seq);
206     }
207
208     lastid = seq;
209     alignPanel.paintAlignment(false);
210   }
211
212   @Override
213   public void mouseClicked(MouseEvent e)
214   {
215     if (e.getClickCount() < 2)
216     {
217       return;
218     }
219
220     // DEFAULT LINK IS FIRST IN THE LINK LIST
221     int seq = alignPanel.seqPanel.findSeq(e);
222     SequenceI sq = av.getAlignment().getSequenceAt(seq);
223     if (sq == null)
224     {
225       return;
226     }
227     String id = sq.getName();
228
229     String target = null;
230     String url = null;
231     int i = 0;
232     while (url == null && i < links.size())
233     {
234       // DEFAULT LINK IS FIRST IN THE LINK LIST
235       // BUT IF ITS A REGEX AND DOES NOT MATCH THE NEXT ONE WILL BE TRIED
236       url = links.elementAt(i++).toString();
237       jalview.util.UrlLink urlLink = null;
238       try
239       {
240         urlLink = new UrlLink(url);
241         target = urlLink.getTarget();
242       } catch (Exception foo)
243       {
244         System.err.println("Exception for URLLink '" + url + "'");
245         foo.printStackTrace();
246         url = null;
247         continue;
248       }
249       ;
250       if (!urlLink.isValid())
251       {
252         System.err.println(urlLink.getInvalidMessage());
253         url = null;
254         continue;
255       }
256
257       String urls[] = urlLink.makeUrls(id, true);
258       if (urls == null || urls[0] == null || urls[0].length() < 1)
259       {
260         url = null;
261         continue;
262       }
263       // just take first URL made from regex
264       url = urls[1];
265     }
266     try
267     {
268
269       alignPanel.alignFrame.showURL(url, target);
270     } catch (Exception ex)
271     {
272       ex.printStackTrace();
273     }
274   }
275
276   @Override
277   public void mouseEntered(MouseEvent e)
278   {
279     if (scrollThread != null)
280     {
281       scrollThread.running = false;
282     }
283   }
284
285   @Override
286   public void mouseExited(MouseEvent e)
287   {
288     if (av.getWrapAlignment())
289     {
290       return;
291     }
292
293     if (mouseDragging && e.getY() < 0 && av.getStartSeq() > 0)
294     {
295       scrollThread = new ScrollThread(true);
296     }
297
298     if (mouseDragging && e.getY() >= getSize().height
299             && av.getAlignment().getHeight() > av.getEndSeq())
300     {
301       scrollThread = new ScrollThread(false);
302     }
303   }
304
305   @Override
306   public void mousePressed(MouseEvent e)
307   {
308     if (e.getClickCount() > 1)
309     {
310       return;
311     }
312
313     int y = e.getY();
314     if (av.getWrapAlignment())
315     {
316       y -= 2 * av.getCharHeight();
317     }
318
319     int seq = alignPanel.seqPanel.findSeq(e);
320
321     if ((e.getModifiers() & InputEvent.BUTTON3_MASK) == InputEvent.BUTTON3_MASK)
322     {
323       Sequence sq = (Sequence) av.getAlignment().getSequenceAt(seq);
324
325       // build a new links menu based on the current links + any non-positional
326       // features
327       Vector nlinks = new Vector();
328       for (int l = 0, lSize = links.size(); l < lSize; l++)
329       {
330         nlinks.addElement(links.elementAt(l));
331       }
332       SequenceFeature sf[] = sq == null ? null : sq.getSequenceFeatures();
333       for (int sl = 0; sf != null && sl < sf.length; sl++)
334       {
335         if (sf[sl].begin == sf[sl].end && sf[sl].begin == 0)
336         {
337           if (sf[sl].links != null && sf[sl].links.size() > 0)
338           {
339             for (int l = 0, lSize = sf[sl].links.size(); l < lSize; l++)
340             {
341               nlinks.addElement(sf[sl].links.elementAt(l));
342             }
343           }
344         }
345       }
346
347       APopupMenu popup = new APopupMenu(alignPanel, sq, nlinks);
348       this.add(popup);
349       popup.show(this, e.getX(), e.getY());
350       return;
351     }
352
353     if ((av.getSelectionGroup() == null)
354             || ((!jalview.util.Platform.isControlDown(e) && !e
355                     .isShiftDown()) && av
356                     .getSelectionGroup() != null))
357     {
358       av.setSelectionGroup(new SequenceGroup());
359       av.getSelectionGroup().setStartRes(0);
360       av.getSelectionGroup().setEndRes(av.getAlignment().getWidth() - 1);
361     }
362
363     if (e.isShiftDown() && lastid != -1)
364     {
365       selectSeqs(lastid, seq);
366     }
367     else
368     {
369       selectSeq(seq);
370     }
371
372     alignPanel.paintAlignment(false);
373   }
374
375   void selectSeq(int seq)
376   {
377     lastid = seq;
378     SequenceI pickedSeq = av.getAlignment().getSequenceAt(seq);
379     av.getSelectionGroup().addOrRemove(pickedSeq, true);
380   }
381
382   void selectSeqs(int start, int end)
383   {
384
385     lastid = start;
386
387     if (end >= av.getAlignment().getHeight())
388     {
389       end = av.getAlignment().getHeight() - 1;
390     }
391
392     if (end < start)
393     {
394       int tmp = start;
395       start = end;
396       end = tmp;
397       lastid = end;
398     }
399     if (av.getSelectionGroup() == null)
400     {
401       av.setSelectionGroup(new SequenceGroup());
402     }
403     for (int i = start; i <= end; i++)
404     {
405       av.getSelectionGroup().addSequence(
406               av.getAlignment().getSequenceAt(i), i == end);
407     }
408
409   }
410
411   @Override
412   public void mouseReleased(MouseEvent e)
413   {
414     if (scrollThread != null)
415     {
416       scrollThread.running = false;
417     }
418
419     if (av.getSelectionGroup() != null)
420     {
421       av.getSelectionGroup().recalcConservation();
422     }
423
424     mouseDragging = false;
425     PaintRefresher.Refresh(this, av.getSequenceSetId());
426     // always send selection message when mouse is released
427     av.sendSelection();
428   }
429
430   public void highlightSearchResults(List<SequenceI> list)
431   {
432     idCanvas.setHighlighted(list);
433
434     if (list == null)
435     {
436       return;
437     }
438
439     int index = av.getAlignment().findIndex(list.get(0));
440
441     // do we need to scroll the panel?
442     if (av.getStartSeq() > index || av.getEndSeq() < index)
443     {
444       alignPanel.setScrollValues(av.getStartRes(), index);
445     }
446   }
447
448   // this class allows scrolling off the bottom of the visible alignment
449   class ScrollThread extends Thread
450   {
451     boolean running = false;
452
453     boolean up = true;
454
455     public ScrollThread(boolean up)
456     {
457       this.up = up;
458       start();
459     }
460
461     public void stopScrolling()
462     {
463       running = false;
464     }
465
466     @Override
467     public void run()
468     {
469       running = true;
470       while (running)
471       {
472         if (alignPanel.scrollUp(up))
473         {
474           // scroll was ok, so add new sequence to selection
475           int seq = av.getStartSeq();
476           if (!up)
477           {
478             seq = av.getEndSeq();
479           }
480
481           if (seq < lastid)
482           {
483             selectSeqs(lastid - 1, seq);
484           }
485           else if (seq > lastid && seq < av.getAlignment().getHeight())
486           {
487             selectSeqs(lastid + 1, seq);
488           }
489
490           lastid = seq;
491         }
492         else
493         {
494           running = false;
495         }
496
497         alignPanel.paintAlignment(true);
498         try
499         {
500           Thread.sleep(100);
501         } catch (Exception ex)
502         {
503         }
504       }
505     }
506   }
507 }