b447214016021926e9ece39bf09108a093cd42a8
[jalview.git] / src / jalview / gui / Preferences.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 java.awt.BorderLayout;
24 import java.awt.Color;
25 import java.awt.Component;
26 import java.awt.Dimension;
27 import java.awt.Font;
28 import java.awt.event.ActionEvent;
29 import java.awt.event.ActionListener;
30 import java.awt.event.MouseEvent;
31 import java.io.File;
32 import java.util.ArrayList;
33 import java.util.List;
34
35 import javax.help.HelpSetException;
36 import javax.swing.JComboBox;
37 import javax.swing.JFileChooser;
38 import javax.swing.JInternalFrame;
39 import javax.swing.JPanel;
40 import javax.swing.ListSelectionModel;
41 import javax.swing.RowFilter;
42 import javax.swing.RowSorter;
43 import javax.swing.SortOrder;
44 import javax.swing.event.DocumentEvent;
45 import javax.swing.event.DocumentListener;
46 import javax.swing.event.ListSelectionEvent;
47 import javax.swing.event.ListSelectionListener;
48 import javax.swing.table.TableCellRenderer;
49 import javax.swing.table.TableColumn;
50 import javax.swing.table.TableModel;
51 import javax.swing.table.TableRowSorter;
52
53 import ext.edu.ucsf.rbvi.strucviz2.StructureManager;
54 import jalview.analysis.AnnotationSorter.SequenceAnnotationOrder;
55 import jalview.bin.Cache;
56 import jalview.ext.pymol.PymolManager;
57 import jalview.gui.Help.HelpId;
58 import jalview.gui.StructureViewer.ViewerType;
59 import jalview.io.BackupFiles;
60 import jalview.io.BackupFilesPresetEntry;
61 import jalview.io.FileFormatI;
62 import jalview.io.JalviewFileChooser;
63 import jalview.io.JalviewFileView;
64 import jalview.jbgui.GPreferences;
65 import jalview.jbgui.GSequenceLink;
66 import jalview.schemes.ColourSchemeI;
67 import jalview.schemes.ColourSchemes;
68 import jalview.schemes.ResidueColourScheme;
69 import jalview.urls.UrlLinkTableModel;
70 import jalview.urls.api.UrlProviderFactoryI;
71 import jalview.urls.api.UrlProviderI;
72 import jalview.urls.desktop.DesktopUrlProviderFactory;
73 import jalview.util.MessageManager;
74 import jalview.util.Platform;
75 import jalview.util.UrlConstants;
76 import jalview.ws.sifts.SiftsSettings;
77
78 /**
79  * DOCUMENT ME!
80  * 
81  * @author $author$
82  * @version $Revision$
83  */
84 /*
85  * for merge with Jalview-JS
86  public class Preferences extends GPreferences implements ApplicationSingletonI
87  */
88 public class Preferences extends GPreferences
89 {
90   public static final String ENABLE_SPLIT_FRAME = "ENABLE_SPLIT_FRAME";
91
92   public static final String SCALE_PROTEIN_TO_CDNA = "SCALE_PROTEIN_TO_CDNA";
93
94   public static final String DEFAULT_COLOUR = "DEFAULT_COLOUR";
95
96   public static final String DEFAULT_COLOUR_PROT = "DEFAULT_COLOUR_PROT";
97
98   public static final String DEFAULT_COLOUR_NUC = "DEFAULT_COLOUR_NUC";
99
100   public static final String ADD_TEMPFACT_ANN = "ADD_TEMPFACT_ANN";
101
102   public static final String ADD_SS_ANN = "ADD_SS_ANN";
103
104   public static final String USE_RNAVIEW = "USE_RNAVIEW";
105
106   public static final String STRUCT_FROM_PDB = "STRUCT_FROM_PDB";
107
108   public static final String STRUCTURE_DISPLAY = "STRUCTURE_DISPLAY";
109
110   public static final String CHIMERA_PATH = "CHIMERA_PATH";
111
112   public static final String CHIMERAX_PATH = "CHIMERAX_PATH";
113
114   public static final String PYMOL_PATH = "PYMOL_PATH";
115
116   public static final String SORT_ANNOTATIONS = "SORT_ANNOTATIONS";
117
118   public static final String SHOW_AUTOCALC_ABOVE = "SHOW_AUTOCALC_ABOVE";
119
120   public static final String SHOW_OCCUPANCY = "SHOW_OCCUPANCY";
121
122   public static final String SHOW_OV_HIDDEN_AT_START = "SHOW_OV_HIDDEN_AT_START";
123
124   public static final String USE_LEGACY_GAP = "USE_LEGACY_GAP";
125
126   public static final String GAP_COLOUR = "GAP_COLOUR";
127
128   public static final String HIDDEN_COLOUR = "HIDDEN_COLOUR";
129
130   private static final int MIN_FONT_SIZE = 1;
131
132   private static final int MAX_FONT_SIZE = 30;
133
134   private String previousProxyType;
135
136   private static Preferences INSTANCE = null; // add "final"
137
138   /**
139    * Holds name and link separated with | character. Sequence ID must be
140    * $SEQUENCE_ID$ or $SEQUENCE_ID=/.possible | chars ./=$
141    */
142   public static UrlProviderI sequenceUrlLinks;
143
144   public static UrlLinkTableModel dataModel;
145
146   /**
147    * Holds name and link separated with | character. Sequence IDS and Sequences
148    * must be $SEQUENCEIDS$ or $SEQUENCEIDS=/.possible | chars ./=$ and
149    * $SEQUENCES$ or $SEQUENCES=/.possible | chars ./=$ and separation character
150    * for first and second token specified after a pipe character at end |,|.
151    * (TODO: proper escape for using | to separate ids or sequences
152    */
153
154   public static List<String> groupURLLinks;
155   static
156   {
157     // get links selected to be in the menu (SEQUENCE_LINKS)
158     // and links entered by the user but not selected (STORED_LINKS)
159     String inMenuString = Cache.getDefault("SEQUENCE_LINKS", "");
160     String notInMenuString = Cache.getDefault("STORED_LINKS", "");
161     String defaultUrl = Cache.getDefault("DEFAULT_URL",
162             UrlConstants.DEFAULT_LABEL);
163
164     // if both links lists are empty, add the DEFAULT_URL link
165     // otherwise we assume the default link is in one of the lists
166     if (inMenuString.isEmpty() && notInMenuString.isEmpty())
167     {
168       inMenuString = UrlConstants.DEFAULT_STRING;
169     }
170     UrlProviderFactoryI factory = new DesktopUrlProviderFactory(defaultUrl,
171             inMenuString, notInMenuString);
172     sequenceUrlLinks = factory.createUrlProvider();
173     dataModel = new UrlLinkTableModel(sequenceUrlLinks);
174
175     /**
176      * TODO: reformulate groupURL encoding so two or more can be stored in the
177      * .properties file as '|' separated strings
178      */
179
180     groupURLLinks = new ArrayList<>();
181   }
182
183   JInternalFrame frame;
184
185   private WsPreferences wsPrefs;
186
187   private OptionsParam promptEachTimeOpt = new OptionsParam(
188           MessageManager.getString("label.prompt_each_time"),
189           "Prompt each time");
190
191   private OptionsParam lineArtOpt = new OptionsParam(
192           MessageManager.getString("label.lineart"), "Lineart");
193
194   private OptionsParam textOpt = new OptionsParam(
195           MessageManager.getString("action.text"), "Text");
196
197   // get singleton Preferences instance
198   public static Preferences getInstance()
199   {
200     if (INSTANCE == null || INSTANCE.frame == null
201             || INSTANCE.frame.isClosed())
202     {
203       INSTANCE = new Preferences();
204     }
205     return INSTANCE;
206
207     /*
208      * Replace code with the following for Jalvew-JS
209     Preferences INSTANCE = ApplicationSingletonProvider.getInstance(Preferences.class);
210     if (INSTANCE == null || INSTANCE.frame == null
211             || INSTANCE.frame.isClosed())
212     {
213       ApplicationSingletonProvider.remove(Preferences.class);
214       INSTANCE = ApplicationSingletonProvider.getInstance(Preferences.class);
215     }
216     return INSTANCE;
217     */
218   }
219
220   public static void openPreferences()
221   {
222     openPreferences(0, null);
223   }
224
225   public static void openPreferences(int selectTab, String message)
226   {
227     Preferences p = getInstance();
228     p.selectTab(selectTab);
229     p.setMessage(message);
230     p.frame.show();
231     p.frame.moveToFront();
232     p.frame.grabFocus();
233   }
234
235   /**
236    * Creates a new Preferences object.
237    */
238   private Preferences()
239   {
240     super();
241     frame = new JInternalFrame();
242     frame.setContentPane(this);
243     if (!Platform.isJS())
244     /**
245      * Java only
246      * 
247      * @j2sIgnore
248      */
249     {
250       wsPrefs = new WsPreferences();
251       wsTab.add(wsPrefs, BorderLayout.CENTER);
252     }
253     int width = 500, height = 450;
254     if (Platform.isAMacAndNotJS())
255     {
256       width = 570;
257       height = 480;
258     }
259
260     Desktop.addInternalFrame(frame,
261             MessageManager.getString("label.preferences"), width, height);
262     frame.setMinimumSize(new Dimension(width, height));
263
264     /*
265      * Set Visual tab defaults
266      */
267     seqLimit.setSelected(Cache.getDefault("SHOW_JVSUFFIX", true));
268     rightAlign.setSelected(Cache.getDefault("RIGHT_ALIGN_IDS", false));
269     fullScreen.setSelected(Cache.getDefault("SHOW_FULLSCREEN", false));
270     annotations.setSelected(Cache.getDefault("SHOW_ANNOTATIONS", true));
271
272     conservation.setSelected(Cache.getDefault("SHOW_CONSERVATION", true));
273     quality.setSelected(Cache.getDefault("SHOW_QUALITY", true));
274     identity.setSelected(Cache.getDefault("SHOW_IDENTITY", true));
275     openoverv.setSelected(Cache.getDefault("SHOW_OVERVIEW", false));
276     showUnconserved
277             .setSelected(Cache.getDefault("SHOW_UNCONSERVED", false));
278     showOccupancy.setSelected(Cache.getDefault(SHOW_OCCUPANCY, false));
279     showGroupConsensus
280             .setSelected(Cache.getDefault("SHOW_GROUP_CONSENSUS", false));
281     showGroupConservation.setSelected(
282             Cache.getDefault("SHOW_GROUP_CONSERVATION", false));
283     showConsensHistogram.setSelected(
284             Cache.getDefault("SHOW_CONSENSUS_HISTOGRAM", true));
285     showConsensLogo
286             .setSelected(Cache.getDefault("SHOW_CONSENSUS_LOGO", false));
287     showNpTooltip
288             .setSelected(Cache.getDefault("SHOW_NPFEATS_TOOLTIP", true));
289     showDbRefTooltip
290             .setSelected(Cache.getDefault("SHOW_DBREFS_TOOLTIP", true));
291
292     String[] fonts = java.awt.GraphicsEnvironment
293             .getLocalGraphicsEnvironment().getAvailableFontFamilyNames();
294     for (int i = 0; i < fonts.length; i++)
295     {
296       fontNameCB.addItem(fonts[i]);
297     }
298
299     for (int i = MIN_FONT_SIZE; i <= MAX_FONT_SIZE; i++)
300     {
301       fontSizeCB.addItem(i + "");
302     }
303
304     fontStyleCB.addItem("plain");
305     fontStyleCB.addItem("bold");
306     fontStyleCB.addItem("italic");
307
308     fontNameCB.setSelectedItem(Cache.getDefault("FONT_NAME", "SansSerif"));
309     fontSizeCB.setSelectedItem(Cache.getDefault("FONT_SIZE", "10"));
310     fontStyleCB.setSelectedItem(
311             Cache.getDefault("FONT_STYLE", Font.PLAIN + ""));
312
313     smoothFont.setSelected(Cache.getDefault("ANTI_ALIAS", true));
314     scaleProteinToCdna
315             .setSelected(Cache.getDefault(SCALE_PROTEIN_TO_CDNA, false));
316
317     idItalics.setSelected(Cache.getDefault("ID_ITALICS", true));
318
319     wrap.setSelected(Cache.getDefault("WRAP_ALIGNMENT", false));
320
321     gapSymbolCB.addItem("-");
322     gapSymbolCB.addItem(".");
323
324     gapSymbolCB.setSelectedItem(Cache.getDefault("GAP_SYMBOL", "-"));
325
326     sortby.addItem("No sort");
327     sortby.addItem("Id");
328     sortby.addItem("Pairwise Identity");
329     sortby.setSelectedItem(Cache.getDefault("SORT_ALIGNMENT", "No sort"));
330
331     sortAnnBy.addItem(SequenceAnnotationOrder.NONE.toString());
332     sortAnnBy
333             .addItem(SequenceAnnotationOrder.SEQUENCE_AND_LABEL.toString());
334     sortAnnBy
335             .addItem(SequenceAnnotationOrder.LABEL_AND_SEQUENCE.toString());
336     SequenceAnnotationOrder savedSort = SequenceAnnotationOrder
337             .valueOf(Cache.getDefault(SORT_ANNOTATIONS,
338                     SequenceAnnotationOrder.NONE.name()));
339     sortAnnBy.setSelectedItem(savedSort.toString());
340
341     sortAutocalc.addItem("Autocalculated first");
342     sortAutocalc.addItem("Autocalculated last");
343     final boolean showAbove = Cache.getDefault(SHOW_AUTOCALC_ABOVE, true);
344     sortAutocalc.setSelectedItem(showAbove ? sortAutocalc.getItemAt(0)
345             : sortAutocalc.getItemAt(1));
346     startupCheckbox
347             .setSelected(Cache.getDefault("SHOW_STARTUP_FILE", true));
348     startupFileTextfield.setText(Cache.getDefault("STARTUP_FILE",
349             Cache.getDefault("www.jalview.org", "http://www.jalview.org")
350                     + "/examples/exampleFile_2_3.jar"));
351
352     /*
353      * Set Colours tab defaults
354      */
355     protColour.addItem(ResidueColourScheme.NONE);
356     nucColour.addItem(ResidueColourScheme.NONE);
357     for (ColourSchemeI cs : ColourSchemes.getInstance().getColourSchemes())
358     {
359       String name = cs.getSchemeName();
360       protColour.addItem(name);
361       nucColour.addItem(name);
362     }
363     String oldProp = Cache.getDefault(DEFAULT_COLOUR,
364             ResidueColourScheme.NONE);
365     String newProp = Cache.getDefault(DEFAULT_COLOUR_PROT, null);
366     protColour.setSelectedItem(newProp != null ? newProp : oldProp);
367     newProp = Cache.getDefault(DEFAULT_COLOUR_NUC, null);
368     nucColour.setSelectedItem(newProp != null ? newProp : oldProp);
369     minColour.setBackground(
370             Cache.getDefaultColour("ANNOTATIONCOLOUR_MIN", Color.orange));
371     maxColour.setBackground(
372             Cache.getDefaultColour("ANNOTATIONCOLOUR_MAX", Color.red));
373
374     /*
375      * Set overview panel defaults
376      */
377     gapColour.setBackground(
378             Cache.getDefaultColour(GAP_COLOUR,
379                     jalview.renderer.OverviewResColourFinder.OVERVIEW_DEFAULT_GAP));
380     hiddenColour.setBackground(
381             Cache.getDefaultColour(HIDDEN_COLOUR,
382                     jalview.renderer.OverviewResColourFinder.OVERVIEW_DEFAULT_HIDDEN));
383     useLegacyGap.setSelected(Cache.getDefault(USE_LEGACY_GAP, false));
384     gapLabel.setEnabled(!useLegacyGap.isSelected());
385     gapColour.setEnabled(!useLegacyGap.isSelected());
386     showHiddenAtStart
387             .setSelected(Cache.getDefault(SHOW_OV_HIDDEN_AT_START, false));
388
389     /*
390      * Set Structure tab defaults
391      */
392     final boolean structSelected = Cache.getDefault(STRUCT_FROM_PDB, false);
393     structFromPdb.setSelected(structSelected);
394     useRnaView.setSelected(Cache.getDefault(USE_RNAVIEW, false));
395     useRnaView.setEnabled(structSelected);
396     addSecondaryStructure.setSelected(Cache.getDefault(ADD_SS_ANN, false));
397     addSecondaryStructure.setEnabled(structSelected);
398     addTempFactor.setSelected(Cache.getDefault(ADD_TEMPFACT_ANN, false));
399     addTempFactor.setEnabled(structSelected);
400
401     /*
402      * set choice of structure viewer, and path if saved as a preference;
403      * default to Jmol (first choice) if an unexpected value is found
404      */
405     String viewerType = Cache.getDefault(STRUCTURE_DISPLAY, ViewerType.JMOL.name());
406     structViewer.setSelectedItem(viewerType);
407     String viewerPath = "";
408     ViewerType type = null;
409     try
410     {
411       type = ViewerType.valueOf(viewerType);
412       switch (type)
413       {
414       case JMOL:
415         break;
416       case CHIMERA:
417         viewerPath = Cache.getDefault(CHIMERA_PATH, "");
418         break;
419       case CHIMERAX:
420         viewerPath = Cache.getDefault(CHIMERAX_PATH, "");
421         break;
422       case PYMOL:
423         viewerPath = Cache.getDefault(PYMOL_PATH, "");
424         break;
425       }
426     } catch (IllegalArgumentException e)
427     {
428       Cache.log.error("Unknown structure viewer type: " + viewerType
429               + ", defaulting to Jmol");
430       type = ViewerType.JMOL;
431     }
432     structureViewerPath.setText(viewerPath);
433
434     structureViewerPath.addActionListener(new ActionListener()
435     {
436       @Override
437       public void actionPerformed(ActionEvent e)
438       {
439         if (validateViewerPath())
440         {
441           Cache.setProperty(structViewer.getSelectedItem()
442                   .equals(ViewerType.CHIMERAX.name())
443                   ? CHIMERAX_PATH
444                   : CHIMERA_PATH, structureViewerPath.getText());
445         }
446       }
447     });
448
449     if (Cache.getDefault("MAP_WITH_SIFTS", false))
450     {
451       siftsMapping.setSelected(true);
452     }
453     else
454     {
455       nwMapping.setSelected(true);
456     }
457
458     SiftsSettings
459             .setMapWithSifts(Cache.getDefault("MAP_WITH_SIFTS", false));
460
461     /*
462      * Set Connections tab defaults
463      */
464
465     // set up sorting
466     linkUrlTable.setModel(dataModel);
467     final TableRowSorter<TableModel> sorter = new TableRowSorter<>(
468             linkUrlTable.getModel());
469     linkUrlTable.setRowSorter(sorter);
470     List<RowSorter.SortKey> sortKeys = new ArrayList<>();
471
472     UrlLinkTableModel m = (UrlLinkTableModel) linkUrlTable.getModel();
473     sortKeys.add(new RowSorter.SortKey(m.getPrimaryColumn(),
474             SortOrder.DESCENDING));
475     sortKeys.add(new RowSorter.SortKey(m.getSelectedColumn(),
476             SortOrder.DESCENDING));
477     sortKeys.add(
478             new RowSorter.SortKey(m.getNameColumn(), SortOrder.ASCENDING));
479
480     sorter.setSortKeys(sortKeys);
481     // BH 2018 setSortKeys will do the sort
482     // sorter.sort();
483
484     // set up filtering
485     ActionListener onReset;
486     onReset = new ActionListener()
487     {
488       @Override
489       public void actionPerformed(ActionEvent e)
490       {
491         filterTB.setText("");
492         sorter.setRowFilter(RowFilter.regexFilter(""));
493       }
494
495     };
496     doReset.addActionListener(onReset);
497
498     // filter to display only custom urls
499     final RowFilter<TableModel, Object> customUrlFilter = new RowFilter<TableModel, Object>()
500     {
501       @Override
502       public boolean include(
503               Entry<? extends TableModel, ? extends Object> entry)
504       {
505         return ((UrlLinkTableModel) entry.getModel()).isUserEntry(entry);
506       }
507     };
508
509     final TableRowSorter<TableModel> customSorter = new TableRowSorter<>(
510             linkUrlTable.getModel());
511     customSorter.setRowFilter(customUrlFilter);
512
513     ActionListener onCustomOnly;
514     onCustomOnly = new ActionListener()
515     {
516       @Override
517       public void actionPerformed(ActionEvent e)
518       {
519         filterTB.setText("");
520         sorter.setRowFilter(customUrlFilter);
521       }
522     };
523     userOnly.addActionListener(onCustomOnly);
524
525     filterTB.getDocument().addDocumentListener(new DocumentListener()
526     {
527       String caseInsensitiveFlag = "(?i)";
528
529       @Override
530       public void changedUpdate(DocumentEvent e)
531       {
532         sorter.setRowFilter(RowFilter
533                 .regexFilter(caseInsensitiveFlag + filterTB.getText()));
534       }
535
536       @Override
537       public void removeUpdate(DocumentEvent e)
538       {
539         sorter.setRowFilter(RowFilter
540                 .regexFilter(caseInsensitiveFlag + filterTB.getText()));
541       }
542
543       @Override
544       public void insertUpdate(DocumentEvent e)
545       {
546         sorter.setRowFilter(RowFilter
547                 .regexFilter(caseInsensitiveFlag + filterTB.getText()));
548       }
549     });
550
551     // set up list selection functionality
552     linkUrlTable.getSelectionModel()
553             .addListSelectionListener(new UrlListSelectionHandler());
554
555     // set up radio buttons
556     int onClickCol = ((UrlLinkTableModel) linkUrlTable.getModel())
557             .getPrimaryColumn();
558     String onClickName = linkUrlTable.getColumnName(onClickCol);
559     linkUrlTable.getColumn(onClickName)
560             .setCellRenderer(new RadioButtonRenderer());
561     linkUrlTable.getColumn(onClickName)
562             .setCellEditor(new RadioButtonEditor());
563
564     // get boolean columns and resize those to min possible
565     for (int column = 0; column < linkUrlTable.getColumnCount(); column++)
566     {
567       if (linkUrlTable.getModel().getColumnClass(column)
568               .equals(Boolean.class))
569       {
570         TableColumn tableColumn = linkUrlTable.getColumnModel()
571                 .getColumn(column);
572         int preferredWidth = tableColumn.getMinWidth();
573
574         TableCellRenderer cellRenderer = linkUrlTable.getCellRenderer(0,
575                 column);
576         Component c = linkUrlTable.prepareRenderer(cellRenderer, 0, column);
577         int cwidth = c.getPreferredSize().width
578                 + linkUrlTable.getIntercellSpacing().width;
579         preferredWidth = Math.max(preferredWidth, cwidth);
580
581         tableColumn.setPreferredWidth(preferredWidth);
582       }
583     }
584
585     String proxyTypeString = Cache.getDefault("USE_PROXY", "false");
586     previousProxyType = proxyTypeString;
587     switch (proxyTypeString)
588     {
589     case Cache.PROXYTYPE_NONE:
590       proxyType.setSelected(noProxy.getModel(), true);
591       break;
592     case Cache.PROXYTYPE_SYSTEM:
593       proxyType.setSelected(systemProxy.getModel(), true);
594       break;
595     case Cache.PROXYTYPE_CUSTOM:
596       proxyType.setSelected(customProxy.getModel(), true);
597       break;
598     default:
599       Cache.log.warn(
600               "Incorrect PROXY_TYPE - should be 'none' (clear proxy properties), 'false' (system settings), 'true' (custom settings): "
601                       + proxyTypeString);
602     }
603     proxyServerHttpTB.setText(Cache.getDefault("PROXY_SERVER", ""));
604     proxyPortHttpTB.setText(Cache.getDefault("PROXY_PORT", ""));
605     proxyServerHttpsTB.setText(Cache.getDefault("PROXY_SERVER_HTTPS", ""));
606     proxyPortHttpsTB.setText(Cache.getDefault("PROXY_PORT_HTTPS", ""));
607     proxyAuth.setSelected(Cache.getDefault("PROXY_AUTH", false));
608     proxyAuthUsernameTB
609             .setText(Cache.getDefault("PROXY_AUTH_USERNAME", ""));
610     // we are not storing or retrieving proxy password from .jalview_properties
611     proxyAuthPasswordPB.setText(Cache.proxyAuthPassword == null ? ""
612             : new String(Cache.proxyAuthPassword));
613     setCustomProxyEnabled();
614
615     defaultBrowser.setText(Cache.getDefault("DEFAULT_BROWSER", ""));
616
617     usagestats.setSelected(Cache.getDefault("USAGESTATS", false));
618     // note antisense here: default is true
619     questionnaire
620             .setSelected(Cache.getProperty("NOQUESTIONNAIRES") == null);
621     versioncheck.setSelected(Cache.getDefault("VERSION_CHECK", true));
622
623     /*
624      * Set Output tab defaults
625      */
626     setupOutputCombo(epsRendering, "EPS_RENDERING");
627     setupOutputCombo(htmlRendering, "HTML_RENDERING");
628     setupOutputCombo(svgRendering, "SVG_RENDERING");
629     autoIdWidth.setSelected(Cache.getDefault("FIGURE_AUTOIDWIDTH", false));
630     userIdWidth.setEnabled(!autoIdWidth.isSelected());
631     userIdWidthlabel.setEnabled(!autoIdWidth.isSelected());
632     Integer wi = Cache.getIntegerProperty("FIGURE_FIXEDIDWIDTH");
633     userIdWidth.setText(wi == null ? "" : wi.toString());
634     // TODO: refactor to use common enum via FormatAdapter and allow extension
635     // for new flat file formats
636     blcjv.setSelected(Cache.getDefault("BLC_JVSUFFIX", true));
637     clustaljv.setSelected(Cache.getDefault("CLUSTAL_JVSUFFIX", true));
638     fastajv.setSelected(Cache.getDefault("FASTA_JVSUFFIX", true));
639     msfjv.setSelected(Cache.getDefault("MSF_JVSUFFIX", true));
640     pfamjv.setSelected(Cache.getDefault("PFAM_JVSUFFIX", true));
641     pileupjv.setSelected(Cache.getDefault("PILEUP_JVSUFFIX", true));
642     pirjv.setSelected(Cache.getDefault("PIR_JVSUFFIX", true));
643     modellerOutput.setSelected(Cache.getDefault("PIR_MODELLER", false));
644     embbedBioJSON
645             .setSelected(Cache.getDefault("EXPORT_EMBBED_BIOJSON", true));
646
647     /*
648      * Set Editing tab defaults
649      */
650     autoCalculateConsCheck
651             .setSelected(Cache.getDefault("AUTO_CALC_CONSENSUS", true));
652     padGaps.setSelected(Cache.getDefault("PAD_GAPS", false));
653     sortByTree.setSelected(Cache.getDefault("SORT_BY_TREE", false));
654
655     annotations_actionPerformed(null); // update the display of the annotation
656                                        // settings
657     
658     
659     /*
660      * Set Backups tab defaults
661      */
662     loadLastSavedBackupsOptions();
663   }
664
665   /**
666    * A helper method that sets the items and initial selection in a character
667    * rendering option list (Prompt each time/Lineart/Text)
668    * 
669    * @param comboBox
670    * @param propertyKey
671    */
672   protected void setupOutputCombo(JComboBox<Object> comboBox,
673           String propertyKey)
674   {
675     comboBox.addItem(promptEachTimeOpt);
676     comboBox.addItem(lineArtOpt);
677     comboBox.addItem(textOpt);
678     
679     /*
680      * JalviewJS doesn't support Lineart so force it to Text
681      */
682     String defaultOption = Platform.isJS() ? "Text"
683             : Cache.getDefault(propertyKey, "Prompt each time");
684     if (defaultOption.equalsIgnoreCase("Text"))
685     {
686       comboBox.setSelectedItem(textOpt);
687     }
688     else if (defaultOption.equalsIgnoreCase("Lineart"))
689     {
690       comboBox.setSelectedItem(lineArtOpt);
691     }
692     else
693     {
694       comboBox.setSelectedItem(promptEachTimeOpt);
695     }
696   }
697
698   /**
699    * Save user selections on the Preferences tabs to the Cache and write out to
700    * file.
701    * 
702    * @param e
703    */
704   @Override
705   public void ok_actionPerformed(ActionEvent e)
706   {
707     if (!validateSettings())
708     {
709       return;
710     }
711
712     /* 
713      * Set proxy settings first (to be before web services refresh)
714      */
715     saveProxySettings();
716
717     /*
718      * Save Visual settings
719      */
720     Cache.applicationProperties.setProperty("SHOW_JVSUFFIX",
721             Boolean.toString(seqLimit.isSelected()));
722     Cache.applicationProperties.setProperty("RIGHT_ALIGN_IDS",
723             Boolean.toString(rightAlign.isSelected()));
724     Cache.applicationProperties.setProperty("SHOW_FULLSCREEN",
725             Boolean.toString(fullScreen.isSelected()));
726     Cache.applicationProperties.setProperty("SHOW_OVERVIEW",
727             Boolean.toString(openoverv.isSelected()));
728     Cache.applicationProperties.setProperty("SHOW_ANNOTATIONS",
729             Boolean.toString(annotations.isSelected()));
730     Cache.applicationProperties.setProperty("SHOW_CONSERVATION",
731             Boolean.toString(conservation.isSelected()));
732     Cache.applicationProperties.setProperty("SHOW_QUALITY",
733             Boolean.toString(quality.isSelected()));
734     Cache.applicationProperties.setProperty("SHOW_IDENTITY",
735             Boolean.toString(identity.isSelected()));
736
737     Cache.applicationProperties.setProperty("GAP_SYMBOL",
738             gapSymbolCB.getSelectedItem().toString());
739
740     Cache.applicationProperties.setProperty("FONT_NAME",
741             fontNameCB.getSelectedItem().toString());
742     Cache.applicationProperties.setProperty("FONT_STYLE",
743             fontStyleCB.getSelectedItem().toString());
744     Cache.applicationProperties.setProperty("FONT_SIZE",
745             fontSizeCB.getSelectedItem().toString());
746
747     Cache.applicationProperties.setProperty("ID_ITALICS",
748             Boolean.toString(idItalics.isSelected()));
749     Cache.applicationProperties.setProperty("SHOW_UNCONSERVED",
750             Boolean.toString(showUnconserved.isSelected()));
751     Cache.applicationProperties.setProperty(SHOW_OCCUPANCY,
752             Boolean.toString(showOccupancy.isSelected()));
753     Cache.applicationProperties.setProperty("SHOW_GROUP_CONSENSUS",
754             Boolean.toString(showGroupConsensus.isSelected()));
755     Cache.applicationProperties.setProperty("SHOW_GROUP_CONSERVATION",
756             Boolean.toString(showGroupConservation.isSelected()));
757     Cache.applicationProperties.setProperty("SHOW_CONSENSUS_HISTOGRAM",
758             Boolean.toString(showConsensHistogram.isSelected()));
759     Cache.applicationProperties.setProperty("SHOW_CONSENSUS_LOGO",
760             Boolean.toString(showConsensLogo.isSelected()));
761     Cache.applicationProperties.setProperty("ANTI_ALIAS",
762             Boolean.toString(smoothFont.isSelected()));
763     Cache.applicationProperties.setProperty(SCALE_PROTEIN_TO_CDNA,
764             Boolean.toString(scaleProteinToCdna.isSelected()));
765     Cache.applicationProperties.setProperty("SHOW_NPFEATS_TOOLTIP",
766             Boolean.toString(showNpTooltip.isSelected()));
767     Cache.applicationProperties.setProperty("SHOW_DBREFS_TOOLTIP",
768             Boolean.toString(showDbRefTooltip.isSelected()));
769
770     Cache.applicationProperties.setProperty("WRAP_ALIGNMENT",
771             Boolean.toString(wrap.isSelected()));
772
773     Cache.applicationProperties.setProperty("STARTUP_FILE",
774             startupFileTextfield.getText());
775     Cache.applicationProperties.setProperty("SHOW_STARTUP_FILE",
776             Boolean.toString(startupCheckbox.isSelected()));
777
778     Cache.applicationProperties.setProperty("SORT_ALIGNMENT",
779             sortby.getSelectedItem().toString());
780
781     // convert description of sort order to enum name for save
782     SequenceAnnotationOrder annSortOrder = SequenceAnnotationOrder
783             .forDescription(sortAnnBy.getSelectedItem().toString());
784     if (annSortOrder != null)
785     {
786       Cache.applicationProperties.setProperty(SORT_ANNOTATIONS,
787               annSortOrder.name());
788     }
789
790     final boolean showAutocalcFirst = sortAutocalc.getSelectedIndex() == 0;
791     Cache.applicationProperties.setProperty(SHOW_AUTOCALC_ABOVE,
792             Boolean.valueOf(showAutocalcFirst).toString());
793
794     /*
795      * Save Colours settings
796      */
797     Cache.applicationProperties.setProperty(DEFAULT_COLOUR_PROT,
798             protColour.getSelectedItem().toString());
799     Cache.applicationProperties.setProperty(DEFAULT_COLOUR_NUC,
800             nucColour.getSelectedItem().toString());
801     Cache.setColourProperty("ANNOTATIONCOLOUR_MIN",
802             minColour.getBackground());
803     Cache.setColourProperty("ANNOTATIONCOLOUR_MAX",
804             maxColour.getBackground());
805
806     /*
807      * Save Overview settings
808      */
809     Cache.setColourProperty(GAP_COLOUR, gapColour.getBackground());
810     Cache.setColourProperty(HIDDEN_COLOUR, hiddenColour.getBackground());
811     Cache.applicationProperties.setProperty(USE_LEGACY_GAP,
812             Boolean.toString(useLegacyGap.isSelected()));
813     Cache.applicationProperties.setProperty(SHOW_OV_HIDDEN_AT_START,
814             Boolean.toString(showHiddenAtStart.isSelected()));
815
816     /*
817      * Save Structure settings
818      */
819     Cache.applicationProperties.setProperty(ADD_TEMPFACT_ANN,
820             Boolean.toString(addTempFactor.isSelected()));
821     Cache.applicationProperties.setProperty(ADD_SS_ANN,
822             Boolean.toString(addSecondaryStructure.isSelected()));
823     Cache.applicationProperties.setProperty(USE_RNAVIEW,
824             Boolean.toString(useRnaView.isSelected()));
825     Cache.applicationProperties.setProperty(STRUCT_FROM_PDB,
826             Boolean.toString(structFromPdb.isSelected()));
827     String viewer = structViewer.getSelectedItem().toString();
828     String viewerPath = structureViewerPath.getText();
829     Cache.applicationProperties.setProperty(STRUCTURE_DISPLAY,
830             viewer);
831     if (viewer.equals(ViewerType.CHIMERA.name()))
832     {
833       Cache.setOrRemove(CHIMERA_PATH, viewerPath);
834     }
835     else if (viewer.equals(ViewerType.CHIMERAX.name()))
836     {
837       Cache.setOrRemove(CHIMERAX_PATH, viewerPath);
838     }
839     else if (viewer.equals(ViewerType.PYMOL.name()))
840     {
841       Cache.setOrRemove(PYMOL_PATH, viewerPath);
842     }
843     Cache.applicationProperties.setProperty("MAP_WITH_SIFTS",
844             Boolean.toString(siftsMapping.isSelected()));
845     SiftsSettings.setMapWithSifts(siftsMapping.isSelected());
846
847     /*
848      * Save Output settings
849      */
850     Cache.applicationProperties.setProperty("EPS_RENDERING",
851             ((OptionsParam) epsRendering.getSelectedItem()).getCode());
852     Cache.applicationProperties.setProperty("HTML_RENDERING",
853             ((OptionsParam) htmlRendering.getSelectedItem()).getCode());
854     Cache.applicationProperties.setProperty("SVG_RENDERING",
855             ((OptionsParam) svgRendering.getSelectedItem()).getCode());
856
857     /*
858      * Save Connections settings
859      */
860     // Proxy settings set first (to catch web services)
861
862     Cache.setOrRemove("DEFAULT_BROWSER", defaultBrowser.getText());
863
864     jalview.util.BrowserLauncher.resetBrowser();
865
866     // save user-defined and selected links
867     String menuLinks = sequenceUrlLinks.writeUrlsAsString(true);
868     if (menuLinks.isEmpty())
869     {
870       Cache.applicationProperties.remove("SEQUENCE_LINKS");
871     }
872     else
873     {
874       Cache.applicationProperties.setProperty("SEQUENCE_LINKS",
875               menuLinks.toString());
876     }
877
878     String nonMenuLinks = sequenceUrlLinks.writeUrlsAsString(false);
879     if (nonMenuLinks.isEmpty())
880     {
881       Cache.applicationProperties.remove("STORED_LINKS");
882     }
883     else
884     {
885       Cache.applicationProperties.setProperty("STORED_LINKS",
886               nonMenuLinks.toString());
887     }
888
889     Cache.applicationProperties.setProperty("DEFAULT_URL",
890             sequenceUrlLinks.getPrimaryUrlId());
891
892     Cache.setProperty("VERSION_CHECK",
893             Boolean.toString(versioncheck.isSelected()));
894     if (Cache.getProperty("USAGESTATS") != null || usagestats.isSelected())
895     {
896       // default is false - we only set this if the user has actively agreed
897       Cache.setProperty("USAGESTATS",
898               Boolean.toString(usagestats.isSelected()));
899     }
900     if (!questionnaire.isSelected())
901     {
902       Cache.setProperty("NOQUESTIONNAIRES", "true");
903     }
904     else
905     {
906       // special - made easy to edit a property file to disable questionnaires
907       // by just adding the given line
908       Cache.removeProperty("NOQUESTIONNAIRES");
909     }
910
911     /*
912      * Save Output settings
913      */
914     Cache.applicationProperties.setProperty("BLC_JVSUFFIX",
915             Boolean.toString(blcjv.isSelected()));
916     Cache.applicationProperties.setProperty("CLUSTAL_JVSUFFIX",
917             Boolean.toString(clustaljv.isSelected()));
918     Cache.applicationProperties.setProperty("FASTA_JVSUFFIX",
919             Boolean.toString(fastajv.isSelected()));
920     Cache.applicationProperties.setProperty("MSF_JVSUFFIX",
921             Boolean.toString(msfjv.isSelected()));
922     Cache.applicationProperties.setProperty("PFAM_JVSUFFIX",
923             Boolean.toString(pfamjv.isSelected()));
924     Cache.applicationProperties.setProperty("PILEUP_JVSUFFIX",
925             Boolean.toString(pileupjv.isSelected()));
926     Cache.applicationProperties.setProperty("PIR_JVSUFFIX",
927             Boolean.toString(pirjv.isSelected()));
928     Cache.applicationProperties.setProperty("PIR_MODELLER",
929             Boolean.toString(modellerOutput.isSelected()));
930     Cache.applicationProperties.setProperty("EXPORT_EMBBED_BIOJSON",
931             Boolean.toString(embbedBioJSON.isSelected()));
932     jalview.io.PIRFile.useModellerOutput = modellerOutput.isSelected();
933
934     Cache.applicationProperties.setProperty("FIGURE_AUTOIDWIDTH",
935             Boolean.toString(autoIdWidth.isSelected()));
936     userIdWidth_actionPerformed();
937     Cache.applicationProperties.setProperty("FIGURE_FIXEDIDWIDTH",
938             userIdWidth.getText());
939
940     /*
941      * Save Editing settings
942      */
943     Cache.applicationProperties.setProperty("AUTO_CALC_CONSENSUS",
944             Boolean.toString(autoCalculateConsCheck.isSelected()));
945     Cache.applicationProperties.setProperty("SORT_BY_TREE",
946             Boolean.toString(sortByTree.isSelected()));
947     Cache.applicationProperties.setProperty("PAD_GAPS",
948             Boolean.toString(padGaps.isSelected()));
949
950     if (!Platform.isJS())
951     {
952       wsPrefs.updateAndRefreshWsMenuConfig(false);
953     }
954
955     /*
956      * Save Backups settings
957      */
958     Cache.applicationProperties.setProperty(BackupFiles.ENABLED,
959             Boolean.toString(enableBackupFiles.isSelected()));
960     int preset = getComboIntStringKey(backupfilesPresetsCombo);
961     Cache.applicationProperties.setProperty(BackupFiles.NS + "_PRESET", Integer.toString(preset));
962
963     if (preset == BackupFilesPresetEntry.BACKUPFILESSCHEMECUSTOM)
964     {
965       BackupFilesPresetEntry customBFPE = getBackupfilesCurrentEntry();
966       BackupFilesPresetEntry.backupfilesPresetEntriesValues.put(
967               BackupFilesPresetEntry.BACKUPFILESSCHEMECUSTOM, customBFPE);
968       Cache.applicationProperties
969               .setProperty(BackupFilesPresetEntry.CUSTOMCONFIG,
970                       customBFPE.toString());
971     }
972
973     BackupFilesPresetEntry savedBFPE = BackupFilesPresetEntry.backupfilesPresetEntriesValues
974             .get(preset);
975     Cache.applicationProperties.setProperty(
976             BackupFilesPresetEntry.SAVEDCONFIG, savedBFPE.toString());
977
978     Cache.saveProperties();
979     Desktop.instance.doConfigureStructurePrefs();
980     try
981     {
982       frame.setClosed(true);
983     } catch (Exception ex)
984     {
985     }
986   }
987
988   public void saveProxySettings()
989   {
990     String newProxyType = customProxy.isSelected() ? Cache.PROXYTYPE_CUSTOM
991             : noProxy.isSelected() ? Cache.PROXYTYPE_NONE
992                     : Cache.PROXYTYPE_SYSTEM;
993     Cache.applicationProperties.setProperty("USE_PROXY", newProxyType);
994     Cache.setOrRemove("PROXY_SERVER", proxyServerHttpTB.getText());
995     Cache.setOrRemove("PROXY_PORT", proxyPortHttpTB.getText());
996     Cache.setOrRemove("PROXY_SERVER_HTTPS", proxyServerHttpsTB.getText());
997     Cache.setOrRemove("PROXY_PORT_HTTPS", proxyPortHttpsTB.getText());
998     Cache.setOrRemove("PROXY_AUTH",
999             Boolean.toString(proxyAuth.isSelected()));
1000     Cache.setOrRemove("PROXY_AUTH_USERNAME", proxyAuthUsernameTB.getText());
1001     Cache.proxyAuthPassword = proxyAuthPasswordPB.getPassword();
1002     Cache.setProxyPropertiesFromPreferences(previousProxyType);
1003     if (newProxyType.equals(Cache.PROXYTYPE_CUSTOM)
1004             || !newProxyType.equals(previousProxyType))
1005     {
1006       // force a re-lookup of ws if proxytype is custom or has changed
1007       wsPrefs.update++;
1008     }
1009     previousProxyType = newProxyType;
1010   }
1011
1012   /**
1013    * Do any necessary validation before saving settings. Return focus to the
1014    * first tab which fails validation.
1015    * 
1016    * @return
1017    */
1018   private boolean validateSettings()
1019   {
1020     if (!validateStructure())
1021     {
1022       structureTab.requestFocusInWindow();
1023       return false;
1024     }
1025     return true;
1026   }
1027
1028   @Override
1029   protected boolean validateStructure()
1030   {
1031     return validateViewerPath();
1032
1033   }
1034
1035   /**
1036    * DOCUMENT ME!
1037    */
1038   @Override
1039   public void startupFileTextfield_mouseClicked()
1040   {
1041     // TODO: JAL-3048 not needed for Jalview-JS
1042     String fileFormat = Cache.getProperty("DEFAULT_FILE_FORMAT");
1043     JalviewFileChooser chooser = JalviewFileChooser
1044             .forRead(Cache.getProperty("LAST_DIRECTORY"), fileFormat);
1045     chooser.setFileView(new JalviewFileView());
1046     chooser.setDialogTitle(
1047             MessageManager.getString("label.select_startup_file"));
1048
1049     int value = chooser.showOpenDialog(this);
1050
1051     if (value == JalviewFileChooser.APPROVE_OPTION)
1052     {
1053       FileFormatI format = chooser.getSelectedFormat();
1054       if (format != null)
1055       {
1056         Cache.applicationProperties.setProperty("DEFAULT_FILE_FORMAT",
1057                 format.getName());
1058       }
1059       startupFileTextfield
1060               .setText(chooser.getSelectedFile().getAbsolutePath());
1061     }
1062   }
1063
1064   /**
1065    * DOCUMENT ME!
1066    * 
1067    * @param e
1068    *          DOCUMENT ME!
1069    */
1070   @Override
1071   public void cancel_actionPerformed(ActionEvent e)
1072   {
1073     try
1074     {
1075       if (!Platform.isJS())
1076       {
1077         wsPrefs.updateWsMenuConfig(true);
1078         wsPrefs.refreshWs_actionPerformed(e);
1079       }
1080       frame.setClosed(true);
1081     } catch (Exception ex)
1082     {
1083     }
1084   }
1085
1086   /**
1087    * DOCUMENT ME!
1088    * 
1089    * @param e
1090    *          DOCUMENT ME!
1091    */
1092   @Override
1093   public void annotations_actionPerformed(ActionEvent e)
1094   {
1095     conservation.setEnabled(annotations.isSelected());
1096     quality.setEnabled(annotations.isSelected());
1097     identity.setEnabled(annotations.isSelected());
1098     showOccupancy.setEnabled(annotations.isSelected());
1099     showGroupConsensus.setEnabled(annotations.isSelected());
1100     showGroupConservation.setEnabled(annotations.isSelected());
1101     showConsensHistogram.setEnabled(annotations.isSelected()
1102             && (identity.isSelected() || showGroupConsensus.isSelected()));
1103     showConsensLogo.setEnabled(annotations.isSelected()
1104             && (identity.isSelected() || showGroupConsensus.isSelected()));
1105   }
1106
1107   @Override
1108   public void newLink_actionPerformed(ActionEvent e)
1109   {
1110     GSequenceLink link = new GSequenceLink();
1111     boolean valid = false;
1112     while (!valid)
1113     {
1114       if (JvOptionPane.showInternalConfirmDialog(Desktop.desktop, link,
1115               MessageManager.getString("label.new_sequence_url_link"),
1116               JvOptionPane.OK_CANCEL_OPTION, -1,
1117               null) == JvOptionPane.OK_OPTION)
1118       {
1119         if (link.checkValid())
1120         {
1121           if (((UrlLinkTableModel) linkUrlTable.getModel())
1122                   .isUniqueName(link.getName()))
1123           {
1124             ((UrlLinkTableModel) linkUrlTable.getModel())
1125                     .insertRow(link.getName(), link.getURL());
1126             valid = true;
1127           }
1128           else
1129           {
1130             link.notifyDuplicate();
1131             continue;
1132           }
1133         }
1134       }
1135       else
1136       {
1137         break;
1138       }
1139     }
1140   }
1141
1142   @Override
1143   public void editLink_actionPerformed(ActionEvent e)
1144   {
1145     GSequenceLink link = new GSequenceLink();
1146
1147     int index = linkUrlTable.getSelectedRow();
1148     if (index == -1)
1149     {
1150       // button no longer enabled if row is not selected
1151       Cache.log.debug("Edit with no row selected in linkUrlTable");
1152       return;
1153     }
1154
1155     int nameCol = ((UrlLinkTableModel) linkUrlTable.getModel())
1156             .getNameColumn();
1157     int urlCol = ((UrlLinkTableModel) linkUrlTable.getModel())
1158             .getUrlColumn();
1159     String oldName = linkUrlTable.getValueAt(index, nameCol).toString();
1160     link.setName(oldName);
1161     link.setURL(linkUrlTable.getValueAt(index, urlCol).toString());
1162
1163     boolean valid = false;
1164     while (!valid)
1165     {
1166       if (JvOptionPane.showInternalConfirmDialog(Desktop.desktop, link,
1167               MessageManager.getString("label.edit_sequence_url_link"),
1168               JvOptionPane.OK_CANCEL_OPTION, -1,
1169               null) == JvOptionPane.OK_OPTION)
1170       {
1171         if (link.checkValid())
1172         {
1173           if ((oldName.equals(link.getName()))
1174                   || (((UrlLinkTableModel) linkUrlTable.getModel())
1175                           .isUniqueName(link.getName())))
1176           {
1177             linkUrlTable.setValueAt(link.getName(), index, nameCol);
1178             linkUrlTable.setValueAt(link.getURL(), index, urlCol);
1179             valid = true;
1180           }
1181           else
1182           {
1183             link.notifyDuplicate();
1184             continue;
1185           }
1186         }
1187       }
1188       else
1189       {
1190         break;
1191       }
1192     }
1193   }
1194
1195   @Override
1196   public void deleteLink_actionPerformed(ActionEvent e)
1197   {
1198     int index = linkUrlTable.getSelectedRow();
1199     int modelIndex = -1;
1200     if (index == -1)
1201     {
1202       // button no longer enabled if row is not selected
1203       Cache.log.debug("Delete with no row selected in linkUrlTable");
1204       return;
1205     }
1206     else
1207     {
1208       modelIndex = linkUrlTable.convertRowIndexToModel(index);
1209     }
1210
1211     // make sure we use the model index to delete, and not the table index
1212     ((UrlLinkTableModel) linkUrlTable.getModel()).removeRow(modelIndex);
1213   }
1214
1215   @Override
1216   public void defaultBrowser_mouseClicked(MouseEvent e)
1217   {
1218     // TODO: JAL-3048 not needed for j2s
1219     if (!Platform.isJS()) // BH 2019
1220     /**
1221      * Java only
1222      * 
1223      * @j2sIgnore
1224      */
1225     {
1226       JFileChooser chooser = new JFileChooser(".");
1227       chooser.setDialogTitle(
1228               MessageManager.getString("label.select_default_browser"));
1229
1230       int value = chooser.showOpenDialog(this);
1231
1232       if (value == JFileChooser.APPROVE_OPTION)
1233       {
1234         defaultBrowser.setText(chooser.getSelectedFile().getAbsolutePath());
1235       }
1236     }
1237   }
1238
1239   /*
1240    * (non-Javadoc)
1241    * 
1242    * @see
1243    * jalview.jbgui.GPreferences#showunconserved_actionPerformed(java.awt.event
1244    * .ActionEvent)
1245    */
1246   @Override
1247   protected void showunconserved_actionPerformed(ActionEvent e)
1248   {
1249     // TODO Auto-generated method stub
1250     super.showunconserved_actionPerformed(e);
1251   }
1252
1253   public static List<String> getGroupURLLinks()
1254   {
1255     return groupURLLinks;
1256   }
1257
1258   @Override
1259   public void minColour_actionPerformed(JPanel panel)
1260   {
1261     JalviewColourChooser.showColourChooser(this,
1262             MessageManager.getString("label.select_colour_minimum_value"),
1263             panel);
1264   }
1265
1266   @Override
1267   public void maxColour_actionPerformed(JPanel panel)
1268   {
1269     JalviewColourChooser.showColourChooser(this,
1270             MessageManager.getString("label.select_colour_maximum_value"),
1271             panel);
1272   }
1273
1274   @Override
1275   public void gapColour_actionPerformed(JPanel gap)
1276   {
1277     if (!useLegacyGap.isSelected())
1278     {
1279       JalviewColourChooser.showColourChooser(this,
1280               MessageManager.getString("label.select_gap_colour"),
1281               gap);
1282     }
1283   }
1284
1285   @Override
1286   public void hiddenColour_actionPerformed(JPanel hidden)
1287   {
1288     JalviewColourChooser.showColourChooser(this,
1289             MessageManager.getString("label.select_hidden_colour"),
1290             hidden);
1291   }
1292
1293   @Override
1294   protected void useLegacyGaps_actionPerformed(ActionEvent e)
1295   {
1296     boolean enabled = useLegacyGap.isSelected();
1297     if (enabled)
1298     {
1299       gapColour.setBackground(
1300               jalview.renderer.OverviewResColourFinder.OVERVIEW_DEFAULT_LEGACY_GAP);
1301     }
1302     else
1303     {
1304       gapColour.setBackground(
1305               jalview.renderer.OverviewResColourFinder.OVERVIEW_DEFAULT_GAP);
1306     }
1307     gapColour.setEnabled(!enabled);
1308     gapLabel.setEnabled(!enabled);
1309   }
1310
1311   @Override
1312   protected void resetOvDefaults_actionPerformed(ActionEvent e)
1313   {
1314     useLegacyGap.setSelected(false);
1315     useLegacyGaps_actionPerformed(null);
1316     showHiddenAtStart.setSelected(false);
1317     hiddenColour.setBackground(
1318             jalview.renderer.OverviewResColourFinder.OVERVIEW_DEFAULT_HIDDEN);
1319   }
1320
1321   @Override
1322   protected void userIdWidth_actionPerformed()
1323   {
1324     try
1325     {
1326       String val = userIdWidth.getText().trim();
1327       if (val.length() > 0)
1328       {
1329         Integer iw = Integer.parseInt(val);
1330         if (iw.intValue() < 12)
1331         {
1332           throw new NumberFormatException();
1333         }
1334         userIdWidth.setText(iw.toString());
1335       }
1336     } catch (NumberFormatException x)
1337     {
1338       userIdWidth.setText("");
1339       JvOptionPane.showInternalMessageDialog(Desktop.desktop,
1340               MessageManager
1341                       .getString("warn.user_defined_width_requirements"),
1342               MessageManager.getString("label.invalid_id_column_width"),
1343               JvOptionPane.WARNING_MESSAGE);
1344     }
1345   }
1346
1347   @Override
1348   protected void autoIdWidth_actionPerformed()
1349   {
1350     userIdWidth.setEnabled(!autoIdWidth.isSelected());
1351     userIdWidthlabel.setEnabled(!autoIdWidth.isSelected());
1352   }
1353
1354   /**
1355    * Returns true if structure viewer path is to a valid executable, else shows
1356    * an error dialog. Does nothing if the path is empty, as is the case for Jmol
1357    * (built in to Jalview) or when Jalview is left to try default paths.
1358    */
1359   private boolean validateViewerPath()
1360   {
1361     if (structureViewerPath.getText().trim().length() > 0)
1362     {
1363       File f = new File(structureViewerPath.getText());
1364       if (!f.canExecute())
1365       {
1366         JvOptionPane.showInternalMessageDialog(Desktop.desktop,
1367                 MessageManager.getString("label.invalid_viewer_path"),
1368                 MessageManager.getString("label.invalid_viewer_path"),
1369                 JvOptionPane.ERROR_MESSAGE);
1370         return false;
1371       }
1372     }
1373     return true;
1374   }
1375
1376   /**
1377    * If Chimera or ChimeraX or Pymol is selected, check it can be found on
1378    * default or user-specified path, if not show a warning/help dialog
1379    */
1380   @Override
1381   protected void structureViewer_actionPerformed(String selectedItem)
1382   {
1383     if (selectedItem.equals(ViewerType.JMOL.name()))
1384     {
1385       structureViewerPath.setEnabled(false);
1386       structureViewerPathLabel.setEnabled(false);
1387       return;
1388     }
1389     boolean found = false;
1390     structureViewerPath.setEnabled(true);
1391     structureViewerPathLabel.setEnabled(true);
1392     structureViewerPathLabel.setText(MessageManager
1393             .formatMessage("label.viewer_path", selectedItem));
1394
1395     /*
1396      * Try user-specified and standard paths for structure viewer executable
1397      */
1398     String viewerPath = "";
1399     List<String> paths = null;
1400     try
1401     {
1402       ViewerType viewerType = ViewerType.valueOf(selectedItem);
1403       switch (viewerType)
1404       {
1405       case JMOL:
1406         // dealt with above
1407         break;
1408       case CHIMERA:
1409         viewerPath = Cache.getDefault(CHIMERA_PATH, "");
1410         paths = StructureManager.getChimeraPaths(false);
1411         break;
1412       case CHIMERAX:
1413         viewerPath = Cache.getDefault(CHIMERAX_PATH, "");
1414         paths = StructureManager.getChimeraPaths(true);
1415         break;
1416       case PYMOL:
1417         viewerPath = Cache.getDefault(PYMOL_PATH, "");
1418         paths = PymolManager.getPymolPaths();
1419         break;
1420       }
1421     } catch (IllegalArgumentException e)
1422     {
1423       // only valid entries should be in the drop-down
1424     }
1425     structureViewerPath.setText(viewerPath);
1426
1427     paths.add(0, structureViewerPath.getText());
1428     for (String path : paths)
1429     {
1430       if (new File(path.trim()).canExecute())
1431       {
1432         found = true;
1433         break;
1434       }
1435     }
1436
1437     if (!found)
1438     {
1439       String[] options = { "OK", "Help" };
1440       int showHelp = JvOptionPane.showInternalOptionDialog(Desktop.desktop,
1441               JvSwingUtils.wrapTooltip(true,
1442                       MessageManager.getString("label.viewer_missing")),
1443               "", JvOptionPane.YES_NO_OPTION, JvOptionPane.WARNING_MESSAGE,
1444               null, options, options[0]);
1445       if (showHelp == JvOptionPane.NO_OPTION)
1446       {
1447         try
1448         {
1449           Help.showHelpWindow(HelpId.StructureViewer);
1450         } catch (HelpSetException e)
1451         {
1452           e.printStackTrace();
1453         }
1454       }
1455     }
1456   }
1457
1458   public class OptionsParam
1459   {
1460     private String name;
1461
1462     private String code;
1463
1464     public OptionsParam(String name, String code)
1465     {
1466       this.name = name;
1467       this.code = code;
1468     }
1469
1470     public String getName()
1471     {
1472       return name;
1473     }
1474
1475     public void setName(String name)
1476     {
1477       this.name = name;
1478     }
1479
1480     public String getCode()
1481     {
1482       return code;
1483     }
1484
1485     public void setCode(String code)
1486     {
1487       this.code = code;
1488     }
1489
1490     @Override
1491     public String toString()
1492     {
1493       return name;
1494     }
1495
1496     @Override
1497     public boolean equals(Object that)
1498     {
1499       if (!(that instanceof OptionsParam))
1500       {
1501         return false;
1502       }
1503       return this.code.equalsIgnoreCase(((OptionsParam) that).code);
1504     }
1505
1506     @Override
1507     public int hashCode()
1508     {
1509       return name.hashCode() + code.hashCode();
1510     }
1511   }
1512
1513   private class UrlListSelectionHandler implements ListSelectionListener
1514   {
1515
1516     @Override
1517     public void valueChanged(ListSelectionEvent e)
1518     {
1519       ListSelectionModel lsm = (ListSelectionModel) e.getSource();
1520
1521       int index = lsm.getMinSelectionIndex();
1522       if (index == -1)
1523       {
1524         // no selection, so disable delete/edit buttons
1525         editLink.setEnabled(false);
1526         deleteLink.setEnabled(false);
1527         return;
1528       }
1529       int modelIndex = linkUrlTable.convertRowIndexToModel(index);
1530
1531       // enable/disable edit and delete link buttons
1532       if (((UrlLinkTableModel) linkUrlTable.getModel())
1533               .isRowDeletable(modelIndex))
1534       {
1535         deleteLink.setEnabled(true);
1536       }
1537       else
1538       {
1539         deleteLink.setEnabled(false);
1540       }
1541
1542       if (((UrlLinkTableModel) linkUrlTable.getModel())
1543               .isRowEditable(modelIndex))
1544       {
1545         editLink.setEnabled(true);
1546       }
1547       else
1548       {
1549         editLink.setEnabled(false);
1550       }
1551     }
1552   }
1553 }