commit 6b51f117a2ff58582f5d953d3970fe777991e369
author Emilian Peev <epeev@google.com> Sun Apr 09 21:44:07 2017 +0000
committer android-build-merger <android-build-merger@google.com> Sun Apr 09 21:44:07 2017 +0000
tree cf872102d208f969b2fbfe467394963578939272
parent a130c0d3f2d8b145ace3d87c1c6f7f4048271eaa
parent cb0b46654dc8b02825965877b400f063a85b4698

graphics: Update RAW16 format comments
am: cb0b46654d

Change-Id: Id5ff9b719351c5f7c1d08d3398dd0e01f20ec149

graphics/common/1.0/types.hal

diff --git a/graphics/common/1.0/types.hal b/graphics/common/1.0/types.hal
index 979e4c4..8aa0779 100644
--- a/graphics/common/1.0/types.hal
+++ b/graphics/common/1.0/types.hal
@@ -181,9 +181,17 @@
      *    - GRALLOC_USAGE_SW_*
      *    - GRALLOC_USAGE_RENDERSCRIPT
      *
-     * When used with ANativeWindow, the dataSpace should be
-     * HAL_DATASPACE_ARBITRARY, as raw image sensor buffers require substantial
-     * extra metadata to define.
+     * When used with ANativeWindow, the mapping of the dataSpace field to
+     * buffer contents for RAW16 is as follows:
+     *
+     *  dataSpace value               | Buffer contents
+     * -------------------------------+-----------------------------------------
+     *  HAL_DATASPACE_ARBITRARY       | Raw image sensor data, layout is as
+     *                                | defined above.
+     *  HAL_DATASPACE_DEPTH           | Unprocessed implementation-dependent raw
+     *                                | depth measurements, opaque with 16 bit
+     *                                | samples.
+     *  Other                         | Unsupported
      */
     RAW16 = 0x20,