commit fb410365ca67d36d4c81d7826712c6a05437612f
author Mathias Agopian <mathias@google.com> Tue Nov 15 21:27:52 2011 -0800
committer Mathias Agopian <mathias@google.com> Wed Nov 16 16:05:56 2011 -0800
tree 46579df9ee21822193624692c2ab94d44ccb2e5b
parent e9eaf3721dd715901d669df6488b1ecd63b1e634

improve hw composer documentation

Change-Id: I39363e37417991b9853309154d6691240e706acf

include/hardware/hwcomposer.h

diff --git a/include/hardware/hwcomposer.h b/include/hardware/hwcomposer.h
index 0fa3512..a17f3e4 100644
--- a/include/hardware/hwcomposer.h
+++ b/include/hardware/hwcomposer.h
@@ -287,6 +287,11 @@
      * entire composition has been handled by SurfaceFlinger with OpenGL ES.
      * In this case, (*set)() behaves just like eglSwapBuffers().
      *
+     * IMPORTANT NOTE: there is an implicit layer containing opaque black
+     * pixels behind all the layers in the list.
+     * It is the responsibility of the hwcomposer module to make
+     * sure black pixels are output (or blended from).
+     *
      * returns: 0 on success. An negative error code on error:
      *    HWC_EGL_ERROR: eglGetError() will provide the proper error code
      *    Another code for non EGL errors.