include/QtGui/qrawfont.h

0001 // Copyright (C) 2016 The Qt Company Ltd.
0002 // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
0003
0004 #ifndef QRAWFONT_H
0005 #define QRAWFONT_H
0006
0007 #include <QtGui/qtguiglobal.h>
0008 #include <QtCore/qstring.h>
0009 #include <QtCore/qiodevice.h>
0010 #include <QtCore/qglobal.h>
0011 #include <QtCore/qobject.h>
0012 #include <QtCore/qpoint.h>
0013 #include <QtGui/qfont.h>
0014 #include <QtGui/qtransform.h>
0015 #include <QtGui/qfontdatabase.h>
0016
0017 #if !defined(QT_NO_RAWFONT)
0018
0019 QT_BEGIN_NAMESPACE
0020
0021
0022 class QRawFontPrivate;
0023 class Q_GUI_EXPORT QRawFont
0024 {
0025 public:
0026     enum AntialiasingType {
0027         PixelAntialiasing,
0028         SubPixelAntialiasing
0029     };
0030
0031     enum LayoutFlag {
0032         SeparateAdvances = 0,
0033         KernedAdvances = 1,
0034         UseDesignMetrics = 2
0035     };
0036     Q_DECLARE_FLAGS(LayoutFlags, LayoutFlag)
0037
0038     QRawFont();
0039     QRawFont(const QString &fileName,
0040              qreal pixelSize,
0041              QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting);
0042     QRawFont(const QByteArray &fontData,
0043              qreal pixelSize,
0044              QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting);
0045     QRawFont(const QRawFont &other);
0046     QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(QRawFont)
0047     QRawFont &operator=(const QRawFont &other);
0048     ~QRawFont();
0049
0050     void swap(QRawFont &other) noexcept { d.swap(other.d); }
0051
0052     bool isValid() const;
0053
0054     bool operator==(const QRawFont &other) const;
0055     inline bool operator!=(const QRawFont &other) const
0056     { return !operator==(other); }
0057
0058     quint32 glyphCount() const;
0059
0060     QString familyName() const;
0061     QString styleName() const;
0062
0063     QFont::Style style() const;
0064     int weight() const;
0065
0066     QList<quint32> glyphIndexesForString(const QString &text) const;
0067     inline QList<QPointF> advancesForGlyphIndexes(const QList<quint32> &glyphIndexes) const;
0068     QList<QPointF> advancesForGlyphIndexes(const QList<quint32> &glyphIndexes,
0069                                            LayoutFlags layoutFlags) const;
0070     bool glyphIndexesForChars(const QChar *chars, int numChars, quint32 *glyphIndexes, int *numGlyphs) const;
0071     bool advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs) const;
0072     bool advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs, LayoutFlags layoutFlags) const;
0073
0074     QImage alphaMapForGlyph(quint32 glyphIndex,
0075                             AntialiasingType antialiasingType = SubPixelAntialiasing,
0076                             const QTransform &transform = QTransform()) const;
0077     QPainterPath pathForGlyph(quint32 glyphIndex) const;
0078     QRectF boundingRect(quint32 glyphIndex) const;
0079
0080     void setPixelSize(qreal pixelSize);
0081     qreal pixelSize() const;
0082
0083     QFont::HintingPreference hintingPreference() const;
0084
0085     qreal ascent() const;
0086     qreal capHeight() const;
0087     qreal descent() const;
0088     qreal leading() const;
0089     qreal xHeight() const;
0090     qreal averageCharWidth() const;
0091     qreal maxCharWidth() const;
0092     qreal lineThickness() const;
0093     qreal underlinePosition() const;
0094
0095     qreal unitsPerEm() const;
0096
0097     QString glyphName(quint32 glyphIndex) const;
0098
0099     void loadFromFile(const QString &fileName,
0100                       qreal pixelSize,
0101                       QFont::HintingPreference hintingPreference);
0102
0103     void loadFromData(const QByteArray &fontData,
0104                       qreal pixelSize,
0105                       QFont::HintingPreference hintingPreference);
0106
0107     bool supportsCharacter(uint ucs4) const;
0108     bool supportsCharacter(QChar character) const;
0109     QList<QFontDatabase::WritingSystem> supportedWritingSystems() const;
0110
0111     QByteArray fontTable(const char *tagName) const;
0112     QByteArray fontTable(QFont::Tag tag) const;
0113
0114     static QRawFont fromFont(const QFont &font,
0115                              QFontDatabase::WritingSystem writingSystem = QFontDatabase::Any);
0116
0117 private:
0118     friend class QRawFontPrivate;
0119     friend class QTextLayout;
0120     friend class QTextEngine;
0121
0122     QExplicitlySharedDataPointer<QRawFontPrivate> d;
0123 };
0124
0125 Q_DECLARE_SHARED(QRawFont)
0126
0127 Q_DECLARE_OPERATORS_FOR_FLAGS(QRawFont::LayoutFlags)
0128
0129 Q_GUI_EXPORT size_t qHash(const QRawFont &font, size_t seed = 0) noexcept;
0130
0131
0132
0133 inline QList<QPointF> QRawFont::advancesForGlyphIndexes(const QList<quint32> &glyphIndexes) const
0134 {
0135     return advancesForGlyphIndexes(glyphIndexes, QRawFont::SeparateAdvances);
0136 }
0137
0138 QT_END_NAMESPACE
0139
0140 #endif // QT_NO_RAWFONT
0141
0142 #endif // QRAWFONT_H