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
|
/*
* Copyright 2016 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkColorSpace_DEFINED
#define SkColorSpace_DEFINED
#include "SkMatrix44.h"
#include "SkRefCnt.h"
class SkData;
class SK_API SkColorSpace : public SkRefCnt {
public:
/**
* Common, named profiles that we can recognize.
*/
enum Named {
kUnknown_Named,
kSRGB_Named,
kAdobeRGB_Named,
};
enum GammaNamed {
kLinear_GammaNamed,
/**
* Gamma curve is a close match to the canonical sRGB curve, which has
* a short linear segment followed by a 2.4f exponential.
*/
kSRGB_GammaNamed,
/**
* Gamma curve is a close match to the 2.2f exponential curve. This is
* used by Adobe RGB profiles and is common on monitors as well.
*/
k2Dot2Curve_GammaNamed,
/**
* Gamma is represented by a look-up table, a parametric curve, or an uncommon
* exponential curve. Or the R, G, and B gammas do not match.
*/
kNonStandard_GammaNamed,
/**
* To be used by UMA code only. ICC profiles lacks valid gamma representation.
*/
kInvalid_GammaNamed,
};
/**
* Create an SkColorSpace from the src gamma and a transform from src gamut to D50 XYZ.
*/
static sk_sp<SkColorSpace> NewRGB(GammaNamed gammaNamed, const SkMatrix44& toXYZD50);
/**
* Create a common, named SkColorSpace.
*/
static sk_sp<SkColorSpace> NewNamed(Named);
/**
* Create an SkColorSpace from an ICC profile.
*/
static sk_sp<SkColorSpace> NewICC(const void*, size_t);
/**
* Create an SkColorSpace with the same gamut as this color space, but with linear gamma.
*/
sk_sp<SkColorSpace> makeLinearGamma();
GammaNamed gammaNamed() const { return fGammaNamed; }
/**
* Returns the matrix used to transform src gamut to XYZ D50.
*/
const SkMatrix44& xyz() const { return fToXYZD50; }
/**
* Returns true if the color space gamma is near enough to be approximated as sRGB.
*/
bool gammaCloseToSRGB() const {
return kSRGB_GammaNamed == fGammaNamed || k2Dot2Curve_GammaNamed == fGammaNamed;
}
/**
* To be used only by UMA code.
*/
bool gammasAreMatching() const;
bool gammasAreNamed() const;
bool gammasAreValues() const;
bool gammasAreTables() const;
bool gammasAreParams() const;
/**
* Returns nullptr on failure. Fails when we fallback to serializing ICC data and
* the data is too large to serialize.
*/
sk_sp<SkData> serialize() const;
/**
* If |memory| is nullptr, returns the size required to serialize.
* Otherwise, serializes into |memory| and returns the size.
*/
size_t writeToMemory(void* memory) const;
static sk_sp<SkColorSpace> Deserialize(const void* data, size_t length);
/**
* If both are null, we return true. If one is null and the other is not, we return false.
* If both are non-null, we do a deeper compare.
*/
static bool Equals(const SkColorSpace* src, const SkColorSpace* dst);
protected:
SkColorSpace(GammaNamed gammaNamed, const SkMatrix44& toXYZD50, Named named);
const GammaNamed fGammaNamed;
const SkMatrix44 fToXYZD50;
const Named fNamed;
};
#endif
|
