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.
21 package jalview.appletgui;
23 import jalview.api.FeatureColourI;
24 import jalview.datamodel.SearchResults;
25 import jalview.datamodel.SearchResultsI;
26 import jalview.datamodel.SequenceFeature;
27 import jalview.datamodel.SequenceI;
28 import jalview.io.FeaturesFile;
29 import jalview.schemes.FeatureColour;
30 import jalview.util.ColorUtils;
31 import jalview.util.MessageManager;
32 import jalview.viewmodel.AlignmentViewport;
34 import java.awt.BorderLayout;
35 import java.awt.Button;
36 import java.awt.Choice;
37 import java.awt.Color;
38 import java.awt.Dimension;
39 import java.awt.FlowLayout;
41 import java.awt.Frame;
42 import java.awt.Graphics;
43 import java.awt.GridLayout;
44 import java.awt.Label;
45 import java.awt.Panel;
46 import java.awt.ScrollPane;
47 import java.awt.TextArea;
48 import java.awt.TextField;
49 import java.awt.event.ActionEvent;
50 import java.awt.event.ActionListener;
51 import java.awt.event.MouseAdapter;
52 import java.awt.event.MouseEvent;
53 import java.awt.event.TextEvent;
54 import java.awt.event.TextListener;
55 import java.util.Hashtable;
56 import java.util.List;
64 public class FeatureRenderer extends
65 jalview.renderer.seqfeatures.FeatureRenderer
68 * creating a new feature defaults to the type and group as
69 * the last one created
71 static String lastFeatureAdded = "feature_1";
73 static String lastFeatureGroupAdded = "Jalview";
75 // Holds web links for feature groups and feature types
76 // in the form label|link
77 Hashtable featureLinks = null;
80 * Creates a new FeatureRenderer object.
84 public FeatureRenderer(AlignmentViewport av)
92 boolean deleteFeature = false;
94 FeatureColourPanel colourPanel;
96 class FeatureColourPanel extends Panel
100 private Color maxCol;
102 private boolean isColourByLabel, isGcol;
105 * render a feature style in the amend feature dialog box
107 public void updateColor(FeatureColourI newcol)
111 if (newcol.isSimpleColour())
113 bg = newcol.getColour();
118 if (newcol.isAboveThreshold())
122 else if (newcol.isBelowThreshold())
127 if (isColourByLabel = newcol.isColourByLabel())
129 setBackground(bg = Color.white);
130 vlabel += " (by Label)";
134 setBackground(bg = newcol.getMinColour());
135 maxCol = newcol.getMaxColour();
149 public void paint(Graphics g)
151 Dimension d = getSize();
156 g.setColor(Color.white);
157 g.fillRect(d.width / 2, 0, d.width / 2, d.height);
158 g.setColor(Color.black);
159 Font f = new Font("Verdana", Font.PLAIN, 10);
161 g.drawString(MessageManager.getString("label.label"), 0, 0);
166 g.fillRect(d.width / 2, 0, d.width / 2, d.height);
175 * Shows a dialog allowing the user to create, or amend or delete, sequence
176 * features. If null in the supplied feature(s), feature type and group
177 * default to those for the last feature created (with initial defaults of
178 * "feature_1" and "Jalview").
186 boolean amendFeatures(final List<SequenceI> sequences,
187 final List<SequenceFeature> features, boolean create,
188 final AlignmentPanel ap)
190 final Panel bigPanel = new Panel(new BorderLayout());
191 final TextField name = new TextField(16);
192 final TextField group = new TextField(16);
193 final TextArea description = new TextArea(3, 35);
194 final TextField start = new TextField(8);
195 final TextField end = new TextField(8);
196 final Choice overlaps;
197 Button deleteButton = new Button("Delete");
198 deleteFeature = false;
200 name.addTextListener(new TextListener()
203 public void textValueChanged(TextEvent e)
205 warnIfTypeHidden(ap.alignFrame, name.getText());
208 group.addTextListener(new TextListener()
211 public void textValueChanged(TextEvent e)
213 warnIfGroupHidden(ap.alignFrame, group.getText());
216 colourPanel = new FeatureColourPanel();
217 colourPanel.setSize(110, 15);
218 final FeatureRenderer fr = this;
220 Panel panel = new Panel(new GridLayout(3, 1));
222 featureIndex = 0; // feature to be amended.
225 // /////////////////////////////////////
226 // /MULTIPLE FEATURES AT SELECTED RESIDUE
227 if (!create && features.size() > 1)
229 panel = new Panel(new GridLayout(4, 1));
231 tmp.add(new Label("Select Feature: "));
232 overlaps = new Choice();
233 for (SequenceFeature sf : features)
235 String item = sf.getType() + "/" + sf.getBegin() + "-"
237 if (sf.getFeatureGroup() != null)
239 item += " (" + sf.getFeatureGroup() + ")";
241 overlaps.addItem(item);
246 overlaps.addItemListener(new java.awt.event.ItemListener()
249 public void itemStateChanged(java.awt.event.ItemEvent e)
251 int index = overlaps.getSelectedIndex();
254 featureIndex = index;
255 SequenceFeature sf = features.get(index);
256 name.setText(sf.getType());
257 description.setText(sf.getDescription());
258 group.setText(sf.getFeatureGroup());
259 start.setText(sf.getBegin() + "");
260 end.setText(sf.getEnd() + "");
262 SearchResultsI highlight = new SearchResults();
263 highlight.addResult(sequences.get(0), sf.getBegin(),
266 ap.seqPanel.seqCanvas.highlightSearchResults(highlight);
269 FeatureColourI col = getFeatureStyle(name.getText());
272 Color generatedColour = ColorUtils.createColourFromName(name
274 col = new FeatureColour(generatedColour);
277 colourPanel.updateColor(col);
284 // ////////////////////////////////////
288 tmp.add(new Label(MessageManager.getString("label.name:"), Label.RIGHT));
293 tmp.add(new Label(MessageManager.getString("label.group:"), Label.RIGHT));
298 tmp.add(new Label(MessageManager.getString("label.colour"), Label.RIGHT));
299 tmp.add(colourPanel);
301 bigPanel.add(panel, BorderLayout.NORTH);
304 panel.add(new Label(MessageManager.getString("label.description:"),
306 panel.add(new ScrollPane().add(description));
310 bigPanel.add(panel, BorderLayout.SOUTH);
313 panel.add(new Label(MessageManager.getString("label.start"),
316 panel.add(new Label(MessageManager.getString("label.end"),
319 bigPanel.add(panel, BorderLayout.CENTER);
323 bigPanel.add(panel, BorderLayout.CENTER);
327 * use defaults for type and group (and update them on Confirm) only
328 * if feature type has not been supplied by the caller
329 * (e.g. for Amend, or create features from Find)
331 SequenceFeature firstFeature = features.get(0);
332 boolean useLastDefaults = firstFeature.getType() == null;
333 String featureType = useLastDefaults ? lastFeatureAdded : firstFeature
335 String featureGroup = useLastDefaults ? lastFeatureGroupAdded
336 : firstFeature.getFeatureGroup();
338 String title = create ? MessageManager
339 .getString("label.create_new_sequence_features")
340 : MessageManager.formatMessage("label.amend_delete_features",
341 new String[] { sequences.get(0).getName() });
343 final JVDialog dialog = new JVDialog(ap.alignFrame, title, true, 385,
346 dialog.setMainPanel(bigPanel);
348 name.setText(featureType);
349 group.setText(featureGroup);
353 dialog.ok.setLabel(MessageManager.getString("label.amend"));
354 dialog.buttonPanel.add(deleteButton, 1);
355 deleteButton.addActionListener(new ActionListener()
358 public void actionPerformed(ActionEvent evt)
360 deleteFeature = true;
361 dialog.setVisible(false);
366 start.setText(firstFeature.getBegin() + "");
367 end.setText(firstFeature.getEnd() + "");
368 description.setText(firstFeature.getDescription());
369 // lookup (or generate) the feature colour
370 FeatureColourI fcol = getFeatureStyle(name.getText());
371 // simply display the feature color in a box
372 colourPanel.updateColor(fcol);
373 dialog.setResizable(true);
374 // TODO: render the graduated color in the box.
375 colourPanel.addMouseListener(new MouseAdapter()
378 public void mousePressed(MouseEvent evt)
380 if (!colourPanel.isGcol)
382 new UserDefinedColours(fr, ap.alignFrame);
386 new FeatureColourChooser(ap.alignFrame, name.getText());
387 dialog.transferFocus();
391 dialog.setVisible(true);
393 FeaturesFile ffile = new FeaturesFile();
396 * only update default type and group if we used defaults
398 String enteredType = name.getText().trim();
399 if (dialog.accept && useLastDefaults)
401 lastFeatureAdded = enteredType;
402 lastFeatureGroupAdded = group.getText().trim();
407 SequenceFeature sf = features.get(featureIndex);
410 sf.type = enteredType;
411 sf.featureGroup = group.getText().trim();
412 if (sf.featureGroup != null && sf.featureGroup.length() < 1)
414 sf.featureGroup = null;
416 sf.description = description.getText().replace('\n', ' ');
417 if (!colourPanel.isGcol)
419 // update colour - otherwise its already done.
420 setColour(sf.type, new FeatureColour(colourPanel.getBackground()));
424 sf.begin = Integer.parseInt(start.getText());
425 sf.end = Integer.parseInt(end.getText());
426 } catch (NumberFormatException ex)
430 boolean typeOrGroupChanged = (!featureType.equals(sf.type) || !featureGroup
431 .equals(sf.featureGroup));
433 ffile.parseDescriptionHTML(sf, false);
434 if (typeOrGroupChanged)
441 sequences.get(0).deleteFeature(sf);
442 // ensure Feature Settings reflects removal of feature / group
451 if (dialog.accept && name.getText().length() > 0)
453 for (int i = 0; i < sequences.size(); i++)
455 features.get(i).type = enteredType;
456 features.get(i).featureGroup = group.getText().trim();
457 features.get(i).description = description.getText()
459 sequences.get(i).addSequenceFeature(features.get(i));
460 ffile.parseDescriptionHTML(features.get(i), false);
463 Color newColour = colourPanel.getBackground();
464 // setColour(lastFeatureAdded, fcol);
466 setColour(enteredType, new FeatureColour(newColour)); // was fcol
471 // no update to the alignment
475 // refresh the alignment and the feature settings dialog
476 if (((jalview.appletgui.AlignViewport) av).featureSettings != null)
478 ((jalview.appletgui.AlignViewport) av).featureSettings.refreshTable();
480 // findAllFeatures();
482 ap.paintAlignment(true);
487 protected void warnIfGroupHidden(Frame frame, String group)
489 if (featureGroups.containsKey(group) && !featureGroups.get(group))
491 String msg = MessageManager.formatMessage("label.warning_hidden",
492 MessageManager.getString("label.group"), group);
493 showWarning(frame, msg);
497 protected void warnIfTypeHidden(Frame frame, String type)
499 if (getRenderOrder().contains(type))
501 if (!showFeatureOfType(type))
503 String msg = MessageManager.formatMessage("label.warning_hidden",
504 MessageManager.getString("label.feature_type"), type);
505 showWarning(frame, msg);
514 protected void showWarning(Frame frame, String msg)
516 JVDialog d = new JVDialog(frame, "", true, 350, 200);
517 Panel mp = new Panel();
518 d.ok.setLabel(MessageManager.getString("action.ok"));
519 d.cancel.setVisible(false);
520 mp.setLayout(new FlowLayout());
521 mp.add(new Label(msg));