1 /*
2  * Copyright 2018 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 /**
18  * @file data_space.h
19  */
20 
21 #ifndef ANDROID_DATA_SPACE_H
22 #define ANDROID_DATA_SPACE_H
23 
24 #include <inttypes.h>
25 
26 #include <sys/cdefs.h>
27 
28 __BEGIN_DECLS
29 
30 /**
31  * ADataSpace.
32  */
33 enum ADataSpace {
34     /**
35      * Default-assumption data space, when not explicitly specified.
36      *
37      * It is safest to assume the buffer is an image with sRGB primaries and
38      * encoding ranges, but the consumer and/or the producer of the data may
39      * simply be using defaults. No automatic gamma transform should be
40      * expected, except for a possible display gamma transform when drawn to a
41      * screen.
42      */
43     ADATASPACE_UNKNOWN = 0,
44 
45     /**
46      * scRGB linear encoding:
47      *
48      * The red, green, and blue components are stored in extended sRGB space,
49      * but are linear, not gamma-encoded.
50      * The RGB primaries and the white point are the same as BT.709.
51      *
52      * The values are floating point.
53      * A pixel value of 1.0, 1.0, 1.0 corresponds to sRGB white (D65) at 80 nits.
54      * Values beyond the range [0.0 - 1.0] would correspond to other colors
55      * spaces and/or HDR content.
56      */
57     ADATASPACE_SCRGB_LINEAR = 406913024, // STANDARD_BT709 | TRANSFER_LINEAR | RANGE_EXTENDED
58 
59     /**
60      * sRGB gamma encoding:
61      *
62      * The red, green and blue components are stored in sRGB space, and
63      * converted to linear space when read, using the SRGB transfer function
64      * for each of the R, G and B components. When written, the inverse
65      * transformation is performed.
66      *
67      * The alpha component, if present, is always stored in linear space and
68      * is left unmodified when read or written.
69      *
70      * Use full range and BT.709 standard.
71      */
72     ADATASPACE_SRGB = 142671872, // STANDARD_BT709 | TRANSFER_SRGB | RANGE_FULL
73 
74     /**
75      * scRGB:
76      *
77      * The red, green, and blue components are stored in extended sRGB space,
78      * and gamma-encoded using the SRGB transfer function.
79      * The RGB primaries and the white point are the same as BT.709.
80      *
81      * The values are floating point.
82      * A pixel value of 1.0, 1.0, 1.0 corresponds to sRGB white (D65) at 80 nits.
83      * Values beyond the range [0.0 - 1.0] would correspond to other colors
84      * spaces and/or HDR content.
85      */
86     ADATASPACE_SCRGB = 411107328, // STANDARD_BT709 | TRANSFER_SRGB | RANGE_EXTENDED
87 
88     /**
89      * Display P3
90      *
91      * Use same primaries and white-point as DCI-P3
92      * but sRGB transfer function.
93      */
94     ADATASPACE_DISPLAY_P3 = 143261696, // STANDARD_DCI_P3 | TRANSFER_SRGB | RANGE_FULL
95 
96     /**
97      * ITU-R Recommendation 2020 (BT.2020)
98      *
99      * Ultra High-definition television
100      *
101      * Use full range, SMPTE 2084 (PQ) transfer and BT2020 standard
102      */
103     ADATASPACE_BT2020_PQ = 163971072, // STANDARD_BT2020 | TRANSFER_ST2084 | RANGE_FULL
104 };
105 
106 __END_DECLS
107 
108 #endif // ANDROID_DATA_SPACE_H
109