diff options
| author | Lajos Molnar <lajos@google.com> | 2015-01-30 11:01:47 -0800 |
|---|---|---|
| committer | Lajos Molnar <lajos@google.com> | 2015-01-30 11:02:58 -0800 |
| commit | 811677e68d8507efe47591dc6c2f3de7ff5dce53 (patch) | |
| tree | 8e16bd1028f875ad6ec936d0a12b24ce3a13341c /include/hardware | |
| parent | b2bc0e518278b228d8b4c6bd324f04237feb92c3 (diff) | |
| download | hardware_libhardware-811677e68d8507efe47591dc6c2f3de7ff5dce53.zip hardware_libhardware-811677e68d8507efe47591dc6c2f3de7ff5dce53.tar.gz hardware_libhardware-811677e68d8507efe47591dc6c2f3de7ff5dce53.tar.bz2 | |
gralloc: clarify lock_ycbcr in light of multimedia codec usage
Bug: 19179927
Change-Id: I53886f8d1a3a998b958f031b04ddd4cbf19aad2c
Diffstat (limited to 'include/hardware')
| -rw-r--r-- | include/hardware/gralloc.h | 13 |
1 files changed, 11 insertions, 2 deletions
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. */ |