From 3ee6dca1b1d8e60397f494c48f963cadf206567a Mon Sep 17 00:00:00 2001
From: jprocter <jprocter@compbio.dundee.ac.uk>
Date: Thu, 14 Jun 2012 11:30:45 +0100
Subject: [PATCH] JAL-968 javadoc and return flag indicating if any of the
 annotation rows were being worked on whilst the panel was
 rendered.

---
 src/jalview/renderer/AnnotationRenderer.java |   24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/src/jalview/renderer/AnnotationRenderer.java b/src/jalview/renderer/AnnotationRenderer.java
index 84f6589..8588bf2 100644
--- a/src/jalview/renderer/AnnotationRenderer.java
+++ b/src/jalview/renderer/AnnotationRenderer.java
@@ -212,20 +212,25 @@ public class AnnotationRenderer
   }
 
   /**
-   * DOCUMENT ME!
-   *
-   * @param annotationPanel
-   *          TODO
+   * Render the annotation rows associated with an alignment.
+   * @param annotPanel
+   *          container frame
+   * @param av
+   *          data and view settings to render
    * @param g
-   *          DOCUMENT ME!
+   *          destination for graphics
+   * @param activeRow
+   *          row where a mouse event occured (or -1)
    * @param startRes
-   *          DOCUMENT ME!
+   *          first column that will be drawn
    * @param endRes
-   *          DOCUMENT ME!
+   *          last column that will be drawn
+   * @return true if the fadedImage was used for any alignment annotation rows currently being calculated
    */
-  public void drawComponent(AwtRenderPanelI annotPanel, AlignViewportI av,
+  public boolean drawComponent(AwtRenderPanelI annotPanel, AlignViewportI av,
           Graphics g, int activeRow, int startRes, int endRes)
   {
+    boolean usedFaded=false;
     // NOTES:
     // AnnotationPanel needs to implement: ImageObserver, access to
     // AlignViewport
@@ -292,7 +297,7 @@ public class AnnotationRenderer
       if (row.autoCalculated && av.isCalculationInProgress(row))
       {
         y += charHeight;
-
+        usedFaded=true;
         g.drawImage(fadedImage, 0, y - row.height, imgWidth, y, 0, y
                 - row.height, imgWidth, y, annotationPanel);
         g.setColor(Color.black);
@@ -600,6 +605,7 @@ public class AnnotationRenderer
         y += aa[i].height;
       }
     }
+    return !usedFaded;
   }
 
   private final Color GLYPHLINE_COLOR = Color.gray;
-- 
1.7.10.2