1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
/*
* Copyright 2023 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef ULTRAHDR_ULTRAHDR_H
#define ULTRAHDR_ULTRAHDR_H
#include <string>
namespace ultrahdr {
// Color gamuts for image data
typedef enum {
ULTRAHDR_COLORGAMUT_UNSPECIFIED = -1,
ULTRAHDR_COLORGAMUT_BT709,
ULTRAHDR_COLORGAMUT_P3,
ULTRAHDR_COLORGAMUT_BT2100,
ULTRAHDR_COLORGAMUT_MAX = ULTRAHDR_COLORGAMUT_BT2100,
} ultrahdr_color_gamut;
// Transfer functions for image data
// TODO: TF LINEAR is deprecated, remove this enum and the code surrounding it.
typedef enum {
ULTRAHDR_TF_UNSPECIFIED = -1,
ULTRAHDR_TF_LINEAR = 0,
ULTRAHDR_TF_HLG = 1,
ULTRAHDR_TF_PQ = 2,
ULTRAHDR_TF_SRGB = 3,
ULTRAHDR_TF_MAX = ULTRAHDR_TF_SRGB,
} ultrahdr_transfer_function;
// Target output formats for decoder
typedef enum {
ULTRAHDR_OUTPUT_UNSPECIFIED = -1,
ULTRAHDR_OUTPUT_SDR, // SDR in RGBA_8888 color format
ULTRAHDR_OUTPUT_HDR_LINEAR, // HDR in F16 color format (linear)
ULTRAHDR_OUTPUT_HDR_PQ, // HDR in RGBA_1010102 color format (PQ transfer function)
ULTRAHDR_OUTPUT_HDR_HLG, // HDR in RGBA_1010102 color format (HLG transfer function)
ULTRAHDR_OUTPUT_MAX = ULTRAHDR_OUTPUT_HDR_HLG,
} ultrahdr_output_format;
/*
* Holds information for gain map related metadata.
*
* Not: all values stored in linear. This differs from the metadata encoding in XMP, where
* maxContentBoost (aka gainMapMax), minContentBoost (aka gainMapMin), hdrCapacityMin, and
* hdrCapacityMax are stored in log2 space.
*/
struct ultrahdr_metadata_struct {
// Ultra HDR format version
std::string version;
// Max Content Boost for the map
float maxContentBoost;
// Min Content Boost for the map
float minContentBoost;
// Gamma of the map data
float gamma;
// Offset for SDR data in map calculations
float offsetSdr;
// Offset for HDR data in map calculations
float offsetHdr;
// HDR capacity to apply the map at all
float hdrCapacityMin;
// HDR capacity to apply the map completely
float hdrCapacityMax;
};
typedef struct ultrahdr_metadata_struct* ultrahdr_metadata_ptr;
/*
* Holds information for uncompressed image or gain map.
*/
struct ultrahdr_uncompressed_struct {
// Pointer to the data location.
void* data;
// Width of the gain map or the luma plane of the image in pixels.
size_t width;
// Height of the gain map or the luma plane of the image in pixels.
size_t height;
// Color gamut.
ultrahdr_color_gamut colorGamut;
// Values below are optional
// Pointer to chroma data, if it's NULL, chroma plane is considered to be immediately
// after the luma plane.
void* chroma_data = nullptr;
// Stride of Y plane in number of pixels. 0 indicates the member is uninitialized. If
// non-zero this value must be larger than or equal to luma width. If stride is
// uninitialized then it is assumed to be equal to luma width.
size_t luma_stride = 0;
// Stride of UV plane in number of pixels.
// 1. If this handle points to P010 image then this value must be larger than
// or equal to luma width.
// 2. If this handle points to 420 image then this value must be larger than
// or equal to (luma width / 2).
// NOTE: if chroma_data is nullptr, chroma_stride is irrelevant. Just as the way,
// chroma_data is derived from luma ptr, chroma stride is derived from luma stride.
size_t chroma_stride = 0;
};
/*
* Holds information for compressed image or gain map.
*/
struct ultrahdr_compressed_struct {
// Pointer to the data location.
void* data;
// Used data length in bytes.
int length;
// Maximum available data length in bytes.
int maxLength;
// Color gamut.
ultrahdr_color_gamut colorGamut;
};
/*
* Holds information for EXIF metadata.
*/
struct ultrahdr_exif_struct {
// Pointer to the data location.
void* data;
// Data length;
size_t length;
};
typedef struct ultrahdr_uncompressed_struct* uncompressed_ptr;
typedef struct ultrahdr_compressed_struct* compressed_ptr;
typedef struct ultrahdr_exif_struct* exif_ptr;
} // namespace ultrahdr
#endif // ULTRAHDR_ULTRAHDR_H
|
