Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qfontengine_ft_p.h
Go to the documentation of this file.
1// Copyright (C) 2021 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3#ifndef QFONTENGINE_FT_P_H
4#define QFONTENGINE_FT_P_H
5//
6// W A R N I N G
7// -------------
8//
9// This file is not part of the Qt API. It exists purely as an
10// implementation detail. This header file may change from version to
11// version without notice, or even be removed.
12//
13// We mean it.
14//
15
16#include "private/qfontengine_p.h"
17
18#ifndef QT_NO_FREETYPE
19
20#include <ft2build.h>
21#include FT_FREETYPE_H
22#include FT_MULTIPLE_MASTERS_H
23
24#if defined(FT_COLOR_H)
25# include FT_COLOR_H
26#endif
27
28#ifndef Q_OS_WIN
29#include <unistd.h>
30#endif
31
32#include <qmutex.h>
33
34#include <string.h>
35#include <qpainterpath.h>
36
37#include <utility> // for std::pair
38
39QT_BEGIN_NAMESPACE
40
41class QFontEngineFTRawFont;
42class QFontconfigDatabase;
43class QColrPaintGraphRenderer;
44
45#if defined(FT_COLOR_H) && (FREETYPE_MAJOR*10000 + FREETYPE_MINOR*100 + FREETYPE_PATCH) >= 21300
46# define QFONTENGINE_FT_SUPPORT_COLRV1
47#endif
48
49/*
50 * This class represents one font file on disk (like Arial.ttf) and is shared between all the font engines
51 * that show this font file (at different pixel sizes).
52 */
53class Q_GUI_EXPORT QFreetypeFace
54{
55public:
56 void computeSize(const QFontDef &fontDef, int *xsize, int *ysize, bool *outline_drawing, QFixed *scalableBitmapScaleFactor);
57 QFontEngine::Properties properties() const;
58 bool getSfntTable(uint tag, uchar *buffer, uint *length) const;
59
60 static QFreetypeFace *getFace(const QFontEngine::FaceId &face_id,
61 const QByteArray &fontData = QByteArray());
62 void release(const QFontEngine::FaceId &face_id);
63
64 static int getFaceIndexByStyleName(const QString &faceFileName, const QString &styleName);
65
66 // locks the struct for usage. Any read/write operations require locking.
67 void lock()
68 {
69 _lock.lock();
70 }
71 void unlock()
72 {
73 _lock.unlock();
74 }
75
76 FT_Face face;
77 FT_MM_Var *mm_var;
78 int xsize; // 26.6
79 int ysize; // 26.6
80 FT_Matrix matrix;
81 FT_CharMap unicode_map;
82 FT_CharMap symbol_map;
83
84 enum { cmapCacheSize = 0x200 };
85 glyph_t cmapCache[cmapCacheSize];
86
87 int fsType() const;
88
89 int getPointInOutline(glyph_t glyph, int flags, quint32 point, QFixed *xpos, QFixed *ypos, quint32 *nPoints);
90
91 bool isScalableBitmap() const;
92
93 static void addGlyphToPath(FT_Face face, FT_GlyphSlot g, const QFixedPoint &point, QPainterPath *path, FT_Fixed x_scale, FT_Fixed y_scale);
94 static void addBitmapToPath(FT_GlyphSlot slot, const QFixedPoint &point, QPainterPath *path);
95
96 inline QList<QFontVariableAxis> variableAxes() const
97 {
98 return variableAxisList;
99 }
100
101private:
102 friend class QFontEngineFT;
103 friend class QtFreetypeData;
104 QFreetypeFace() = default;
105 ~QFreetypeFace() {}
106 void cleanup();
107 QAtomicInt ref;
108 QRecursiveMutex _lock;
109 QByteArray fontData;
110
111 QFontEngine::Holder hbFace;
112 QList<QFontVariableAxis> variableAxisList;
113};
114
115class Q_GUI_EXPORT QFontEngineFT : public QFontEngine
116{
117public:
118 struct GlyphInfo {
119 int linearAdvance;
120 unsigned short width;
121 unsigned short height;
122 short x;
123 short y;
124 short xOff;
125 short yOff;
126 };
127
128 struct GlyphAndSubPixelPosition
129 {
130 GlyphAndSubPixelPosition(glyph_t g, const QFixedPoint spp) : glyph(g), subPixelPosition(spp) {}
131
132 bool operator==(const GlyphAndSubPixelPosition &other) const
133 {
134 return glyph == other.glyph && subPixelPosition == other.subPixelPosition;
135 }
136
137 glyph_t glyph;
138 QFixedPoint subPixelPosition;
139 };
140
141 struct QGlyphSet
142 {
143 QGlyphSet();
144 ~QGlyphSet();
145 FT_Matrix transformationMatrix;
146 bool outline_drawing;
147
148 void removeGlyphFromCache(glyph_t index, const QFixedPoint &subPixelPosition);
149 void clear();
150 inline bool useFastGlyphData(glyph_t index, const QFixedPoint &subPixelPosition) const {
151 return (index < 256 && subPixelPosition.x == 0 && subPixelPosition.y == 0);
152 }
153 inline Glyph *getGlyph(glyph_t index,
154 const QFixedPoint &subPixelPositionX = QFixedPoint()) const;
155 void setGlyph(glyph_t index, const QFixedPoint &spp, Glyph *glyph);
156
157 inline bool isGlyphMissing(glyph_t index) const { return missing_glyphs.contains(index); }
158 inline void setGlyphMissing(glyph_t index) const { missing_glyphs.insert(index); }
159private:
160 Q_DISABLE_COPY(QGlyphSet);
161 mutable QHash<GlyphAndSubPixelPosition, Glyph *> glyph_data; // maps from glyph index to glyph data
162 mutable QSet<glyph_t> missing_glyphs;
163 mutable Glyph *fast_glyph_data[256]; // for fast lookup of glyphs < 256
164 mutable int fast_glyph_count;
165 };
166
167 QFontEngine::FaceId faceId() const override;
168 QFontEngine::Properties properties() const override;
169 QFixed emSquareSize() const override;
170 bool supportsHorizontalSubPixelPositions() const override
171 {
172 return default_hint_style == HintLight ||
173 default_hint_style == HintNone ||
174 verticalHintingOnly;
175 }
176
177 bool supportsVerticalSubPixelPositions() const override
178 {
179 return supportsHorizontalSubPixelPositions();
180 }
181
182 bool getSfntTableData(uint tag, uchar *buffer, uint *length) const override;
183 int synthesized() const override;
184
185 void initializeHeightMetrics() const override;
186 QFixed capHeight() const override;
187 QFixed xHeight() const override;
188 QFixed averageCharWidth() const override;
189
190 qreal maxCharWidth() const override;
191 QFixed lineThickness() const override;
192 QFixed underlinePosition() const override;
193
194 glyph_t glyphIndex(uint ucs4) const override;
195 QString glyphName(glyph_t index) const override;
196 void doKerning(QGlyphLayout *, ShaperFlags) const override;
197
198 void getUnscaledGlyph(glyph_t glyph, QPainterPath *path, glyph_metrics_t *metrics) override;
199
200 bool supportsTransformation(const QTransform &transform) const override;
201
202 void addGlyphsToPath(glyph_t *glyphs, QFixedPoint *positions, int nglyphs,
203 QPainterPath *path, QTextItem::RenderFlags flags) override;
204 void addOutlineToPath(qreal x, qreal y, const QGlyphLayout &glyphs,
205 QPainterPath *path, QTextItem::RenderFlags flags) override;
206
207 int stringToCMap(const QChar *str, int len, QGlyphLayout *glyphs, int *nglyphs, ShaperFlags flags) const override;
208
209 glyph_metrics_t boundingBox(const QGlyphLayout &glyphs) override;
210 glyph_metrics_t boundingBox(glyph_t glyph) override;
211 glyph_metrics_t boundingBox(glyph_t glyph, const QTransform &matrix) override;
212
213 void recalcAdvances(QGlyphLayout *glyphs, ShaperFlags flags) const override;
214 QImage alphaMapForGlyph(glyph_t g) override { return alphaMapForGlyph(g, QFixedPoint()); }
215 QImage alphaMapForGlyph(glyph_t, const QFixedPoint &) override;
216 QImage alphaMapForGlyph(glyph_t glyph, const QFixedPoint &subPixelPosition, const QTransform &t) override;
217 QImage alphaRGBMapForGlyph(glyph_t, const QFixedPoint &subPixelPosition, const QTransform &t) override;
218 QImage bitmapForGlyph(glyph_t, const QFixedPoint &subPixelPosition, const QTransform &t, const QColor &color) override;
219 glyph_metrics_t alphaMapBoundingBox(glyph_t glyph,
220 const QFixedPoint &subPixelPosition,
221 const QTransform &matrix,
222 QFontEngine::GlyphFormat format) override;
223 Glyph *glyphData(glyph_t glyph,
224 const QFixedPoint &subPixelPosition,
225 GlyphFormat neededFormat,
226 const QTransform &t) override;
227 bool hasInternalCaching() const override { return cacheEnabled; }
228 bool expectsGammaCorrectedBlending(QFontEngine::GlyphFormat format) const override;
229
230 void removeGlyphFromCache(glyph_t glyph) override;
231 int glyphMargin(QFontEngine::GlyphFormat /* format */) override { return 0; }
232
233 int glyphCount() const override;
234
235 QList<QFontVariableAxis> variableAxes() const override;
236
237 enum Scaling {
238 Scaled,
239 Unscaled
240 };
241 FT_Face lockFace(Scaling scale = Scaled) const;
242 void unlockFace() const;
243
244 FT_Face non_locked_face() const;
245
246 inline bool drawAntialiased() const { return antialias; }
247 inline bool invalid() const { return xsize == 0 && ysize == 0; }
248 inline bool isBitmapFont() const { return defaultFormat == Format_Mono; }
249 inline bool isScalableBitmap() const { return freetype->isScalableBitmap(); }
250
251 inline Glyph *loadGlyph(uint glyph,
252 const QFixedPoint &subPixelPosition,
253 GlyphFormat format = Format_None,
254 bool fetchMetricsOnly = false,
255 bool disableOutlineDrawing = false) const
256 {
257 return loadGlyph(cacheEnabled ? &defaultGlyphSet : nullptr,
258 glyph,
259 subPixelPosition,
260 QColor(),
261 format,
262 fetchMetricsOnly,
263 disableOutlineDrawing);
264 }
265 Glyph *loadGlyph(QGlyphSet *set,
266 uint glyph,
267 const QFixedPoint &subPixelPosition,
268 QColor color,
269 GlyphFormat = Format_None,
270 bool fetchMetricsOnly = false,
271 bool disableOutlineDrawing = false) const;
272 Glyph *loadGlyphFor(glyph_t g,
273 const QFixedPoint &subPixelPosition,
274 GlyphFormat format,
275 const QTransform &t,
276 QColor color,
277 bool fetchBoundingBox = false,
278 bool disableOutlineDrawing = false);
279
280 QGlyphSet *loadGlyphSet(const QTransform &matrix);
281
282 QFontEngineFT(const QFontDef &fd);
283 virtual ~QFontEngineFT();
284
285 bool init(FaceId faceId, bool antiaalias, GlyphFormat defaultFormat = Format_None,
286 const QByteArray &fontData = QByteArray());
287 bool init(FaceId faceId, bool antialias, GlyphFormat format,
288 QFreetypeFace *freetypeFace);
289
290 int getPointInOutline(glyph_t glyph, int flags, quint32 point, QFixed *xpos, QFixed *ypos, quint32 *nPoints) override;
291
292 void setQtDefaultHintStyle(QFont::HintingPreference hintingPreference);
293 void setDefaultHintStyle(HintStyle style) override;
294 bool setVerticalHintingOnly();
295
296 QFontEngine *cloneWithSize(qreal pixelSize) const override;
297 Qt::HANDLE handle() const override;
298 bool initFromFontEngine(const QFontEngineFT *fontEngine);
299
300 HintStyle defaultHintStyle() const { return default_hint_style; }
301
302 static QFontEngineFT *create(const QFontDef &fontDef, FaceId faceId, const QByteArray &fontData = QByteArray());
303 static QFontEngineFT *create(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference, const QMap<QFont::Tag, float> &variableAxisValue, int instanceIndex = 0);
304
305protected:
306
307 QFreetypeFace *freetype;
308 mutable int default_load_flags;
309 HintStyle default_hint_style;
310 bool antialias;
311 bool transform;
312 bool embolden;
313 bool obliquen;
314 SubpixelAntialiasingType subpixelType;
315 int lcdFilterType;
316 bool embeddedbitmap;
317 bool cacheEnabled;
318 bool forceAutoHint;
319 bool stemDarkeningDriver;
320 bool verticalHintingOnly;
321
322private:
323 friend class QFontEngineFTRawFont;
324 friend class QFontconfigDatabase;
325 friend class QFreeTypeFontDatabase;
326 friend class QFontEngineMultiFontConfig;
327
328 int loadFlags(QGlyphSet *set, GlyphFormat format, int flags, bool &hsubpixel, int &vfactor) const;
329 void setFaceSize(int xsize, int ysize) const;
330 bool shouldUseDesignMetrics(ShaperFlags flags) const;
331 QFixed scaledBitmapMetrics(QFixed m) const;
332 glyph_metrics_t scaledBitmapMetrics(const glyph_metrics_t &m, const QTransform &matrix) const;
333
334#if defined(QFONTENGINE_FT_SUPPORT_COLRV1)
335 Glyph *loadColrv1Glyph(QGlyphSet *set,
336 Glyph *g,
337 uint glyph,
338 const QColor &color,
339 bool fetchMetricsOnly) const;
340
341 bool traverseColr1(FT_OpaquePaint paint,
342 QSet<std::pair<FT_Byte *, FT_Bool> > *loops,
343 QColor foregroundColor,
344 FT_Color *palette,
345 ushort paletteCount,
346 QColrPaintGraphRenderer *paintGraphRenderer) const;
347 mutable glyph_t colrv1_bounds_cache_id = 0;
348 mutable QRect colrv1_bounds_cache;
349#endif // QFONTENGINE_FT_SUPPORT_COLRV1
350
351 GlyphFormat defaultFormat;
352 FT_Matrix matrix;
353
354 struct TransformedGlyphSets {
355 enum { nSets = 10 };
356 QGlyphSet *sets[nSets];
357
358 QGlyphSet *findSet(const QTransform &matrix, const QFontDef &fontDef);
359 TransformedGlyphSets() { std::fill(&sets[0], &sets[nSets], nullptr); }
360 ~TransformedGlyphSets() { qDeleteAll(&sets[0], &sets[nSets]); }
361 private:
362 void moveToFront(int i);
363 Q_DISABLE_COPY(TransformedGlyphSets);
364 };
365 TransformedGlyphSets transformedGlyphSets;
366 mutable QGlyphSet defaultGlyphSet;
367
368 QFontEngine::FaceId face_id;
369
370 int xsize;
371 int ysize;
372
373 QFixed line_thickness;
374 QFixed underline_position;
375
376 FT_Size_Metrics metrics;
377 mutable bool kerning_pairs_loaded;
378 QFixed scalableBitmapScaleFactor;
379};
380
381
382inline size_t qHash(const QFontEngineFT::GlyphAndSubPixelPosition &g, size_t seed = 0)
383{
384 return qHashMulti(seed,
385 g.glyph,
386 g.subPixelPosition.x.value(),
387 g.subPixelPosition.y.value());
388}
389
390inline QFontEngineFT::Glyph *QFontEngineFT::QGlyphSet::getGlyph(glyph_t index,
391 const QFixedPoint &subPixelPosition) const
392{
393 if (useFastGlyphData(index, subPixelPosition))
394 return fast_glyph_data[index];
395 return glyph_data.value(GlyphAndSubPixelPosition(index, subPixelPosition));
396}
397
398Q_GUI_EXPORT FT_Library qt_getFreetype();
399
400QT_END_NAMESPACE
401
402#endif // QT_NO_FREETYPE
403
404#endif // QFONTENGINE_FT_P_H
QThreadStorage
\inmodule QtCore
Definition qthreadstorage.h:159
QtFreetypeData::faces
QHash< QFontEngine::FaceId, QFreetypeFace * > faces
Definition qfontengine_ft.cpp:109
QtFreetypeData::staleFaces
QList< QFreetypeFace * > staleFaces
Definition qfontengine_ft.cpp:110
QtFreetypeData::faceIndices
QHash< FaceStyle, int > faceIndices
Definition qfontengine_ft.cpp:111
QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qsequentialanimationgroup.cpp:47
hasTrueTypeInterpreterV40
static bool hasTrueTypeInterpreterV40(FT_Library library)
Definition qfontengine_ft.cpp:1135
ftInitialDefaultHintStyle
static const QFontEngine::HintStyle ftInitialDefaultHintStyle
Definition qfontengine_ft.cpp:81
FLOOR
#define FLOOR(x)
Definition qfontengine_ft.cpp:59
subpixelAntialiasingTypeHint
static QFontEngine::SubpixelAntialiasingType subpixelAntialiasingTypeHint()
Definition qfontengine_ft.cpp:805
QTransformToFTMatrix
static FT_Matrix QTransformToFTMatrix(const QTransform &matrix)
Definition qfontengine_ft.cpp:2279
transformBoundingBox
static void transformBoundingBox(int *left, int *top, int *right, int *bottom, FT_Matrix *matrix)
Definition qfontengine_ft.cpp:1211
convertRGBToARGB
static void convertRGBToARGB(const uchar *src, uint *dst, int width, int height, int src_pitch, bool bgr)
Definition qfontengine_ft.cpp:774
qt_getFreetypeData
QtFreetypeData * qt_getFreetypeData()
Definition qfontengine_ft.cpp:146
calculateActualItalic
static bool calculateActualItalic(QFreetypeFace *freetypeFace, FT_Face face, QFontEngine::FaceId faceId)
Definition qfontengine_ft.cpp:963
CEIL
#define CEIL(x)
Definition qfontengine_ft.cpp:60
is2dRotation
static bool is2dRotation(const QTransform &t)
Definition qfontengine_ft.cpp:2842
alphaMapFromGlyphData
static QImage alphaMapFromGlyphData(QFontEngineFT::Glyph *glyph, QFontEngine::GlyphFormat glyphFormat)
Definition qfontengine_ft.cpp:2791
emptyGlyph
static QFontEngineFT::Glyph emptyGlyph
Definition qfontengine_ft.cpp:79
qt_fontdata_from_index
QByteArray qt_fontdata_from_index(int)
Definition qfontdatabase.cpp:2213
qHash
size_t qHash(const QtFreetypeData::FaceStyle &style, size_t seed)
Definition qfontengine_ft.cpp:139
ft_getSfntTable
static bool ft_getSfntTable(void *user_data, uint tag, uchar *buffer, uint *length)
Definition qfontengine_ft.cpp:64
qt_addBitmapToPath
void qt_addBitmapToPath(qreal x0, qreal y0, const uchar *image_data, int bpl, int w, int h, QPainterPath *path)
Definition qfontengine.cpp:741
computeFaceIndex
static int computeFaceIndex(const QString &faceFileName, const QString &styleName)
Definition qfontengine_ft.cpp:498
operator==
bool operator==(const QtFreetypeData::FaceStyle &style1, const QtFreetypeData::FaceStyle &style2)
Definition qfontengine_ft.cpp:134
qt_getFreetype
FT_Library qt_getFreetype()
Definition qfontengine_ft.cpp:162
calculateActualWeight
static FT_UShort calculateActualWeight(QFreetypeFace *freetypeFace, FT_Face face, QFontEngine::FaceId faceId)
Definition qfontengine_ft.cpp:842
GLYPH2PATH_DEBUG
#define GLYPH2PATH_DEBUG
Definition qfontengine_ft.cpp:668
convertRGBToARGB_V
static void convertRGBToARGB_V(const uchar *src, uint *dst, int width, int height, int src_pitch, bool bgr)
Definition qfontengine_ft.cpp:791
scaleOutline
static void scaleOutline(FT_Face face, FT_GlyphSlot g, FT_Fixed x_scale, FT_Fixed y_scale)
Definition qfontengine_ft.cpp:655
obliqueSlant
static const FT_Fixed obliqueSlant
Definition qfontengine_ft.cpp:1815
dont_delete
static void dont_delete(void *)
Definition qfontengine_ft.cpp:961
ROUND
#define ROUND(x)
Definition qfontengine_ft.cpp:62
areMetricsTooLarge
static bool areMetricsTooLarge(const QFontEngineFT::GlyphInfo &info)
Definition qfontengine_ft.cpp:1205
TRUNC
#define TRUNC(x)
Definition qgrayraster.c:186
qHash
constexpr size_t qHash(const QSize &s, size_t seed=0) noexcept
Definition qsize.h:192
QtFreetypeData::FaceStyle::FaceStyle
FaceStyle(QString faceFileName, QString styleName)
Definition qfontengine_ft.cpp:102