commit 6efab252d59ceff806840111b2e6c0e478d377ae
author Eino-Ville Talvala <etalvala@google.com> Mon May 06 14:05:05 2013 -0700
committer Eino-Ville Talvala <etalvala@google.com> Mon May 06 14:05:05 2013 -0700
tree 25f87b1eddaf652ee941824e58c434a01c9a948c
parent 74b8c4e57b6d0db6bdb79d298ef8bb19cad3be2e

gralloc: Clarify alloc stride for HAL_PIXEL_FORMAT_YCbCr_420_888

Bug: 8734880
Change-Id: I0cca7fd1965e1547991be06b6b18d6302dbe8670

include/hardware/gralloc.h

diff --git a/include/hardware/gralloc.h b/include/hardware/gralloc.h
index 52ef6a3..9c62242 100644
--- a/include/hardware/gralloc.h
+++ b/include/hardware/gralloc.h
@@ -258,6 +258,10 @@
      * allow the implementation to satisfy hardware constraints on the width
      * of a pixmap (eg: it may have to be multiple of 8 pixels). 
      * The CALLER TAKES OWNERSHIP of the buffer_handle_t.
+     *
+     * If format is HAL_PIXEL_FORMAT_YCbCr_420_888, the returned stride must be
+     * 0, since the actual strides are available from the android_ycbcr
+     * structure.
      * 
      * Returns 0 on success or -errno on error.
      */