Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit edae98a4 authored by Alec Mouri's avatar Alec Mouri
Browse files

Remove bitwise plane information from ImageFormat's P010 docs 

Some vendors may prefer a different underlying layout for P010 in the
future compared to the one currently supported in gralloc. In
particular, it's not a guarantee that the CB/CR plane is contiguous in
memory with the Y plane.

Bug: 195570363
Test: builds
Change-Id: I01eea78b8555610470959cdb4f0f9ceb16e80f73
parent 782b4e9e

graphics/java/android/graphics/ImageFormat.java

+2 −16
Original line number Diff line number Diff line
@@ -178,22 +178,8 @@ public class ImageFormat { 
     * <p>Android YUV P010 format.</p>

     *

     * P010 is a 4:2:0 YCbCr semiplanar format comprised of a WxH Y plane

     * followed immediately by a Wx(H/2) CbCr plane. Each sample is

     * represented by a 16-bit little-endian value, with the lower 6 bits set

     * to zero.

     *

     * <p>This format assumes

     * <ul>

     * <li>an even height</li>

     * <li>a vertical stride equal to the height</li>

     * </ul>

     * </p>

     *

     * <pre>   stride_in_bytes = stride * 2 </pre>

     * <pre>   y_size = stride_in_bytes * height </pre>

     * <pre>   cbcr_size = stride_in_bytes * (height / 2) </pre>

     * <pre>   cb_offset = y_size </pre>

     * <pre>   cr_offset = cb_offset + 2 </pre>

     * followed by a Wx(H/2) CbCr plane. Each sample is represented by a 16-bit

     * little-endian value, with the lower 6 bits set to zero.

     *

     * <p>For example, the {@link android.media.Image} object can provide data

     * in this format from a {@link android.hardware.camera2.CameraDevice}