QRawFont Class

Dokumentation der Mitgliedsfunktionen

QRawFont::QRawFont()

Konstruiert einen ungültigen QRawFont.

QRawFont::QRawFont(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting)

Konstruiert einen QRawFont, der die in der übergebenen Datei fontData enthaltene Schriftart in der durch pixelSize angegebenen Größe (in Pixeln) und unter Verwendung der durch hintingPreference angegebenen Hinting-Präferenz darstellt.

QRawFont::QRawFont(const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting)

Konstruiert einen QRawFont, der die in der von fileName referenzierten Datei enthaltene Schriftart in der von pixelSize angegebenen Größe (in Pixeln) und unter Verwendung der von hintingPreference angegebenen Hinting-Präferenz darstellt.

QRawFont::QRawFont(const QRawFont &other)

Erzeugt einen QRawFont, der eine Kopie von other ist.

[noexcept] QRawFont::~QRawFont()

Zerstört die QRawFont

QList<QPointF> QRawFont::advancesForGlyphIndexes(const QList<quint32> &glyphIndexes, QRawFont::LayoutFlags layoutFlags) const

Liefert die QRawFont's Fortschritte für jede der glyphIndexes in Pixel-Einheiten. Die Abstände geben den Abstand von der Position einer gegebenen Glyphe bis zu der Stelle an, an der die nächste Glyphe gezeichnet werden sollte, damit es so aussieht, als ob die beiden Glyphen nicht voneinander getrennt wären. Wie die Abstände berechnet werden, wird von layoutFlags gesteuert.

Siehe auch QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance(), und QTextLayout::glyphRuns().

bool QRawFont::advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs, QRawFont::LayoutFlags layoutFlags) const

Liefert die QRawFont's Fortschritte für jede der glyphIndexes in Pixel-Einheiten. Die Vorschübe geben den Abstand von der Position einer gegebenen Glyphe bis zu der Stelle an, an der die nächste Glyphe gezeichnet werden sollte, damit es so aussieht, als ob die beiden Glyphen nicht voneinander getrennt wären. Die Glyphenindizes werden mit dem Array glyphIndexes angegeben, während die Ergebnisse über advances zurückgegeben werden. Beide müssen numGlyphs Elemente haben. Wie die Vorrückungen berechnet werden, wird durch layoutFlags gesteuert.

Siehe auch QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance(), und QTextLayout::glyphRuns().

QList<QPointF> QRawFont::advancesForGlyphIndexes(const QList<quint32> &glyphIndexes) const

Dies ist eine überladene Funktion.

Gibt die Vorschübe von QRawFont für jede der glyphIndexes in Pixeleinheiten zurück. Die Abstände geben den Abstand von der Position einer gegebenen Glyphe bis zu der Stelle an, an der die nächste Glyphe gezeichnet werden sollte, damit es so aussieht, als ob die beiden Glyphen nicht voneinander getrennt wären. Der Abstand wird für jede Glyphe separat berechnet.

Siehe auch QTextLine::horizontalAdvance() und QFontMetricsF::horizontalAdvance().

bool QRawFont::advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs) const

Dies ist eine überladene Funktion.

Gibt die Vorschübe von QRawFont für jede der glyphIndexes in Pixeleinheiten zurück. Die Abstände geben den Abstand von der Position einer gegebenen Glyphe zu der Stelle an, an der die nächste Glyphe gezeichnet werden sollte, damit es so aussieht, als ob die beiden Glyphen keinen Abstand hätten. Die Glyphenindizes werden mit dem Array glyphIndexes angegeben, während die Ergebnisse durch advances zurückgegeben werden. Beide müssen numGlyphs Elemente haben. Der Abstand jeder Glyphe wird separat berechnet

Siehe auch QTextLine::horizontalAdvance() und QFontMetricsF::horizontalAdvance().

QImage QRawFont::alphaMapForGlyph(quint32 glyphIndex, QRawFont::AntialiasingType antialiasingType = SubPixelAntialiasing, const QTransform &transform = QTransform()) const

Diese Funktion gibt ein gerastertes Bild der Glyphe an der angegebenen glyphIndex in der zugrunde liegenden Schriftart unter Verwendung der angegebenen transform zurück. Wenn die QRawFont nicht gültig ist, gibt diese Funktion ein ungültiges QImage zurück.

Handelt es sich bei der Schriftart um eine Farbschrift, so enthält das resultierende Bild die gerenderte Glyphe in der aktuellen Pixelgröße. In diesem Fall wird die Angabe antialiasingType ignoriert.

Andernfalls, wenn antialiasingType auf QRawFont::SubPixelAntialiasing gesetzt ist, wird das resultierende Bild in QImage::Format_RGB32 sein und die RGB-Werte jedes Pixels werden die Subpixel-Opazitäten des Pixels in der Rasterung der Glyphe darstellen. Andernfalls hat das Bild das Format QImage::Format_Indexed8 und jedes Pixel enthält die Deckkraft des Pixels in der Rasterung.

Siehe auch pathForGlyph() und QPainter::drawGlyphRun().

qreal QRawFont::ascent() const

Gibt die Steigung dieser QRawFont in Pixel-Einheiten zurück.

Die Steigung einer Schriftart ist der Abstand von der Grundlinie bis zur höchsten Position, zu der die Zeichen reichen. In der Praxis brechen einige Schriftdesigner diese Regel, z. B. wenn sie mehr als einen Akzent auf ein Zeichen setzen oder um ein ungewöhnliches Zeichen in einer exotischen Sprache unterzubringen, daher ist es möglich (wenn auch selten), dass dieser Wert zu klein ist.

Siehe auch QFontMetricsF::ascent().

qreal QRawFont::averageCharWidth() const

Gibt die durchschnittliche Zeichenbreite dieser QRawFont in Pixel-Einheiten zurück.

Siehe auch QFontMetricsF::averageCharWidth().

QRectF QRawFont::boundingRect(quint32 glyphIndex) const

Gibt das kleinste Rechteck zurück, das die Glyphe mit dem angegebenen glyphIndex enthält.

qreal QRawFont::capHeight() const

Gibt die Versalhöhe dieser QRawFont in Pixel-Einheiten zurück.

Die Versalhöhe einer Schriftart ist die Höhe eines Großbuchstabens über der Grundlinie. Es handelt sich insbesondere um die Höhe von Großbuchstaben, die flach sind - wie H oder I - im Gegensatz zu runden Buchstaben wie O oder spitzen Buchstaben wie A, die beide Überhöhungen aufweisen können.

Siehe auch QFontMetricsF::capHeight().

qreal QRawFont::descent() const

Gibt das Gefälle dieser QRawFont in Pixel-Einheiten zurück.

Das Gefälle ist der Abstand von der Grundlinie bis zum niedrigsten Punkt, bis zu dem die Zeichen reichen. In der Praxis brechen einige Schriftdesigner diese Regel, z. B. um ein ungewöhnliches Zeichen in einer exotischen Sprache unterzubringen, daher ist es möglich (wenn auch selten), dass dieser Wert zu klein ist.

Siehe auch QFontMetricsF::descent().

QString QRawFont::familyName() const

Gibt den Familiennamen dieses QRawFont zurück.

[since 6.7] QByteArray QRawFont::fontTable(QFont::Tag tag) const

Ruft die durch tag angegebene sfnt-Tabelle aus der zugrundeliegenden physischen Schriftart ab oder ein leeres Byte-Array, wenn keine solche Tabelle gefunden wurde. Die Byte-Reihenfolge der zurückgegebenen Font-Tabelle ist Big Endian, wie es das sfnt-Format vorschreibt.

Diese Funktion wurde in Qt 6.7 eingeführt.

QByteArray QRawFont::fontTable(const char *tag) const

Diese Funktion überlastet fontTable(QFont::Tag).

Der Name muss eine vierstellige Zeichenkette sein.

[static] QRawFont QRawFont::fromFont(const QFont &font, QFontDatabase::WritingSystem writingSystem = QFontDatabase::Any)

Holt die physische Darstellung basierend auf einer font Abfrage. Die zurückgegebene physische Schriftart ist die Schriftart, die von Qt bevorzugt wird, um Text in der ausgewählten writingSystem anzuzeigen.

bool QRawFont::glyphIndexesForChars(const QChar *chars, int numChars, quint32 *glyphIndexes, int *numGlyphs) const

Konvertiert eine Zeichenkette aus Unicode-Punkten in Glyphen-Indizes unter Verwendung der CMAP-Tabelle in der zugrunde liegenden Schriftart. Die Funktion funktioniert wie glyphIndexesForString(), außer dass sie ein Array (chars) nimmt, die Ergebnisse werden durch das Array glyphIndexes zurückgegeben und die Anzahl der Glyphen wird in numGlyphs gesetzt. Die Größe des Arrays glyphIndexes muss mindestens numChars betragen, wenn das nicht ausreicht, gibt die Funktion false zurück, dann können Sie die Größe von glyphIndexes anhand der in numGlyphs zurückgegebenen Größe ändern.

Siehe auch glyphIndexesForString(), advancesForGlyphIndexes(), QGlyphRun, QTextLayout::glyphRuns(), und QTextFragment::glyphRuns().

QList<quint32> QRawFont::glyphIndexesForString(const QString &text) const

Konvertiert die durch text angegebene Zeichenkette von Unicode-Punkten in Glyph-Indizes unter Verwendung der CMAP-Tabelle in der zugrunde liegenden Schriftart und gibt eine Liste mit dem Ergebnis zurück.

Beachten Sie, dass in Fällen, in denen andere Tabellen in der Schriftart die Formgebung des Textes beeinflussen, die zurückgegebenen Glyphenindizes die Darstellung des Textes nicht korrekt wiedergeben werden. Um den korrekt geformten Text zu erhalten, können Sie QTextLayout verwenden, um den Text anzuordnen und zu formen, und dann QTextLayout::glyphs() aufrufen, um die Glyphenindexliste und die QRawFont Paare zu erhalten.

Siehe auch advancesForGlyphIndexes(), glyphIndexesForChars(), QGlyphRun, QTextLayout::glyphRuns(), und QTextFragment::glyphRuns().

QFont::HintingPreference QRawFont::hintingPreference() const

Liefert die Hinting-Präferenz zurück, die für die Konstruktion dieser QRawFont verwendet wurde.

Siehe auch QFont::hintingPreference().

bool QRawFont::isValid() const

Gibt true zurück, wenn die QRawFont gültig ist, und andernfalls false.

qreal QRawFont::leading() const

Gibt den Abstand dieser QRawFont in Pixel-Einheiten zurück.

Dies ist der natürliche Abstand zwischen den Zeilen.

Siehe auch QFontMetricsF::leading().

qreal QRawFont::lineThickness() const

Gibt die Dicke der Linien (Unterstreichung, Überstreichung usw.) zurück, mit denen Text in dieser Schriftart gezeichnet wird.

void QRawFont::loadFromData(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference)

Ersetzt die aktuelle QRawFont durch die in der übergebenen fontData enthaltene Schriftart in der durch pixelSize angegebenen Größe (in Pixeln) und unter Verwendung der durch hintingPreference angegebenen Hinting-Präferenz.

Die fontData muss eine TrueType- oder OpenType-Schriftart enthalten.

Siehe auch loadFromFile().

void QRawFont::loadFromFile(const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference)

Ersetzt die aktuelle Datei QRawFont durch den Inhalt der Datei, auf die fileName verweist, und zwar in der durch pixelSize angegebenen Größe (in Pixeln) und unter Verwendung der durch hintingPreference angegebenen Hinting-Präferenz.

Die Datei muss auf eine TrueType- oder OpenType-Schriftart verweisen.

Siehe auch loadFromData().

qreal QRawFont::maxCharWidth() const

Gibt die Breite des breitesten Zeichens in der Schriftart zurück.

Siehe auch QFontMetricsF::maxWidth().

QPainterPath QRawFont::pathForGlyph(quint32 glyphIndex) const

Diese Funktion gibt die Form der Glyphe unter einer bestimmten glyphIndex in der zugrunde liegenden Schriftart zurück, wenn die QRawFont gültig ist. Andernfalls gibt sie ein leeres QPainterPath zurück.

Die zurückgegebene Glyphe ist immer unhinted.

Siehe auch alphaMapForGlyph() und QPainterPath::addText().

qreal QRawFont::pixelSize() const

Gibt die für diese QRawFont eingestellte Pixelgröße zurück. Die Pixelgröße wirkt sich darauf aus, wie Glyphen gerastert werden, auf die Größe von Glyphen, die von pathForGlyph() zurückgegeben werden, und wird verwendet, um interne Metriken von Design-Einheiten in logische Pixel-Einheiten umzuwandeln.

Siehe auch setPixelSize().

void QRawFont::setPixelSize(qreal pixelSize)

Setzt die Pixelgröße, mit der diese Schrift gerendert werden soll, auf pixelSize.

Siehe auch pixelSize().

QFont::Style QRawFont::style() const

Gibt den Stil dieses QRawFont zurück.

Siehe auch QFont::style().

QString QRawFont::styleName() const

Gibt den Stilnamen dieses QRawFont zurück.

Siehe auch QFont::styleName().

QList<QFontDatabase::WritingSystem> QRawFont::supportedWritingSystems() const

Liefert eine Liste der von der Schriftart unterstützten Schriftsysteme gemäß den vom Designer bereitgestellten Informationen in der Schriftartdatei. Bitte beachten Sie, dass dies keine Garantie für die Unterstützung eines bestimmten Unicode-Punktes in der Schriftart ist. Sie können supportsCharacter() verwenden, um die Unterstützung für ein einzelnes, spezifisches Zeichen zu überprüfen.

Siehe auch supportsCharacter().

bool QRawFont::supportsCharacter(QChar character) const

Gibt true zurück, wenn die Schriftart eine Glyphe hat, die der angegebenen character entspricht.

Siehe auch supportedWritingSystems().

bool QRawFont::supportsCharacter(uint ucs4) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn die Schriftart eine Glyphe hat, die dem UCS-4-kodierten Zeichen ucs4 entspricht.

Siehe auch supportedWritingSystems().

[noexcept] void QRawFont::swap(QRawFont &other)

Tauscht diese Rohschrift gegen other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

qreal QRawFont::underlinePosition() const

Gibt die Position von der Grundlinie für das Zeichnen von Unterstreichungen unter dem mit dieser Schriftart gerenderten Text zurück.

qreal QRawFont::unitsPerEm() const

Gibt die Anzahl der Designeinheiten zurück, die die Breite und Höhe des em-Quadrats für dieses QRawFont definieren. Dieser Wert wird zusammen mit der Pixelgröße bei der Konvertierung von Designmetriken in Pixeleinheiten verwendet, da die internen Metriken in Designeinheiten angegeben werden und die Pixelgröße die Größe von 1 em in Pixeln angibt.

Siehe auch pixelSize() und setPixelSize().

int QRawFont::weight() const

Gibt das Gewicht dieses QRawFont zurück.

Siehe auch QFont::weight().

qreal QRawFont::xHeight() const

Gibt die xHöhe dieses QRawFont in Pixel-Einheiten zurück.

Dies entspricht oft, aber nicht immer, der Höhe des Zeichens 'x'.

Siehe auch QFontMetricsF::xHeight().

bool QRawFont::operator!=(const QRawFont &other) const

Gibt true zurück, wenn dieses QRawFont nicht gleich other ist. Andernfalls wird false zurückgegeben.

QRawFont &QRawFont::operator=(const QRawFont &other)

Weist other dieser QRawFont zu.

bool QRawFont::operator==(const QRawFont &other) const

Gibt true zurück, wenn dieses QRawFont gleich other ist. Andernfalls wird false zurückgegeben.