From 811677e68d8507efe47591dc6c2f3de7ff5dce53 Mon Sep 17 00:00:00 2001 From: Lajos Molnar Date: Fri, 30 Jan 2015 11:01:47 -0800 Subject: gralloc: clarify lock_ycbcr in light of multimedia codec usage Bug: 19179927 Change-Id: I53886f8d1a3a998b958f031b04ddd4cbf19aad2c --- include/hardware/gralloc.h | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) (limited to 'include/hardware') diff --git a/include/hardware/gralloc.h b/include/hardware/gralloc.h index 91e2f69..7d00114 100644 --- a/include/hardware/gralloc.h +++ b/include/hardware/gralloc.h @@ -237,8 +237,17 @@ typedef struct gralloc_module_t { * difference that it fills a struct ycbcr with a description of the buffer * layout, and zeroes out the reserved fields. * - * This will only work on buffers with HAL_PIXEL_FORMAT_YCbCr_*_888, and - * will return -EINVAL on any other buffer formats. + * If the buffer format is not compatible with a flexible YUV format (e.g. + * the buffer layout cannot be represented with the ycbcr struct), it + * will return -EINVAL. + * + * This method must work on buffers with HAL_PIXEL_FORMAT_YCbCr_*_888 + * if supported by the device, as well as with any other format that is + * requested by the multimedia codecs when they are configured with a + * flexible-YUV-compatible color-format with android native buffers. + * + * Note that this method may also be called on buffers of other formats, + * including non-YUV formats. * * Added in GRALLOC_MODULE_API_VERSION_0_2. */ -- cgit v1.1