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
142
143
144
145
146
147
148
149
150
|
/*
* Copyright (C) 2006-2023 Apple Inc. All rights reserved.
* Copyright (C) 2007 Alp Toker <alp@atoker.com>
* Copyright (C) 2008 Torch Mobile, Inc.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
* OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#pragma once
#include <WebCore/Color.h>
#include <WebCore/ColorInterpolationMethod.h>
#include <WebCore/FloatPoint.h>
#include <WebCore/GradientColorStops.h>
#include <WebCore/GraphicsTypes.h>
#include <WebCore/RenderingResource.h>
#include <wtf/ThreadSafeRefCounted.h>
#include <wtf/Vector.h>
#if USE(SKIA)
#include <skia/core/SkShader.h>
#endif
#if USE(CG)
#include <WebCore/GradientRendererCG.h>
#endif
#if USE(CG)
typedef struct CGContext* CGContextRef;
#endif
#if USE(CAIRO)
typedef struct _cairo_pattern cairo_pattern_t;
#endif
namespace WTF {
class TextStream;
}
namespace WebCore {
class AffineTransform;
class FloatRect;
class GraphicsContext;
// Note: currently this class is not usable from multiple threads due to mutating interface.
class Gradient final : public ThreadSafeRefCounted<Gradient> {
public:
struct LinearData {
FloatPoint point0;
FloatPoint point1;
};
struct RadialData {
FloatPoint point0;
FloatPoint point1;
float startRadius;
float endRadius;
float aspectRatio; // For elliptical gradient, width / height.
};
struct ConicData {
FloatPoint point0;
float angleRadians;
};
using Data = Variant<LinearData, RadialData, ConicData>;
// isTransient may affect backend rendering implementation caching decisions.
// Transient instances may be assumed to be drawn only few times or seldomly and as such the backend
// may not persist caches related to the instance.
WEBCORE_EXPORT static Ref<Gradient> create(Data&&, ColorInterpolationMethod, GradientSpreadMethod = GradientSpreadMethod::Pad, GradientColorStops&& = { }, bool isTransient = true);
WEBCORE_EXPORT ~Gradient();
const Data& data() const { return m_data; }
ColorInterpolationMethod colorInterpolationMethod() const { return m_colorInterpolationMethod; }
GradientSpreadMethod spreadMethod() const { return m_spreadMethod; }
const GradientColorStops& stops() const { return m_stops; }
bool isTransient() const { return m_isTransient; }
WEBCORE_EXPORT void addColorStop(GradientColorStop&&);
bool isZeroSize() const;
void fill(GraphicsContext&, const FloatRect&);
void adjustParametersForTiledDrawing(FloatSize&, FloatRect&, const FloatSize& spacing);
unsigned hash() const;
#if USE(CAIRO)
RefPtr<cairo_pattern_t> createPattern(float globalAlpha, const AffineTransform&);
#endif
#if USE(CG)
void paint(GraphicsContext&);
// If the DestinationColorSpace is present, the gradient may cache a platform renderer using colors converted into this colorspace,
// which can be more efficient to render since it avoids colorspace conversions when lower level frameworks render the gradient.
void paint(CGContextRef, std::optional<DestinationColorSpace> = { });
#endif
#if USE(SKIA)
sk_sp<SkShader> shader(float globalAlpha, const AffineTransform&);
#endif
void addObserver(WeakRef<RenderingResourceObserver>&& observer) const
{
m_observers.add(WTFMove(observer));
}
private:
Gradient(Data&&, ColorInterpolationMethod, GradientSpreadMethod, GradientColorStops&&, bool isTransient);
void stopsChanged();
Data m_data;
ColorInterpolationMethod m_colorInterpolationMethod;
GradientSpreadMethod m_spreadMethod;
GradientColorStops m_stops;
mutable unsigned m_cachedHash { 0 };
#if USE(CG)
std::optional<GradientRendererCG> m_platformRenderer;
#endif
mutable WeakHashSet<RenderingResourceObserver> m_observers;
bool m_isTransient { true };
};
WEBCORE_EXPORT WTF::TextStream& operator<<(WTF::TextStream&, const Gradient&);
} // namespace WebCore
|
