X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fapi%2FFeatureRenderer.java;h=839119ddeff232ff3a0e85383e9389d32b834742;hb=846f3f1ad573cad309d41356af68887a4a3348eb;hp=356548801f0a358b745f50c2612ed2fe4df8c862;hpb=1a4abdb42e66e36aff0cb6f0e151624727eb2885;p=jalview.git

diff --git a/src/jalview/api/FeatureRenderer.java b/src/jalview/api/FeatureRenderer.java
index 3565488..839119d 100644
--- a/src/jalview/api/FeatureRenderer.java
+++ b/src/jalview/api/FeatureRenderer.java
@@ -38,17 +38,24 @@ public interface FeatureRenderer
 {
 
   /**
-   * compute the perceived colour for a given column position in sequenceI,
-   * taking transparency and feature visibility into account.
+   * Returns the combined feature colour for a given sequence and column
+   * position, taking into account feature colour schemes, ordering, feature and
+   * feature group visibility, and transparency. Returns null if there is no
+   * visible feature at the position.
+   * <p>
+   * The Graphics argument is optional and may be null if no transparency is
+   * applied. With feature transparency, visible features are written to the
+   * graphics context and the composite colour can be read off.
+   * <p>
+   * This is provided for use by Structure Viewers and the Overview Window to
+   * get the feature colour of the rendered sequence.
    * 
-   * @param sequenceI
-   *          - sequence providing features
-   * @param r
-   *          - column position
+   * @param sequence
+   * @param column
    * @param g
    * @return
    */
-  Color findFeatureColour(SequenceI sequenceI, int r, Graphics g);
+  Color findFeatureColour(SequenceI sequence, int column, Graphics g);
 
   /**
    * trigger the feature discovery process for a newly created feature renderer.