JAL-591 reduced updating by checking/setting 'updating' flag
[jalview.git] / src / jalview / gui / OptsAndParamsPage.java
index 0d12347..dcd07ef 100644 (file)
@@ -20,9 +20,6 @@
  */
 package jalview.gui;
 
-import static jalview.ws.params.simple.LogarithmicParameter.LOGSLIDERSCALE;
-
-import jalview.bin.Cache;
 import jalview.util.MessageManager;
 import jalview.ws.params.ArgumentI;
 import jalview.ws.params.OptionI;
@@ -33,6 +30,7 @@ import jalview.ws.params.simple.LogarithmicParameter;
 import jalview.ws.params.simple.StringParameter;
 
 import java.awt.BorderLayout;
+import java.awt.Color;
 import java.awt.Component;
 import java.awt.Dimension;
 import java.awt.FlowLayout;
@@ -103,7 +101,7 @@ public class OptsAndParamsPage
   public class OptionBox extends JPanel
           implements MouseListener, ActionListener
   {
-    JCheckBox enabled = new JCheckBox();
+    JCheckBox enabled;
 
     final URL finfo;
 
@@ -115,14 +113,13 @@ public class OptsAndParamsPage
 
     OptionI option;
 
-    JLabel optlabel = new JLabel();
-
-    JComboBox<String> val = new JComboBox<>();
+    JComboBox<String> val;
 
     public OptionBox(OptionI opt)
     {
       option = opt;
       setLayout(new FlowLayout(FlowLayout.LEFT));
+      enabled = new JCheckBox();
       enabled.setSelected(opt.isRequired()); // TODO: lock required options
       enabled.setFont(new Font("Verdana", Font.PLAIN, 11));
       enabled.setText("");
@@ -151,6 +148,9 @@ public class OptsAndParamsPage
         }
       }
       add(enabled);
+
+      // todo combo or radio buttons?
+      val = new JComboBox<>();
       for (String str : opt.getPossibleValues())
       {
         val.addItem(str);
@@ -304,7 +304,11 @@ public class OptsAndParamsPage
   public class ParamBox extends JPanel
           implements ChangeListener, ActionListener, MouseListener
   {
-    private static final float SLIDERSCALE = 1000f;
+    /*
+     * parameter values (or their logs) are multiplied by this
+     * scaling factor to ensure an integer range for the slider
+     */
+    private int sliderScaleFactor = 1;
 
     boolean isLogarithmicParameter;
 
@@ -312,6 +316,8 @@ public class OptsAndParamsPage
 
     boolean isIntegerParameter;
 
+    boolean isStringParameter;
+
     boolean adjusting;
 
     JComboBox<String> choicebox;
@@ -349,19 +355,39 @@ public class OptsAndParamsPage
       finfo = parm.getFurtherDetails();
       validator = parm.getValidValue();
       parameter = parm;
+
+      isLogarithmicParameter = parm instanceof LogarithmicParameter;
+
       if (validator != null)
       {
-        isIntegerParameter = validator.getType() == ValueType.Integer;
-      }
-      else if (parameter.getPossibleValues() != null)
-      {
-        isChoiceParameter = true;
-      }
-      if (parm instanceof LogarithmicParameter)
-      {
-        isLogarithmicParameter = true;
+        ValueType type = validator.getType();
+        isIntegerParameter = type == ValueType.Integer;
+        isStringParameter = type == ValueType.String;
+
+        /*
+         * ensure slider has an integer range corresponding to
+         * the min-max range of the parameter
+         */
+        if (validator.getMin() != null && validator.getMax() != null
+        // && !isIntegerParameter
+                && !isStringParameter)
+        {
+          double min = validator.getMin().doubleValue();
+          double max = validator.getMax().doubleValue();
+          if (isLogarithmicParameter)
+          {
+            min = Math.log(min);
+            max = Math.log(max);
+          }
+          sliderScaleFactor = (int) (1000000 / (max - min));
+          // todo scaleMin, scaleMax could also be final fields
+        }
       }
 
+      List<String> possibleValues = parameter.getPossibleValues();
+      isChoiceParameter = possibleValues != null
+              && !possibleValues.isEmpty();
+
       if (compact)
       {
         addCompactParameter(parm);
@@ -526,13 +552,23 @@ public class OptsAndParamsPage
      */
     private void checkIfModified()
     {
-      Object newValue = updateSliderFromValueField();
-      boolean modified = true;
-      if (newValue.getClass() == lastVal.getClass())
+      if (!adjusting)
       {
-        modified = !newValue.equals(lastVal);
+        try
+        {
+          adjusting = true;
+          Object newValue = updateSliderFromValueField();
+          boolean modified = true;
+          if (newValue.getClass() == lastVal.getClass())
+          {
+            modified = !newValue.equals(lastVal);
+          }
+          pmdialogbox.argSetModified(this, modified);
+        } finally
+        {
+          adjusting = false;
+        }
       }
-      pmdialogbox.argSetModified(this, modified);
     }
 
     @Override
@@ -582,15 +618,11 @@ public class OptsAndParamsPage
     @Override
     public void mouseEntered(MouseEvent e)
     {
-      // TODO Auto-generated method stub
-
     }
 
     @Override
     public void mouseExited(MouseEvent e)
     {
-      // TODO Auto-generated method stub
-
     }
 
     @Override
@@ -605,32 +637,39 @@ public class OptsAndParamsPage
     @Override
     public void mouseReleased(MouseEvent e)
     {
-      // TODO Auto-generated method stub
-
     }
 
     @Override
     public void stateChanged(ChangeEvent e)
     {
-      if (!adjusting)
+      if (adjusting)
       {
+        return;
+      }
+      try
+      {
+        adjusting = true;
         if (!isLogarithmicParameter)
         {
           /*
            * set (int or float formatted) text field value
            */
-          valueField.setText(isIntegerParameter ? String.valueOf(slider.getValue())
-                  : String.valueOf(slider.getValue() / SLIDERSCALE));
+          valueField.setText(isIntegerParameter
+                  ? String.valueOf(slider.getValue())
+                  : formatDouble(
+                          slider.getValue() / (float) sliderScaleFactor));
         }
         else
         {
-          double base = ((LogarithmicParameter) parameter).getBase();
-          double value = Math.pow(base, slider.getValue() / LOGSLIDERSCALE);
+          double value = Math.pow(Math.E,
+                  slider.getValue() / (double) sliderScaleFactor);
           valueField.setText(formatDouble(value));
         }
         checkIfModified();
+      } finally
+      {
+        adjusting = false;
       }
-
     }
 
     /**
@@ -642,10 +681,22 @@ public class OptsAndParamsPage
      */
     String formatDouble(double value)
     {
-      String format = value < 0.001 ? "%3.3e" : "%3.3f";
+      String format = value < 0.001 ? "%3.1E" : "%3.3f";
       return String.format(format, value);
     }
 
+    /**
+     * Formats a number as integer or float (3dp) or scientific notation (1dp)
+     * 
+     * @param n
+     * @return
+     */
+    String formatNumber(Number n)
+    {
+      return n instanceof Integer ? String.valueOf(n.intValue())
+              : formatDouble(n.doubleValue());
+    }
+
     void updateControls(ParameterI parm)
     {
       adjusting = true;
@@ -670,7 +721,9 @@ public class OptsAndParamsPage
             @Override
             public void keyReleased(KeyEvent e)
             {
-              if (e.isActionKey())
+              int keyCode = e.getKeyCode();
+              if (e.isActionKey() && keyCode != KeyEvent.VK_LEFT
+                      && keyCode != KeyEvent.VK_RIGHT)
               {
                 if (valueField.getText().trim().length() > 0)
                 {
@@ -679,7 +732,7 @@ public class OptsAndParamsPage
               }
             }
           });
-          valueField.setPreferredSize(new Dimension(60, 25));
+          valueField.setPreferredSize(new Dimension(65, 25));
           controlsPanel.add(slider, BorderLayout.WEST);
           controlsPanel.add(valueField, BorderLayout.EAST);
         }
@@ -696,7 +749,6 @@ public class OptsAndParamsPage
               choicebox.addItem(val);
             }
           }
-
           if (parm.getValue() != null)
           {
             choicebox.setSelectedItem(parm.getValue());
@@ -704,18 +756,7 @@ public class OptsAndParamsPage
         }
         else
         {
-          if (parm instanceof LogarithmicParameter)
-          {
-            double base = ((LogarithmicParameter) parm).getBase();
-            // double value = Math.pow(base,
-            // Double.parseDouble(parm.getValue()) / LOGSLIDERSCALE);
-            double value = Double.parseDouble(parm.getValue());
-            valueField.setText(formatDouble(value));
-          }
-          else
-          {
-            valueField.setText(parm.getValue());
-          }
+          valueField.setText(parm.getValue());
         }
       }
       lastVal = updateSliderFromValueField();
@@ -738,45 +779,52 @@ public class OptsAndParamsPage
      */
     Object updateSliderFromValueField()
     {
-      if (validator == null)
+      if (validator == null || isStringParameter)
       {
-        if (!isChoiceParameter)
+        if (isChoiceParameter)
         {
-          slider.setVisible(false);
-          return valueField.getText().trim();
+          return choicebox.getSelectedItem();
         }
-        else
+        slider.setVisible(false);
+        return valueField.getText().trim();
+      }
+
+      valueField.setText(valueField.getText().trim());
+
+      /*
+       * ensure not outside min-max range
+       * TODO: provide some visual indicator if limit reached
+       */
+      try
+      {
+        valueField.setBackground(Color.WHITE);
+        double d = Double.parseDouble(valueField.getText());
+        if (validator.getMin() != null
+                && validator.getMin().doubleValue() > d)
         {
-          return choicebox.getSelectedItem();
+          valueField.setText(formatNumber(validator.getMin()));
         }
+        if (validator.getMax() != null
+                && validator.getMax().doubleValue() < d)
+        {
+          valueField.setText(formatNumber(validator.getMax()));
+        }
+      } catch (NumberFormatException e)
+      {
+        valueField.setBackground(Color.yellow);
+        return Float.NaN;
       }
+
       if (isIntegerParameter)
       {
         int iVal = 0;
         try
         {
-          valueField.setText(valueField.getText().trim());
           iVal = Integer.valueOf(valueField.getText());
-
-          /*
-           * ensure not outside min-max range
-           * TODO: provide some visual indicator if limit reached
-           */
-          if (validator.getMin() != null
-                  && validator.getMin().intValue() > iVal)
-          {
-            iVal = validator.getMin().intValue();
-            valueField.setText(String.valueOf(iVal));
-          }
-          if (validator.getMax() != null
-                  && validator.getMax().intValue() < iVal)
-          {
-            iVal = validator.getMax().intValue();
-            valueField.setText(String.valueOf(iVal));
-          }
         } catch (Exception e)
         {
-          Cache.log.error(e.getMessage());
+          valueField.setBackground(Color.yellow);
+          return Integer.valueOf(0);
         }
 
         if (validator.getMin() != null && validator.getMax() != null)
@@ -791,43 +839,28 @@ public class OptsAndParamsPage
         }
         return new Integer(iVal);
       }
-      else if (isLogarithmicParameter)
+
+      if (isLogarithmicParameter)
       {
         double dVal = 0d;
         try
         {
-          valueField.setText(valueField.getText().trim());
           double eValue = Double.valueOf(valueField.getText());
-
-          dVal = Math.log(eValue)
-                  / Math.log(((LogarithmicParameter) parameter).getBase())
-                  * LOGSLIDERSCALE;
-
-          /*
-           * ensure not outside min-max range
-           * TODO: provide some visual indicator if limit reached
-           */
-          if (validator.getMin() != null
-                  && validator.getMin().doubleValue() > dVal)
-          {
-            dVal = validator.getMin().doubleValue();
-            valueField.setText(formatDouble(eValue));
-          }
-          if (validator.getMax() != null
-                  && validator.getMax().doubleValue() < dVal)
-          {
-            dVal = validator.getMax().doubleValue();
-            valueField.setText(formatDouble(eValue));
-          }
+          dVal = Math.log(eValue) * sliderScaleFactor;
         } catch (Exception e)
         {
+          // shouldn't be possible here
+          valueField.setBackground(Color.yellow);
+          return Double.NaN;
         }
-
         if (validator.getMin() != null && validator.getMax() != null)
         {
+          double scaleMin = Math.log(validator.getMin().doubleValue())
+                  * sliderScaleFactor;
+          double scaleMax = Math.log(validator.getMax().doubleValue())
+                  * sliderScaleFactor;
           slider.getModel().setRangeProperties((int) (dVal), 1,
-                  (int) (validator.getMin().doubleValue()),
-                  1 + (int) (validator.getMax().doubleValue()), true);
+                  (int) scaleMin, 1 + (int) scaleMax, true);
         }
         else
         {
@@ -835,47 +868,30 @@ public class OptsAndParamsPage
         }
         return new Double(dVal);
       }
+
+      float fVal = 0f;
+      try
+      {
+        fVal = Float.valueOf(valueField.getText());
+      } catch (Exception e)
+      {
+        return Float.valueOf(0f); // shouldn't happen
+      }
+      if (validator.getMin() != null && validator.getMax() != null)
+      {
+        float scaleMin = validator.getMin().floatValue()
+                * sliderScaleFactor;
+        float scaleMax = validator.getMax().floatValue()
+                * sliderScaleFactor;
+        slider.getModel().setRangeProperties(
+                (int) (fVal * sliderScaleFactor), 1, (int) scaleMin,
+                1 + (int) scaleMax, true);
+      }
       else
       {
-        float fVal = 0f;
-        try
-        {
-          valueField.setText(valueField.getText().trim());
-          fVal = Float.valueOf(valueField.getText());
-
-          /*
-           * ensure not outside min-max range
-           * TODO: provide some visual indicator if limit reached
-           */
-          if (validator.getMin() != null
-                  && validator.getMin().floatValue() > fVal)
-          {
-            fVal = validator.getMin().floatValue();
-            valueField.setText(String.valueOf(fVal));
-          }
-          if (validator.getMax() != null
-                  && validator.getMax().floatValue() < fVal)
-          {
-            fVal = validator.getMax().floatValue();
-            valueField.setText(String.valueOf(fVal));
-          }
-        } catch (Exception e)
-        {
-        }
-
-        if (validator.getMin() != null && validator.getMax() != null)
-        {
-          slider.getModel().setRangeProperties((int) (fVal * SLIDERSCALE),
-                  1, (int) (validator.getMin().floatValue() * SLIDERSCALE),
-                  1 + (int) (validator.getMax().floatValue() * SLIDERSCALE),
-                  true);
-        }
-        else
-        {
-          slider.setVisible(false);
-        }
-        return new Float(fVal);
+        slider.setVisible(false);
       }
+      return new Float(fVal);
     }
   }