QRawFont Class

Dokumentation der Mitgliedsfunktionen

QRawFont::QRawFont()

Erstellt einen ungültigen QRawFont.

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

Erstellt ein QRawFont-Objekt, das die in der übergebenen Datei „ fontData “ enthaltene Schriftart für die durch „ pixelSize “ angegebene Größe (in Pixeln) darstellt und dabei die durch „ hintingPreference “ festgelegten Hinting-Einstellungen verwendet.

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

Erstellt ein QRawFont-Objekt, das die Schriftart darstellt, die in der unter fileName referenzierten Datei enthalten ist, und zwar in der unter pixelSize angegebenen Größe (in Pixeln) und unter Verwendung der unter hintingPreference festgelegten Hinting-Einstellung.

QRawFont::QRawFont(const QRawFont &other)

Erstellt ein „QRawFont“-Objekt, das eine Kopie von „ other “ ist.

[noexcept] QRawFont::~QRawFont()

Zerstört die QRawFont

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

Gibt die Abstände „ QRawFont “ für jedes der „ glyphIndexes “ in Pixel an. Die Abstände geben den Abstand zwischen der Position eines bestimmten Glyphs und der Stelle an, an der das nächste Glyph gezeichnet werden sollte, damit es so aussieht, als ob zwischen den beiden Glyphen kein Abstand wäre. Wie die Abstände berechnet werden, wird durch „ 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

Gibt die Abstände des „ QRawFont “ für jedes der „ glyphIndexes “ in Pixel an. Die Abstände geben den Abstand zwischen der Position eines bestimmten Glyphs und der Stelle an, an der das nächste Glyph gezeichnet werden sollte, damit es so aussieht, als ob zwischen den beiden Glyphen kein Abstand wäre. Die Glyphenindizes werden über das Array „ glyphIndexes “ angegeben, während die Ergebnisse über „ advances “ zurückgegeben werden; beide müssen „ numGlyphs “-Elemente enthalten. Wie die Abstände berechnet werden, wird durch „ layoutFlags “ gesteuert.

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

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

Gibt die Abstände „ QRawFont “ für jedes der „ glyphIndexes “ in Pixel an. Diese Abstände geben den Abstand zwischen der Position eines bestimmten Glyphs und der Stelle an, an der das nächste Glyph gezeichnet werden sollte, damit es so aussieht, als ob zwischen den beiden Glyphen kein Abstand wäre. Der Abstand jedes Glyphs wird separat berechnet.

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

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

Gibt die Abstände des „ QRawFont “ für jedes der „ glyphIndexes “ in Pixel an. Diese Abstände geben den Abstand zwischen der Position eines bestimmten Glyphs und der Stelle an, an der das nächste Glyph gezeichnet werden sollte, damit es so aussieht, als ob zwischen den beiden Glyphen kein Abstand wäre. Die Glyphenindizes werden über das Array ` glyphIndexes ` angegeben, während die Ergebnisse über ` advances` zurückgegeben werden; beide müssen ` numGlyphs ` Elemente enthalten. 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 des Glyphs an der angegebenen Adresse ` glyphIndex ` in der zugrunde liegenden Schriftart zurück, wobei die angegebene Schriftart ` transform ` verwendet wird. Ist die Adresse ` QRawFont ` ungültig, gibt diese Funktion ein ungültiges Bild ` QImage` zurück.

Handelt es sich bei der Schriftart um eine Farbschriftart, enthält das resultierende Bild das gerenderte Glyph in der aktuellen Pixelgröße. In diesem Fall wird der Parameter „ antialiasingType “ ignoriert.

Andernfalls, wenn ` antialiasingType ` auf ` QRawFont::SubPixelAntialiasing` gesetzt ist, liegt das resultierende Bild im Format ` QImage::Format_RGB32 ` vor, und die RGB-Werte jedes Pixels stellen die Subpixel-Deckkräfte des Pixels bei der Rasterung des Glyphs dar. Andernfalls liegt das Bild im Format ` QImage::Format_Indexed8 ` vor, und jedes Pixel enthält die Deckkraft des Pixels bei der Rasterung.

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

qreal QRawFont::ascent() const

Gibt die Höhe dieser Schriftart QRawFont in Pixel an.

Der Aufstieg einer Schriftart ist der Abstand von der Grundlinie bis zur höchsten Position, bis zu der sich Zeichen erstrecken. In der Praxis weichen manche Schriftdesigner von dieser Regel ab, z. B. wenn sie mehr als ein Akzentzeichen über 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 dieses QRawFont in Pixel an.

Siehe auch QFontMetricsF::averageCharWidth().

QRectF QRawFont::boundingRect(quint32 glyphIndex) const

Gibt das kleinste Rechteck zurück, das das Glyph mit dem angegebenen „ glyphIndex “ enthält.

qreal QRawFont::capHeight() const

Gibt die Großbuchstabenhöhe dieser Schriftart „ QRawFont “ in Pixel an.

Die Versalhöhe einer Schriftart ist die Höhe eines Großbuchstabens über der Grundlinie. Genauer gesagt handelt es sich dabei um die Höhe von flachen Großbuchstaben – wie beispielsweise H oder I – im Gegensatz zu runden Buchstaben wie O oder spitzen Buchstaben wie A, bei denen es zu einem Überlauf kommen kann.

Siehe auch QFontMetricsF::capHeight().

qreal QRawFont::descent() const

Gibt die Abwärtshöhe dieses „ QRawFont “ in Pixel an.

Die Unterlänge ist der Abstand von der Grundlinie bis zum tiefsten Punkt, bis zu dem sich Zeichen erstrecken. In der Praxis weichen manche Schriftgestalter von dieser Regel ab, z. B. um ein ungewöhnliches Zeichen in einer exotischen Sprache unterzubringen, sodass es möglich ist (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 zugrunde liegenden physischen Schriftart ab oder gibt ein leeres Byte-Array zurück, falls keine solche Tabelle gefunden wurde. Die Byte-Reihenfolge der zurückgegebenen Schriftarttabelle 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

Der Name muss aus vier Zeichen bestehen.

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

Ruft die physische Darstellung auf der Grundlage einer „ font “-Abfrage ab. Die zurückgegebene physische Schriftart ist die Schriftart, die von Qt bevorzugt wird, um Text in der ausgewählten „ writingSystem “ anzuzeigen.

[since 6.11] quint32 QRawFont::glyphCount() const

Gibt die Anzahl der Glyphen in diesem „ QRawFont “ zurück.

Diese Funktion wurde in Qt 6.11 eingeführt.

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

Konvertiert eine Zeichenkette aus Unicode-Punkten mithilfe der CMAP-Tabelle der zugrunde liegenden Schriftart in Glyphenindizes. Die Funktion arbeitet wie glyphIndexesForString(), mit dem Unterschied, dass sie ein Array (chars) entgegennimmt; die Ergebnisse werden über das Array glyphIndexes zurückgegeben, und die Anzahl der Glyphen wird in numGlyphs festgelegt. Die Größe des Arrays glyphIndexes muss mindestens numChars betragen; sollte dies immer noch nicht ausreichen, gibt diese Funktion „false“ zurück. In diesem Fall können Sie die Größe von glyphIndexes anhand der in numGlyphs zurückgegebenen Größe anpassen.

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

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

Wandelt die durch ` text ` angegebene Zeichenkette aus Unicode-Punkten mithilfe der CMAP-Tabelle der zugrunde liegenden Schriftart in Glyphenindizes um und gibt eine Liste mit dem Ergebnis zurück.

Beachten Sie, dass in Fällen, in denen die Schriftart weitere Tabellen enthält, die die Gestaltung des Textes beeinflussen, die zurückgegebenen Glyphenindizes die Darstellung des Textes nicht korrekt wiedergeben. Um den korrekt formatierten Text zu erhalten, können Sie QTextLayout verwenden, um den Text zu layouten und zu formatieren, und anschließend QTextLayout::glyphs() aufrufen, um die Liste der Glyphenindizes sowie die Paare aus „ QRawFont “ zu erhalten.

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

[since 6.11] QString QRawFont::glyphName(quint32 glyphIndex) const

Gibt den Namen des angegebenen „ glyphIndex “ zurück.

Wenn das Glyph in der Schriftart keinen expliziten Namen hat, wird anhand seines Glyph-Index ein Name generiert.

Diese Funktion wurde in Qt 6.11 eingeführt.

QFont::HintingPreference QRawFont::hintingPreference() const

Gibt die Hinting-Einstellung zurück, die zum Erstellen dieses „ QRawFont “ verwendet wurde.

Siehe auch QFont::hintingPreference().

bool QRawFont::isValid() const

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

qreal QRawFont::leading() const

Gibt den Zeilenabstand dieser QRawFont in Pixel an.

Dies ist der natürliche Zeilenabstand.

Siehe auch QFontMetricsF::leading().

qreal QRawFont::lineThickness() const

Gibt die Strichstärke für Linien (Unterstreichungen, Überstriche usw.) zurück, die zusammen mit dem in dieser Schriftart gezeichneten Text dargestellt werden.

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

Ersetzt die aktuelle Schriftart „ QRawFont “ durch die im bereitgestellten „ fontData “ enthaltene Schriftart in der durch „ pixelSize “ angegebenen Größe (in Pixeln) und unter Verwendung der durch „ hintingPreference “ festgelegten Hinting-Einstellung.

Die Datei „ 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 “ festgelegten Hinting-Einstellung.

Die Datei muss auf eine TrueType- oder OpenType-Schrift 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 des Glyphs an einer bestimmten Koordinate ` glyphIndex ` in der zugrunde liegenden Schriftart zurück, sofern die ` QRawFont ` gültig ist. Andernfalls gibt sie eine leere ` QPainterPath` zurück.

Das zurückgegebene Glyph ist immer unhinted.

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

qreal QRawFont::pixelSize() const

Gibt die für dieses ` QRawFont` festgelegte Pixelgröße zurück. Die Pixelgröße beeinflusst die Art und Weise, wie Glyphen gerastert werden, die Größe der von ` pathForGlyph()` zurückgegebenen Glyphen und wird verwendet, um interne Metriken von Designeinheiten in logische Pixeleinheiten umzurechnen.

Siehe auch setPixelSize().

void QRawFont::setPixelSize(qreal pixelSize)

Legt die Pixelgröße fest, mit der diese Schriftart gerendert werden soll: 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

Gibt eine Liste der von der Schriftart unterstützten Schriftsysteme zurück, basierend auf den vom Designer in der Schriftartdatei bereitgestellten Informationen. Bitte beachten Sie, dass dies keine Garantie für die Unterstützung eines bestimmten Unicode-Punkts in der Schriftart darstellt. Mit der Funktion „ supportsCharacter()“ können Sie die Unterstützung für ein einzelnes, bestimmtes Zeichen überprüfen.

Siehe auch supportsCharacter().

bool QRawFont::supportsCharacter(QChar character) const

Gibt „ true “ zurück, wenn die Schriftart ein Glyph enthält, das dem angegebenen „ character “ entspricht.

Siehe auch supportedWritingSystems().

bool QRawFont::supportsCharacter(uint ucs4) const

Gibt „ true “ zurück, wenn die Schriftart ein Glyph enthält, das dem UCS-4-kodierten Zeichen „ ucs4 “ entspricht.

Siehe auch supportedWritingSystems().

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

Ersetzt diese Rohschriftart durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

qreal QRawFont::underlinePosition() const

Gibt die Position ab der Grundlinie zurück, an der Unterstreichungen unterhalb des mit dieser Schriftart gerenderten Textes gezeichnet werden.

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 verwendet, wenn Designmaße in Pixeleinheiten umgerechnet werden, da die internen Maße in Designeinheiten angegeben sind 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 xHeight dieses „ QRawFont “ in Pixel an.

Diese entspricht oft, aber nicht immer, der Höhe des Buchstabens „x“.

Siehe auch QFontMetricsF::xHeight().

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

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

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

Weist „ other “ diesem „ QRawFont “ zu.

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

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