QRawFont Class

Documentation des fonctions membres

QRawFont::QRawFont()

Crée un objet QRawFont non valide.

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

Crée un objet QRawFont représentant la police contenue dans le fichier fourni fontData pour la taille (en pixels) indiquée par pixelSize, et en utilisant les préférences d'optimisation spécifiées par hintingPreference.

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

Crée une instance de QRawFont représentant la police contenue dans le fichier référencé par fileName, pour la taille (en pixels) indiquée par pixelSize, et en utilisant les paramètres d'optimisation spécifiés par hintingPreference.

QRawFont::QRawFont(const QRawFont &other)

Crée un objet `QRawFont` qui est une copie de ` other`.

[noexcept] QRawFont::~QRawFont()

Détruit le QRawFont

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

Renvoie les avances de l'QRawFont pour chacun des glyphIndexes, exprimées en pixels. Les avances correspondent à la distance entre la position d'un glyphe donné et l'endroit où le glyphe suivant doit être tracé pour donner l'impression que les deux glyphes sont contigus. Le mode de calcul des avances est contrôlé par layoutFlags.

Voir également QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance() et QTextLayout::glyphRuns().

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

Renvoie les avances de l'QRawFont pour chacun des glyphIndexes, exprimées en pixels. Ces avances correspondent à la distance entre la position d'un glyphe donné et l'endroit où le glyphe suivant doit être dessiné pour donner l'impression que les deux glyphes sont contigus. Les indices des glyphes sont fournis via le tableau glyphIndexes tandis que les résultats sont renvoyés via advances; ces deux tableaux doivent comporter numGlyphs éléments. Le mode de calcul des avances est contrôlé par layoutFlags.

Voir également QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance() et QTextLayout::glyphRuns().

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

Renvoie les avances de l'QRawFont pour chacun des glyphIndexes, exprimées en pixels. Ces avances correspondent à la distance entre la position d'un glyphe donné et l'endroit où le glyphe suivant doit être dessiné pour donner l'impression que les deux glyphes sont contigus. L'avance de chaque glyphe est calculée séparément.

Voir également QTextLine::horizontalAdvance() et QFontMetricsF::horizontalAdvance().

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

Renvoie les avances de l'QRawFont pour chacun des glyphIndexes, exprimées en pixels. Ces avances correspondent à la distance entre la position d'un glyphe donné et l'endroit où le glyphe suivant doit être dessiné pour donner l'impression que les deux glyphes sont contigus. Les indices des glyphes sont fournis via le tableau glyphIndexes, tandis que les résultats sont renvoyés via advances; ces deux tableaux doivent comporter numGlyphs éléments. L'avance de chaque glyphe est calculée séparément

Voir également QTextLine::horizontalAdvance() et QFontMetricsF::horizontalAdvance().

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

Cette fonction renvoie une image rasterisée du glyphe à l'glyphIndex spécifiée dans la police sous-jacente, en utilisant l'transform indiquée. Si l'QRawFont n'est pas valide, cette fonction renverra une valeur non valide QImage.

Si la police est une police en couleur, l’image résultante contiendra le glyphe rendu à la taille de pixel actuelle. Dans ce cas, l’ antialiasingType sera ignorée.

Sinon, si antialiasingType est défini sur QRawFont::SubPixelAntialiasing, l’image résultante sera au format QImage::Format_RGB32 et les valeurs RVB de chaque pixel représenteront les opacités des sous-pixels du pixel dans la rastérisation du glyphe. Dans le cas contraire, l’image sera au format QImage::Format_Indexed8 et chaque pixel contiendra l’opacité du pixel dans la rastérisation.

Voir également pathForGlyph() et QPainter::drawGlyphRun().

qreal QRawFont::ascent() const

Renvoie la hauteur de cette police « QRawFont » en pixels.

L'ascension d'une police correspond à la distance entre la ligne de base et la position la plus haute atteinte par les caractères. Dans la pratique, certains créateurs de polices dérogent à cette règle, par exemple lorsqu'ils placent plusieurs accents au-dessus d'un caractère, ou pour prendre en charge un caractère inhabituel dans une langue exotique ; il est donc possible (bien que rare) que cette valeur soit trop petite.

Voir aussi QFontMetricsF::ascent().

qreal QRawFont::averageCharWidth() const

Renvoie la largeur moyenne des caractères de cette chaîne « QRawFont » en pixels.

Voir aussi QFontMetricsF::averageCharWidth().

QRectF QRawFont::boundingRect(quint32 glyphIndex) const

Renvoie le plus petit rectangle contenant le glyphe dont l’ glyphIndex est spécifiée.

qreal QRawFont::capHeight() const

Renvoie la hauteur des majuscules de cette police « QRawFont » en pixels.

La hauteur des majuscules d’une police correspond à la hauteur d’une lettre majuscule au-dessus de la ligne de base. Il s’agit plus précisément de la hauteur des lettres majuscules plates — telles que H ou I — par opposition aux lettres arrondies comme O ou aux lettres pointues comme A, qui peuvent toutes deux présenter un dépassement.

Voir aussi QFontMetricsF::capHeight().

qreal QRawFont::descent() const

Renvoie la descente de cette QRawFont, exprimée en pixels.

La descente correspond à la distance entre la ligne de base et le point le plus bas atteint par les caractères. Dans la pratique, certains créateurs de polices dérogent à cette règle, par exemple pour s'adapter à un caractère inhabituel dans une langue exotique ; il est donc possible (bien que rare) que cette valeur soit trop petite.

Voir aussi QFontMetricsF::descent().

QString QRawFont::familyName() const

Renvoie le nom de famille de cet QRawFont.

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

Récupère la table sfnt spécifiée par ` tag ` à partir de la police physique sous-jacente, ou un tableau d'octets vide si aucune table de ce type n'a été trouvée. L'ordre des octets de la table de polices renvoyée est « Big Endian », comme le spécifie le format sfnt.

Cette fonction a été introduite dans Qt 6.7.

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

Le nom doit être une chaîne de quatre caractères.

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

Récupère la représentation physique à partir d'une requête de type « font ». La police physique renvoyée est celle que Qt privilégiera pour afficher le texte dans l'writingSystem sélectionnée.

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

Renvoie le nombre de glyphes contenus dans cet objet ` QRawFont`.

Cette fonction a été introduite dans Qt 6.11.

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

Convertit une chaîne de points Unicode en indices de glyphes à l'aide de la table CMAP de la police sous-jacente. Cette fonction fonctionne comme glyphIndexesForString(), à la différence près qu’elle prend un tableau (chars) ; les résultats sont renvoyés via le tableau glyphIndexes et le nombre de glyphes est défini dans numGlyphs. La taille du tableau glyphIndexes doit être au moins égale à numChars; si cela s’avère insuffisant, cette fonction renvoie false, et vous pouvez alors redimensionner glyphIndexes en fonction de la taille renvoyée dans numGlyphs.

Voir également glyphIndexesForString(), advancesForGlyphIndexes(), QGlyphRun, QTextLayout::glyphRuns() et QTextFragment::glyphRuns().

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

Convertit la chaîne de points Unicode fournie par text en indices de glyphes à l'aide de la table CMAP de la police sous-jacente, puis renvoie une liste contenant le résultat.

Notez que, dans les cas où la police contient d’autres tables affectant la mise en forme du texte, les index de glyphes renvoyés ne représenteront pas correctement le rendu du texte. Pour obtenir un texte correctement mis en forme, vous pouvez utiliser ` QTextLayout ` pour mettre en page et mettre en forme le texte, puis appeler `QTextLayout::glyphs()` pour obtenir l’ensemble des paires index de glyphe/ QRawFont.

Voir également advancesForGlyphIndexes(), glyphIndexesForChars(), QGlyphRun, QTextLayout::glyphRuns() et QTextFragment::glyphRuns().

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

Renvoie le nom de l'glyphIndex e spécifiée.

Si le glyphe n'a pas de nom explicite dans la police, un nom est généré à partir de son index de glyphe.

Cette fonction a été introduite dans Qt 6.11.

QFont::HintingPreference QRawFont::hintingPreference() const

Renvoie la préférence d'hinting utilisée pour créer ce fichier « QRawFont ».

Voir aussi QFont::hintingPreference().

bool QRawFont::isValid() const

Renvoie « true » si l’ QRawFont est valide, et « false » dans le cas contraire.

qreal QRawFont::leading() const

Renvoie l'espacement entre les lignes de cette QRawFont en pixels.

Il s'agit de l'espacement naturel entre les lignes.

Voir aussi QFontMetricsF::leading().

qreal QRawFont::lineThickness() const

Renvoie l'épaisseur des lignes (soulignement, surlignement, etc.) tracées en même temps que le texte affiché dans cette police.

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

Remplace la police actuelle QRawFont par la police contenue dans le fichier fourni fontData, pour la taille (en pixels) indiquée par pixelSize, et en utilisant les paramètres d'optimisation spécifiés par hintingPreference.

Le fichier fontData doit contenir une police TrueType ou OpenType.

Voir également loadFromFile().

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

Remplace l’ QRawFont actuel par le contenu du fichier référencé par fileName, pour la taille (en pixels) indiquée par pixelSize, et en utilisant les paramètres de hinting spécifiés par hintingPreference.

Le fichier doit faire référence à une police TrueType ou OpenType.

Voir également loadFromData().

qreal QRawFont::maxCharWidth() const

Renvoie la largeur du caractère le plus large de la police.

Voir aussi QFontMetricsF::maxWidth().

QPainterPath QRawFont::pathForGlyph(quint32 glyphIndex) const

QRawFont Cette fonction renvoie la forme du glyphe à une coord glyphIndex e donnée dans la police sous-jacente si l' est valide. Sinon, elle renvoie une QPainterPath vide.

Le glyphe renvoyé ne sera jamais optimisé.

Voir également alphaMapForGlyph() et QPainterPath::addText().

qreal QRawFont::pixelSize() const

Renvoie la taille en pixels définie pour cet objet ` QRawFont`. La taille en pixels influe sur la manière dont les glyphes sont rastérisés, sur la taille des glyphes renvoyés par la fonction ` pathForGlyph()`, et sert à convertir les métriques internes des unités de conception en unités de pixels logiques.

Voir également setPixelSize().

void QRawFont::setPixelSize(qreal pixelSize)

Définit la taille en pixels à laquelle cette police doit être affichée sur pixelSize.

Voir également pixelSize().

QFont::Style QRawFont::style() const

Renvoie le style de cet élément QRawFont.

Voir aussi QFont::style().

QString QRawFont::styleName() const

Renvoie le nom du style associé à cette QRawFont.

Voir aussi QFont::styleName().

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

Renvoie une liste des systèmes d’écriture pris en charge par la police, conformément aux informations fournies par le concepteur dans le fichier de police. Veuillez noter que cela ne garantit pas la prise en charge d’un point Unicode spécifique dans la police. Vous pouvez utiliser la fonction ` supportsCharacter()` pour vérifier la prise en charge d’un caractère unique et spécifique.

Voir également la fonction supportsCharacter().

bool QRawFont::supportsCharacter(QChar character) const

Renvoie « true » si la police contient un glyphe correspondant à l'character donné.

Voir également supportedWritingSystems().

bool QRawFont::supportsCharacter(uint ucs4) const

Renvoie « true » si la police contient un glyphe correspondant au caractère codé en UCS-4 « ucs4 ».

Voir également supportedWritingSystems().

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

Remplace cette police brute par other. Cette opération est très rapide et ne pose jamais de problème.

qreal QRawFont::underlinePosition() const

Renvoie la position par rapport à la ligne de base pour le tracé des soulignements sous le texte affiché avec cette police.

qreal QRawFont::unitsPerEm() const

Renvoie le nombre d'unités de conception définissant la largeur et la hauteur du carré « em » pour cette propriété QRawFont. Cette valeur est utilisée conjointement avec la taille en pixels lors de la conversion des mesures de conception en unités de pixels, car les mesures internes sont spécifiées en unités de conception et la taille en pixels indique la taille d'un « em » en pixels.

Voir également pixelSize() et setPixelSize().

int QRawFont::weight() const

Renvoie le poids de cet QRawFont.

Voir aussi QFont::weight().

qreal QRawFont::xHeight() const

Renvoie la hauteur « x » (xHeight) de cet objet « QRawFont » en pixels.

Cette valeur correspond souvent, mais pas toujours, à la hauteur du caractère « x ».

Voir aussi QFontMetricsF::xHeight().

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

Renvoie « true » si « QRawFont » n'est pas égal à « other ». Sinon, renvoie « false ».

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

Attribue l'other à cette adresse QRawFont.

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

Renvoie « true » si « QRawFont » est égal à « other ». Sinon, renvoie « false ».