Language

DataSpaceRange Enum

Definition

This enumeration supports a bitwise combination of its member values.

[System.Flags]
public enum DataSpaceRange
[<System.Flags>]
type DataSpaceRange = 
Inheritance
DataSpaceRange
Attributes

Fields

Name Value Description
Unspecified 0

Range characteristics are unknown or are determined by the application.

Android reference for android.hardware.DataSpace.RANGE_UNSPECIFIED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Full 134217728

Full range uses all values for Y, Cb and Cr from 0 to 2^b-1, where b is the bit depth of the color format.

Android reference for android.hardware.DataSpace.RANGE_FULL.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Limited 268435456

Limited range uses values 16/256*2^b to 235/256*2^b for Y, and 1/16*2^b to 15/16*2^b for Cb, Cr, R, G and B, where b is the bit depth of the color format.

E.g. For 8-bit-depth formats: Luma (Y) samples should range from 16 to 235, inclusive Chroma (Cb, Cr) samples should range from 16 to 240, inclusive For 10-bit-depth formats: Luma (Y) samples should range from 64 to 940, inclusive Chroma (Cb, Cr) samples should range from 64 to 960, inclusive.

Android reference for android.hardware.DataSpace.RANGE_LIMITED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Extended 402653184

Extended range can be used in combination with FP16 to communicate scRGB or with android.view.SurfaceControl.Transaction.setExtendedRangeBrightness(SurfaceControl,float,float) to indicate an HDR range.

When used with floating point pixel formats and STANDARD_BT709 then [0.0 - 1.0] is the standard sRGB space and values outside the range [0.0 - 1.0] can encode color outside the sRGB gamut. [-0.5, 7.5] is the standard scRGB range. Used to blend/merge multiple dataspaces on a single display.

As of Build.VERSION_CODES.UPSIDE_DOWN_CAKE this may be combined with android.view.SurfaceControl.Transaction.setExtendedRangeBrightness(SurfaceControl,float,float) and other formats such as HardwareBuffer.RGBA_8888 or HardwareBuffer.RGBA_1010102 to communicate a variable HDR brightness range

Android reference for android.hardware.DataSpace.RANGE_EXTENDED.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to