43f6d8ff3466f4fd637978e30e5e8f263ca9049e
[WebKit-https.git] / Source / WebCore / css / CSSFontFace.h
1 /*
2  * Copyright (C) 2007, 2008, 2016 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #ifndef CSSFontFace_h
27 #define CSSFontFace_h
28
29 #include "CSSFontFaceRule.h"
30 #include "FontFeatureSettings.h"
31 #include "TextFlags.h"
32 #include <memory>
33 #include <wtf/Forward.h>
34 #include <wtf/HashSet.h>
35 #include <wtf/PassRefPtr.h>
36 #include <wtf/RefCounted.h>
37 #include <wtf/Vector.h>
38 #include <wtf/WeakPtr.h>
39
40 namespace JSC {
41 class ExecState;
42 }
43
44 namespace WebCore {
45
46 class CSSFontFaceSource;
47 class CSSFontSelector;
48 class CSSSegmentedFontFace;
49 class CSSValue;
50 class CSSValueList;
51 class Document;
52 class FontDescription;
53 class Font;
54 class FontFace;
55
56 class CSSFontFace final : public RefCounted<CSSFontFace> {
57 public:
58     static Ref<CSSFontFace> create(CSSFontSelector* fontSelector, StyleRuleFontFace* cssConnection = nullptr, FontFace* wrapper = nullptr, bool isLocalFallback = false)
59     {
60         return adoptRef(*new CSSFontFace(fontSelector, cssConnection, wrapper, isLocalFallback));
61     }
62     virtual ~CSSFontFace();
63
64     bool setFamilies(CSSValue&);
65     bool setStyle(CSSValue&);
66     bool setWeight(CSSValue&);
67     bool setUnicodeRange(CSSValue&);
68     bool setVariantLigatures(CSSValue&);
69     bool setVariantPosition(CSSValue&);
70     bool setVariantCaps(CSSValue&);
71     bool setVariantNumeric(CSSValue&);
72     bool setVariantAlternates(CSSValue&);
73     bool setVariantEastAsian(CSSValue&);
74     bool setFeatureSettings(CSSValue&);
75
76     enum class Status;
77     struct UnicodeRange;
78     const CSSValueList* families() const { return m_families.get(); }
79     FontTraitsMask traitsMask() const { return m_traitsMask; }
80     const Vector<UnicodeRange>& ranges() const { return m_ranges; }
81     const FontFeatureSettings& featureSettings() const { return m_featureSettings; }
82     const FontVariantSettings& variantSettings() const { return m_variantSettings; }
83     void setVariantSettings(const FontVariantSettings& variantSettings) { m_variantSettings = variantSettings; }
84     void setTraitsMask(FontTraitsMask traitsMask) { m_traitsMask = traitsMask; }
85     bool isLocalFallback() const { return m_isLocalFallback; }
86     Status status() const { return m_status; }
87     StyleRuleFontFace* cssConnection() const { return m_cssConnection.get(); }
88
89     static Optional<FontTraitsMask> calculateStyleMask(CSSValue& style);
90     static Optional<FontTraitsMask> calculateWeightMask(CSSValue& weight);
91
92     class Client;
93     void addClient(Client&);
94     void removeClient(Client&);
95
96     bool allSourcesFailed() const;
97
98     void adoptSource(std::unique_ptr<CSSFontFaceSource>&&);
99     void sourcesPopulated() { m_sourcesPopulated = true; }
100
101     void fontLoaded(CSSFontFaceSource&);
102
103     void load();
104     RefPtr<Font> font(const FontDescription&, bool syntheticBold, bool syntheticItalic);
105
106     static void appendSources(CSSFontFace&, CSSValueList&, Document*, bool isInitiatingElementInUserAgentShadowTree);
107
108     class Client {
109     public:
110         virtual ~Client() { }
111         virtual void fontLoaded(CSSFontFace&) { }
112         virtual void fontStateChanged(CSSFontFace&, Status oldState, Status newState) { UNUSED_PARAM(oldState); UNUSED_PARAM(newState); }
113         virtual void fontPropertyChanged(CSSFontFace&, CSSValueList* oldFamilies = nullptr) { UNUSED_PARAM(oldFamilies); }
114         virtual void ref() = 0;
115         virtual void deref() = 0;
116     };
117
118     // Pending => Loading  => TimedOut
119     //              ||  \\    //  ||
120     //              ||   \\  //   ||
121     //              ||    \\//    ||
122     //              ||     //     ||
123     //              ||    //\\    ||
124     //              ||   //  \\   ||
125     //              \/  \/    \/  \/
126     //             Success    Failure
127     enum class Status {
128         Pending,
129         Loading,
130         TimedOut,
131         Success,
132         Failure
133     };
134
135     struct UnicodeRange {
136         UnicodeRange(UChar32 from, UChar32 to)
137             : m_from(from)
138             , m_to(to)
139         {
140         }
141
142         UChar32 from() const { return m_from; }
143         UChar32 to() const { return m_to; }
144
145     private:
146         UChar32 m_from;
147         UChar32 m_to;
148     };
149
150     // We don't guarantee that the FontFace wrapper will be the same every time you ask for it.
151     Ref<FontFace> wrapper();
152
153 #if ENABLE(SVG_FONTS)
154     bool hasSVGFontFaceSource() const;
155 #endif
156
157 private:
158     CSSFontFace(CSSFontSelector*, StyleRuleFontFace*, FontFace*, bool isLocalFallback);
159
160     size_t pump();
161     void setStatus(Status);
162     void notifyClientsOfFontPropertyChange();
163
164     RefPtr<CSSValueList> m_families;
165     FontTraitsMask m_traitsMask { static_cast<FontTraitsMask>(FontStyleNormalMask | FontWeight400Mask) };
166     Vector<UnicodeRange> m_ranges;
167     FontFeatureSettings m_featureSettings;
168     FontVariantSettings m_variantSettings;
169     Vector<std::unique_ptr<CSSFontFaceSource>> m_sources;
170     RefPtr<CSSFontSelector> m_fontSelector;
171     RefPtr<StyleRuleFontFace> m_cssConnection;
172     HashSet<Client*> m_clients;
173     WeakPtr<FontFace> m_wrapper;
174     Status m_status { Status::Pending };
175     bool m_isLocalFallback { false };
176     bool m_sourcesPopulated { false };
177 };
178
179 }
180
181 #endif