Merge "Update documentation for Image to be clear on valid format enums." into tm-dev am: 82409626b9

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/17006063

Change-Id: I04ae4cece1fcbac12d7391ce5219408a090e3689
Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
This commit is contained in:
TreeHugger Robot
2022-11-29 21:31:25 +00:00
committed by Automerger Merge Worker

View File

@@ -86,8 +86,10 @@ public abstract class Image implements AutoCloseable {
* *
* <p> * <p>
* The format is one of the values from * The format is one of the values from
* {@link android.graphics.ImageFormat ImageFormat}. The mapping between the * {@link android.graphics.ImageFormat ImageFormat},
* formats and the planes is as follows: * {@link android.graphics.PixelFormat PixelFormat}, or
* {@link android.hardware.HardwareBuffer HardwareBuffer}. The mapping between the
* formats and the planes is as follows (any formats not listed will have 1 plane):
* </p> * </p>
* *
* <table> * <table>
@@ -171,15 +173,18 @@ public abstract class Image implements AutoCloseable {
* </tr> * </tr>
* <tr> * <tr>
* <td>{@link android.graphics.ImageFormat#YCBCR_P010 YCBCR_P010}</td> * <td>{@link android.graphics.ImageFormat#YCBCR_P010 YCBCR_P010}</td>
* <td>1</td> * <td>3</td>
* <td>P010 is a 4:2:0 YCbCr semiplanar format comprised of a WxH Y plane * <td>P010 is a 4:2:0 YCbCr semiplanar format comprised of a WxH Y plane
* followed by a Wx(H/2) CbCr plane. Each sample is represented by a 16-bit * followed by a Wx(H/2) Cb and Cr planes. Each sample is represented by a 16-bit
* little-endian value, with the lower 6 bits set to zero. * little-endian value, with the lower 6 bits set to zero. Since this is guaranteed to be
* a semi-planar format, the Cb plane can also be treated as an interleaved Cb/Cr plane.
* </td> * </td>
* </tr> * </tr>
* </table> * </table>
* *
* @see android.graphics.ImageFormat * @see android.graphics.ImageFormat
* @see android.graphics.PixelFormat
* @see android.hardware.HardwareBuffer
*/ */
public abstract int getFormat(); public abstract int getFormat();