1/*
2 * Copyright 2016 Google Inc.
3 *
4 * Use of this source code is governed by a BSD-style license that can be
5 * found in the LICENSE file.
6 */
7
8#ifndef SkColorSpace_DEFINED
9#define SkColorSpace_DEFINED
10
11#include "include/core/SkRefCnt.h"
12#include "include/private/SkFixed.h"
13#include "include/private/SkOnce.h"
14#include "include/third_party/skcms/skcms.h"
15#include <memory>
16
17class SkData;
18
19/**
20 * Describes a color gamut with primaries and a white point.
21 */
22struct SK_API SkColorSpacePrimaries {
23 float fRX;
24 float fRY;
25 float fGX;
26 float fGY;
27 float fBX;
28 float fBY;
29 float fWX;
30 float fWY;
31
32 /**
33 * Convert primaries and a white point to a toXYZD50 matrix, the preferred color gamut
34 * representation of SkColorSpace.
35 */
36 bool toXYZD50(skcms_Matrix3x3* toXYZD50) const;
37};
38
39namespace SkNamedTransferFn {
40
41// Like SkNamedGamut::kSRGB, keeping this bitwise exactly the same as skcms makes things fastest.
42static constexpr skcms_TransferFunction kSRGB =
43 { 2.4f, (float)(1/1.055), (float)(0.055/1.055), (float)(1/12.92), 0.04045f, 0.0f, 0.0f };
44
45static constexpr skcms_TransferFunction k2Dot2 =
46 { 2.2f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f };
47
48static constexpr skcms_TransferFunction kLinear =
49 { 1.0f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f };
50
51static constexpr skcms_TransferFunction kRec2020 =
52 {2.22222f, 0.909672f, 0.0903276f, 0.222222f, 0.0812429f, 0, 0};
53
54static constexpr skcms_TransferFunction kPQ =
55 {-2.0f, -107/128.0f, 1.0f, 32/2523.0f, 2413/128.0f, -2392/128.0f, 8192/1305.0f };
56
57static constexpr skcms_TransferFunction kHLG =
58 {-3.0f, 2.0f, 2.0f, 1/0.17883277f, 0.28466892f, 0.55991073f, 0.0f };
59
60}
61
62namespace SkNamedGamut {
63
64static constexpr skcms_Matrix3x3 kSRGB = {{
65 // ICC fixed-point (16.16) representation, taken from skcms. Please keep them exactly in sync.
66 // 0.436065674f, 0.385147095f, 0.143066406f,
67 // 0.222488403f, 0.716873169f, 0.060607910f,
68 // 0.013916016f, 0.097076416f, 0.714096069f,
69 { SkFixedToFloat(0x6FA2), SkFixedToFloat(0x6299), SkFixedToFloat(0x24A0) },
70 { SkFixedToFloat(0x38F5), SkFixedToFloat(0xB785), SkFixedToFloat(0x0F84) },
71 { SkFixedToFloat(0x0390), SkFixedToFloat(0x18DA), SkFixedToFloat(0xB6CF) },
72}};
73
74static constexpr skcms_Matrix3x3 kAdobeRGB = {{
75 // ICC fixed-point (16.16) repesentation of:
76 // 0.60974, 0.20528, 0.14919,
77 // 0.31111, 0.62567, 0.06322,
78 // 0.01947, 0.06087, 0.74457,
79 { SkFixedToFloat(0x9c18), SkFixedToFloat(0x348d), SkFixedToFloat(0x2631) },
80 { SkFixedToFloat(0x4fa5), SkFixedToFloat(0xa02c), SkFixedToFloat(0x102f) },
81 { SkFixedToFloat(0x04fc), SkFixedToFloat(0x0f95), SkFixedToFloat(0xbe9c) },
82}};
83
84static constexpr skcms_Matrix3x3 kDisplayP3 = {{
85 { 0.515102f, 0.291965f, 0.157153f },
86 { 0.241182f, 0.692236f, 0.0665819f },
87 { -0.00104941f, 0.0418818f, 0.784378f },
88}};
89// TODO: skia:9792 We originally misnamed this matrix... delete this incorrect alias?
90static constexpr skcms_Matrix3x3 kDCIP3 = kDisplayP3;
91
92static constexpr skcms_Matrix3x3 kRec2020 = {{
93 { 0.673459f, 0.165661f, 0.125100f },
94 { 0.279033f, 0.675338f, 0.0456288f },
95 { -0.00193139f, 0.0299794f, 0.797162f },
96}};
97
98static constexpr skcms_Matrix3x3 kXYZ = {{
99 { 1.0f, 0.0f, 0.0f },
100 { 0.0f, 1.0f, 0.0f },
101 { 0.0f, 0.0f, 1.0f },
102}};
103
104}
105
106class SK_API SkColorSpace : public SkNVRefCnt<SkColorSpace> {
107public:
108 /**
109 * Create the sRGB color space.
110 */
111 static sk_sp<SkColorSpace> MakeSRGB();
112
113 /**
114 * Colorspace with the sRGB primaries, but a linear (1.0) gamma.
115 */
116 static sk_sp<SkColorSpace> MakeSRGBLinear();
117
118 /**
119 * Create an SkColorSpace from a transfer function and a row-major 3x3 transformation to XYZ.
120 */
121 static sk_sp<SkColorSpace> MakeRGB(const skcms_TransferFunction& transferFn,
122 const skcms_Matrix3x3& toXYZ);
123
124 /**
125 * Create an SkColorSpace from a parsed (skcms) ICC profile.
126 */
127 static sk_sp<SkColorSpace> Make(const skcms_ICCProfile&);
128
129 /**
130 * Convert this color space to an skcms ICC profile struct.
131 */
132 void toProfile(skcms_ICCProfile*) const;
133
134 /**
135 * Returns true if the color space gamma is near enough to be approximated as sRGB.
136 */
137 bool gammaCloseToSRGB() const;
138
139 /**
140 * Returns true if the color space gamma is linear.
141 */
142 bool gammaIsLinear() const;
143
144 /**
145 * Sets |fn| to the transfer function from this color space. Returns true if the transfer
146 * function can be represented as coefficients to the standard ICC 7-parameter equation.
147 * Returns false otherwise (eg, PQ, HLG).
148 */
149 bool isNumericalTransferFn(skcms_TransferFunction* fn) const;
150
151 /**
152 * Returns true and sets |toXYZD50| if the color gamut can be described as a matrix.
153 * Returns false otherwise.
154 */
155 bool toXYZD50(skcms_Matrix3x3* toXYZD50) const;
156
157 /**
158 * Returns a hash of the gamut transformation to XYZ D50. Allows for fast equality checking
159 * of gamuts, at the (very small) risk of collision.
160 */
161 uint32_t toXYZD50Hash() const { return fToXYZD50Hash; }
162
163 /**
164 * Returns a color space with the same gamut as this one, but with a linear gamma.
165 * For color spaces whose gamut can not be described in terms of XYZ D50, returns
166 * linear sRGB.
167 */
168 sk_sp<SkColorSpace> makeLinearGamma() const;
169
170 /**
171 * Returns a color space with the same gamut as this one, with with the sRGB transfer
172 * function. For color spaces whose gamut can not be described in terms of XYZ D50, returns
173 * sRGB.
174 */
175 sk_sp<SkColorSpace> makeSRGBGamma() const;
176
177 /**
178 * Returns a color space with the same transfer function as this one, but with the primary
179 * colors rotated. For any XYZ space, this produces a new color space that maps RGB to GBR
180 * (when applied to a source), and maps RGB to BRG (when applied to a destination). For other
181 * types of color spaces, returns nullptr.
182 *
183 * This is used for testing, to construct color spaces that have severe and testable behavior.
184 */
185 sk_sp<SkColorSpace> makeColorSpin() const;
186
187 /**
188 * Returns true if the color space is sRGB.
189 * Returns false otherwise.
190 *
191 * This allows a little bit of tolerance, given that we might see small numerical error
192 * in some cases: converting ICC fixed point to float, converting white point to D50,
193 * rounding decisions on transfer function and matrix.
194 *
195 * This does not consider a 2.2f exponential transfer function to be sRGB. While these
196 * functions are similar (and it is sometimes useful to consider them together), this
197 * function checks for logical equality.
198 */
199 bool isSRGB() const;
200
201 /**
202 * Returns nullptr on failure. Fails when we fallback to serializing ICC data and
203 * the data is too large to serialize.
204 */
205 sk_sp<SkData> serialize() const;
206
207 /**
208 * If |memory| is nullptr, returns the size required to serialize.
209 * Otherwise, serializes into |memory| and returns the size.
210 */
211 size_t writeToMemory(void* memory) const;
212
213 static sk_sp<SkColorSpace> Deserialize(const void* data, size_t length);
214
215 /**
216 * If both are null, we return true. If one is null and the other is not, we return false.
217 * If both are non-null, we do a deeper compare.
218 */
219 static bool Equals(const SkColorSpace*, const SkColorSpace*);
220
221 void transferFn(float gabcdef[7]) const; // DEPRECATED: Remove when webview usage is gone
222 void transferFn(skcms_TransferFunction* fn) const;
223 void invTransferFn(skcms_TransferFunction* fn) const;
224 void gamutTransformTo(const SkColorSpace* dst, skcms_Matrix3x3* src_to_dst) const;
225
226 uint32_t transferFnHash() const { return fTransferFnHash; }
227 uint64_t hash() const { return (uint64_t)fTransferFnHash << 32 | fToXYZD50Hash; }
228
229private:
230 friend class SkColorSpaceSingletonFactory;
231
232 SkColorSpace(const skcms_TransferFunction& transferFn, const skcms_Matrix3x3& toXYZ);
233
234 void computeLazyDstFields() const;
235
236 uint32_t fTransferFnHash;
237 uint32_t fToXYZD50Hash;
238
239 skcms_TransferFunction fTransferFn;
240 skcms_Matrix3x3 fToXYZD50;
241
242 mutable skcms_TransferFunction fInvTransferFn;
243 mutable skcms_Matrix3x3 fFromXYZD50;
244 mutable SkOnce fLazyDstFieldsOnce;
245};
246
247#endif
248