JAL-3383 minor code tidying and commenting

[jalview.git] / src / jalview / api / FeatureColourI.java

diff --git a/src/jalview/api/FeatureColourI.java b/src/jalview/api/FeatureColourI.java
index 4dbb1bb..44bc321 100644 (file)
--- a/src/jalview/api/FeatureColourI.java
+++ b/src/jalview/api/FeatureColourI.java
@@ -65,7 +65,7 @@ public interface FeatureColourI
 
   /**
    * Answers true if the feature has a single colour, i.e. if isColourByLabel()
-   * and isGraduatedColour() both answer false
+   * and isGraduatedColour() both answer false; else answers false
    * 
    * @return
    */
@@ -192,4 +192,24 @@ public interface FeatureColourI
    * @return
    */
   void setAttributeName(String... name);
+
+  /**
+   * Answers true if colour has a threshold set, and the feature score (or other
+   * attribute selected for colouring) is outwith the threshold.
+   * <p>
+   * Answers false if not a graduated colour, or no threshold is set, or value
+   * is not outwith the threshold, or value is null or non-numeric.
+   * 
+   * @param sf
+   * @return
+   */
+  boolean isOutwithThreshold(SequenceFeature sf);
+
+  /*
+   * Answers a human-readable text description of the colour, suitable for
+   * display as a tooltip, possibly internationalised for the user's locale.
+   * 
+   * @return
+   */
+  String getDescription();
 }