En esta página

QRawFont Class

La clase QRawFont permite acceder a una única instancia física de una fuente. Más información...

Encabezado: #include <QRawFont>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

enum AntialiasingType { PixelAntialiasing, SubPixelAntialiasing }
enum LayoutFlag { SeparateAdvances, KernedAdvances, UseDesignMetrics }
flags LayoutFlags

Funciones públicas

QRawFont()
QRawFont(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting)
QRawFont(const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference = QFont::PreferDefaultHinting)
QRawFont(const QRawFont &other)
~QRawFont()
QList<QPointF> advancesForGlyphIndexes(const QList<quint32> &glyphIndexes, QRawFont::LayoutFlags layoutFlags) const
bool advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs, QRawFont::LayoutFlags layoutFlags) const
QList<QPointF> advancesForGlyphIndexes(const QList<quint32> &glyphIndexes) const
bool advancesForGlyphIndexes(const quint32 *glyphIndexes, QPointF *advances, int numGlyphs) const
QImage alphaMapForGlyph(quint32 glyphIndex, QRawFont::AntialiasingType antialiasingType = SubPixelAntialiasing, const QTransform &transform = QTransform()) const
qreal ascent() const
qreal averageCharWidth() const
QRectF boundingRect(quint32 glyphIndex) const
qreal capHeight() const
qreal descent() const
QString familyName() const
(since 6.7) QByteArray fontTable(QFont::Tag tag) const
QByteArray fontTable(const char *tag) const
(since 6.11) quint32 glyphCount() const
bool glyphIndexesForChars(const QChar *chars, int numChars, quint32 *glyphIndexes, int *numGlyphs) const
QList<quint32> glyphIndexesForString(const QString &text) const
(since 6.11) QString glyphName(quint32 glyphIndex) const
QFont::HintingPreference hintingPreference() const
bool isValid() const
qreal leading() const
qreal lineThickness() const
void loadFromData(const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference)
void loadFromFile(const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference)
qreal maxCharWidth() const
QPainterPath pathForGlyph(quint32 glyphIndex) const
qreal pixelSize() const
void setPixelSize(qreal pixelSize)
QFont::Style style() const
QString styleName() const
QList<QFontDatabase::WritingSystem> supportedWritingSystems() const
bool supportsCharacter(QChar character) const
bool supportsCharacter(uint ucs4) const
void swap(QRawFont &other)
qreal underlinePosition() const
qreal unitsPerEm() const
int weight() const
qreal xHeight() const
bool operator!=(const QRawFont &other) const
QRawFont &operator=(const QRawFont &other)
bool operator==(const QRawFont &other) const

Miembros públicos estáticos

QRawFont fromFont(const QFont &font, QFontDatabase::WritingSystem writingSystem = QFontDatabase::Any)
size_t qHash(const QRawFont &key, size_t seed = 0)

Descripción detallada

Nota: QRawFont es una clase de bajo nivel. Para la mayoría de los casos, QFont es una clase más adecuada.

Lo más habitual es que, al presentar texto en una interfaz de usuario, se desconozcan en cierta medida las fuentes exactas utilizadas para representar los caracteres. Esto puede deberse a varias razones: por ejemplo, las fuentes físicas reales presentes en el sistema de destino podrían ser inesperadas para los desarrolladores, o el texto podría contener estilos, tamaños o sistemas de escritura seleccionados por el usuario que no sean compatibles con la fuente elegida en el código.

Por lo tanto, la clase ` QFont ` de Qt representa en realidad una consulta de fuentes. Cuando se interpreta el texto, Qt hará todo lo posible por hacer coincidir el texto con la consulta, pero, dependiendo de la compatibilidad, se pueden utilizar diferentes fuentes en segundo plano.

En la mayoría de los casos de uso, esto es tanto previsible como necesario, ya que minimiza la posibilidad de que el texto de la interfaz de usuario no se pueda mostrar. Sin embargo, en algunos casos, podría resultar útil un control más directo sobre el proceso. La clase `QRawFont` existe precisamente para estos casos de uso.

Un objeto QRawFont representa una única instancia física de una fuente determinada con un tamaño de píxel concreto. Es decir, en el caso típico, representa un conjunto de tablas de fuentes TrueType u OpenType y utiliza un tamaño en píxeles especificado por el usuario para convertir las métricas en unidades de píxeles lógicos. Se puede utilizar en combinación con la clase ` QGlyphRun ` para dibujar índices de glifos específicos en posiciones concretas, y también dispone de métodos de acceso a algunos datos relevantes de la fuente física.

QRawFont solo es compatible con las principales tecnologías de fuentes: GDI y DirectWrite en plataformas Windows, FreeType en plataformas Linux y CoreText en macOS. Para otros back-ends de fuentes, las API estarán desactivadas.

QRawFont se puede crear de varias formas:

  • Se puede crear llamando a `QTextLayout::glyphs()` o a `QTextFragment::glyphs()`. Los objetos `QGlyphs` devueltos contendrán objetos `QRawFont` que representan las fuentes reales utilizadas para renderizar cada parte del texto.
  • Se puede crear pasando un objeto ` QFont ` a ` QRawFont::fromFont()`. La función devolverá un objeto `QRawFont` que representa la fuente que se seleccionará en respuesta a la consulta ` QFont ` y al sistema de escritura seleccionado.
  • Se puede crear pasando un nombre de archivo o un objeto ` QByteArray ` directamente al constructor de `QRawFont`, o bien llamando a ` loadFromFile()` o ` loadFromData()`. En este caso, la fuente no se registrará en ` QFontDatabase` y no estará disponible como parte de la selección habitual de fuentes.

Se considera que QRawFont es local al hilo en el que se construye (ya sea mediante un constructor o llamando a loadFromData() o loadFromFile()). El objeto QRawFont no puede trasladarse a otro hilo, sino que deberá recrearse en el hilo en cuestión.

Nota: Para el requisito de almacenar en caché los índices de glifos y las selecciones de fuentes para el texto estático, con el fin de evitar el rediseño y la reorganización en el bucle interno de una aplicación, una mejor opción es la clase QStaticText, ya que optimiza el coste de memoria de la caché y también ofrece la posibilidad de utilizar cachés específicas del motor de dibujo para una mayor aceleración.

Documentación sobre los tipos de miembro

enum QRawFont::AntialiasingType

Esta enumeración representa las diferentes formas en que se puede rasterizar un glifo en la función alphaMapForGlyph().

ConstanteValorDescripción
QRawFont::PixelAntialiasing0Se rasterizará midiendo la cobertura de la forma sobre píxeles completos. La imagen devuelta contiene los valores alfa de cada píxel en función de la cobertura de la forma del glifo.
QRawFont::SubPixelAntialiasing1Se rasterizará midiendo la cobertura de cada subpíxel, devolviendo un valor alfa independiente para cada uno de los componentes rojo, verde y azul de cada píxel.

enum QRawFont::LayoutFlag
flags QRawFont::LayoutFlags

Esta enumeración indica a la función advancesForGlyphIndexes() cómo calcular los avances.

ConstanteValorDescripción
QRawFont::SeparateAdvances0Calculará el avance de cada glifo por separado.
QRawFont::KernedAdvances1Aplicará el kerning entre glifos adyacentes. Ten en cuenta que, actualmente, no se admite el kerning basado en GPOS de OpenType.
QRawFont::UseDesignMetrics2Utiliza métricas de diseño en lugar de métricas optimizadas ajustadas a la resolución del dispositivo de representación. Se puede combinar mediante el operador OR con cualquiera de las opciones anteriores.

El tipo LayoutFlags es un typedef para QFlags<LayoutFlag>. Almacena una combinación OR de valores de LayoutFlag.

Documentación de las funciones de miembro

QRawFont::QRawFont()

Crea un objeto QRawFont no válido.

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

Crea un objeto `QRawFont` que representa la fuente contenida en el archivo ` fontData ` proporcionado, con el tamaño (en píxeles) indicado en ` pixelSize` y utilizando la preferencia de hinting especificada en ` hintingPreference`.

Nota: Los datos deben contener una fuente TrueType u OpenType.

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

Crea un objeto QRawFont que representa la fuente contenida en el archivo al que hace referencia fileName, con el tamaño (en píxeles) indicado en pixelSize y utilizando la preferencia de optimización especificada en hintingPreference.

Nota: El archivo al que se hace referencia debe contener una fuente TrueType u OpenType.

QRawFont::QRawFont(const QRawFont &other)

Crea un objeto `QRawFont`, que es una copia de ` other`.

[noexcept] QRawFont::~QRawFont()

Destruye el QRawFont

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

Devuelve los avances de QRawFont para cada uno de los glyphIndexes en píxeles. Los avances indican la distancia desde la posición de un glifo determinado hasta el punto en el que debe dibujarse el siguiente glifo para que parezca que ambos glifos están sin espaciado. El cálculo de los avances se controla mediante layoutFlags.

Nota: Cuando se solicita « KernedAdvances », esta función aplicará las reglas de kerning de la tabla TrueType « KERN », si está disponible en la fuente. En muchas fuentes modernas, el kerning se gestiona mediante reglas OpenType o reglas AAT, lo que requiere aplicar un paso de modelado completo. Para obtener los resultados del modelado completo del texto, utilice « QTextLayout ».

Véase también QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance() y QTextLayout::glyphRuns().

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

Devuelve los avances de QRawFont para cada uno de los glyphIndexes en unidades de píxel. Los avances indican la distancia desde la posición de un glifo determinado hasta el punto en el que debería dibujarse el siguiente glifo para que parezca que ambos glifos están sin espaciado. Los índices de los glifos se proporcionan mediante la matriz glyphIndexes, mientras que los resultados se devuelven a través de advances; ambas deben tener numGlyphs elementos. El cálculo de los avances se controla mediante layoutFlags.

Nota: Cuando se solicita KernedAdvances, esta función aplicará las reglas de kerning de la tabla TrueType KERN, si está disponible en la fuente. En muchas fuentes modernas, el kerning se gestiona mediante reglas OpenType o reglas AAT, lo que requiere aplicar un paso de modelado completo. Para obtener los resultados del modelado completo del texto, utilice QTextLayout.

Véase también QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance() y QTextLayout::glyphRuns().

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

Devuelve los avances de « QRawFont » para cada uno de los « glyphIndexes » en unidades de píxel. Los avances indican la distancia desde la posición de un glifo determinado hasta el punto en el que debe dibujarse el siguiente glifo para que parezca que ambos glifos están sin espaciado. El avance de cada glifo se calcula por separado.

Esta es una función sobrecargada.

Véase también QTextLine::horizontalAdvance() y QFontMetricsF::horizontalAdvance().

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

Devuelve los avances de QRawFont para cada uno de los glyphIndexes en píxeles. Los avances indican la distancia desde la posición de un glifo determinado hasta el punto en el que debe dibujarse el siguiente glifo para que parezca que ambos glifos están sin espaciado. Los índices de los glifos se proporcionan mediante el array glyphIndexes, mientras que los resultados se devuelven a través de advances; ambos deben tener numGlyphs elementos. El avance de cada glifo se calcula por separado

Esta es una función sobrecargada.

Véase también QTextLine::horizontalAdvance() y QFontMetricsF::horizontalAdvance().

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

Esta función devuelve una imagen rasterizada del glifo en el « glyphIndex » especificado de la fuente subyacente, utilizando el « transform » indicado. Si el « QRawFont » no es válido, esta función devolverá un « QImage » no válido.

Si la fuente es una fuente en color, la imagen resultante contendrá el glifo renderizado con el tamaño de píxel actual. En este caso, se ignorará el parámetro « antialiasingType ».

Por el contrario, si antialiasingType se establece en QRawFont::SubPixelAntialiasing, la imagen resultante estará en formato QImage::Format_RGB32 y los valores RGB de cada píxel representarán las opacidades de subpíxel del píxel en la rasterización del glifo. De lo contrario, la imagen estará en formato QImage::Format_Indexed8 y cada píxel contendrá la opacidad del píxel en la rasterización.

Véase también pathForGlyph() y QPainter::drawGlyphRun().

qreal QRawFont::ascent() const

Devuelve la altura de esta fuente « QRawFont » en píxeles.

La altura de ascenso de una fuente es la distancia desde la línea de base hasta la posición más alta a la que se extienden los caracteres. En la práctica, algunos diseñadores de fuentes se saltan esta regla, por ejemplo, cuando colocan más de un acento encima de un carácter o para dar cabida a un carácter inusual de un idioma exótico, por lo que es posible (aunque poco frecuente) que este valor sea demasiado pequeño.

Véase también QFontMetricsF::ascent().

qreal QRawFont::averageCharWidth() const

Devuelve la anchura media de los caracteres de este QRawFont en píxeles.

Véase también QFontMetricsF::averageCharWidth().

QRectF QRawFont::boundingRect(quint32 glyphIndex) const

Devuelve el rectángulo más pequeño que contiene el glifo con el « glyphIndex » indicado.

qreal QRawFont::capHeight() const

Devuelve la altura de mayúsculas de este QRawFont en píxeles.

La altura de mayúscula de una fuente es la altura que tiene una letra mayúscula por encima de la línea de base. Concretamente, se trata de la altura de las letras mayúsculas planas —como la H o la I—, en contraposición a las letras redondeadas, como la O, o las letras puntiagudas, como la A, que pueden presentar un saliente.

Véase también QFontMetricsF::capHeight().

qreal QRawFont::descent() const

Devuelve el descenso de este QRawFont en píxeles.

El descenso es la distancia desde la línea de base hasta el punto más bajo al que llegan los caracteres. En la práctica, algunos diseñadores de fuentes se saltan esta regla, por ejemplo, para dar cabida a un carácter inusual de un idioma exótico, por lo que es posible (aunque poco frecuente) que este valor sea demasiado pequeño.

Véase también QFontMetricsF::descent().

QString QRawFont::familyName() const

Devuelve el apellido de este QRawFont.

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

Recupera la tabla sfnt especificada por ` tag ` de la fuente física subyacente, o una matriz de bytes vacía si no se ha encontrado dicha tabla. El orden de los bytes de la tabla de fuentes devuelta es Big Endian, tal y como especifica el formato sfnt.

Esta función se introdujo en Qt 6.7.

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

El nombre debe ser una cadena de cuatro caracteres.

Esta función sobrecarga la función « fontTable » (QFont::Tag).

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

Recupera la representación física a partir de una consulta « font ». La fuente física devuelta es la que Qt utilizará preferentemente para mostrar el texto en el writingSystem seleccionado.

Advertencia: Esta función puede resultar costosa y no debe llamarse en código en el que el rendimiento sea un factor crítico.

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

Devuelve el número de glifos de este ` QRawFont`.

Esta función se introdujo en Qt 6.11.

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

Convierte una cadena de puntos Unicode en índices de glifos utilizando la tabla CMAP de la fuente subyacente. La función funciona igual que glyphIndexesForString(), salvo que toma un array (chars); los resultados se devolverán a través de glyphIndexes y el número de glifos se establecerá en numGlyphs. El tamaño del array glyphIndexes debe ser, como mínimo, numChars; si aún así no es suficiente, esta función devolverá «false», en cuyo caso podrás redimensionar glyphIndexes a partir del tamaño devuelto en numGlyphs.

Véase también glyphIndexesForString(), advancesForGlyphIndexes(), QGlyphRun, QTextLayout::glyphRuns() y QTextFragment::glyphRuns().

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

Convierte la cadena de puntos Unicode proporcionada por text en índices de glifos utilizando la tabla CMAP de la fuente subyacente, y devuelve una lista que contiene el resultado.

Ten en cuenta que, en los casos en los que haya otras tablas en la fuente que afecten a la configuración del texto, los índices de glifos devueltos no representarán correctamente la visualización del texto. Para obtener el texto con la forma correcta, puede utilizar QTextLayout para maquetar y dar forma al texto y, a continuación, llamar a QTextLayout::glyphs() para obtener el conjunto de índices de glifos y los pares QRawFont.

Véase también advancesForGlyphIndexes(), glyphIndexesForChars(), QGlyphRun, QTextLayout::glyphRuns() y QTextFragment::glyphRuns().

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

Devuelve el nombre del « glyphIndex » indicado.

Si el glifo no tiene un nombre explícito en la fuente, se genera un nombre basándose en su índice de glifo.

Esta función se introdujo en Qt 6.11.

QFont::HintingPreference QRawFont::hintingPreference() const

Devuelve la preferencia de hinting utilizada para crear este QRawFont.

Véase también QFont::hintingPreference().

bool QRawFont::isValid() const

Devuelve « true » si « QRawFont » es válido y «false» en caso contrario.

qreal QRawFont::leading() const

Devuelve el espacio entre líneas de este QRawFont en píxeles.

Se trata del interlineado natural.

Véase también QFontMetricsF::leading().

qreal QRawFont::lineThickness() const

Devuelve el grosor de las líneas (subrayado, sobrelineado, etc.) que se dibujan junto con el texto escrito con esta fuente.

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

Sustituye el archivo « QRawFont » actual por la fuente contenida en el archivo « fontData » proporcionado, con el tamaño (en píxeles) indicado en « pixelSize », y utilizando la preferencia de optimización especificada en « hintingPreference ».

El archivo fontData debe contener una fuente TrueType u OpenType.

Véase también loadFromFile().

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

Sustituye el archivo « QRawFont » actual por el contenido del archivo al que hace referencia « fileName », con el tamaño (en píxeles) indicado en « pixelSize » y utilizando la preferencia de optimización especificada en « hintingPreference ».

El archivo debe hacer referencia a una fuente TrueType u OpenType.

Véase también loadFromData().

qreal QRawFont::maxCharWidth() const

Devuelve la anchura del carácter más ancho de la fuente.

Véase también QFontMetricsF::maxWidth().

QPainterPath QRawFont::pathForGlyph(quint32 glyphIndex) const

Esta función devuelve la forma del glifo en un « glyphIndex » determinado de la fuente subyacente, siempre que el « QRawFont » sea válido. De lo contrario, devuelve un « QPainterPath » vacío.

El glifo devuelto siempre estará sin optimización.

Véanse también alphaMapForGlyph() y QPainterPath::addText().

qreal QRawFont::pixelSize() const

Devuelve el tamaño en píxeles establecido para este ` QRawFont`. El tamaño en píxeles influye en cómo se rasterizan los glifos, en el tamaño de los glifos devueltos por ` pathForGlyph()` y se utiliza para convertir las métricas internas de unidades de diseño a unidades de píxeles lógicos.

Véase también setPixelSize().

void QRawFont::setPixelSize(qreal pixelSize)

Establece el tamaño en píxeles con el que debe representarse esta fuente en pixelSize.

Véase también pixelSize().

QFont::Style QRawFont::style() const

Devuelve el estilo de este QRawFont.

Véase también QFont::style().

QString QRawFont::styleName() const

Devuelve el nombre del estilo de este QRawFont.

Véase también QFont::styleName().

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

Devuelve una lista de los sistemas de escritura compatibles con la fuente, según la información facilitada por el diseñador en el archivo de la fuente. Ten en cuenta que esto no garantiza la compatibilidad con un punto Unicode específico en la fuente. Puedes utilizar la función supportsCharacter() para comprobar la compatibilidad con un carácter concreto.

Nota: La lista se determina en función de los rangos Unicode y de página de códigos establecidos en la tabla OS/2 de la fuente, y requiere que dicha tabla esté presente en el archivo de fuente subyacente.

Véase también supportsCharacter().

bool QRawFont::supportsCharacter(QChar character) const

Devuelve ` true ` si la fuente tiene un glifo que se corresponde con el ` character` indicado.

Véase también supportedWritingSystems().

bool QRawFont::supportsCharacter(uint ucs4) const

Devuelve ` true ` si la fuente tiene un glifo que se corresponde con el carácter codificado en UCS-4 ` ucs4`.

Esta es una función sobrecargada.

Véase también supportedWritingSystems().

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

Sustituye esta fuente sin procesar por other. Esta operación es muy rápida y nunca falla.

qreal QRawFont::underlinePosition() const

Devuelve la posición respecto a la línea de base para dibujar subrayados debajo del texto representado con esta fuente.

qreal QRawFont::unitsPerEm() const

Devuelve el número de unidades de diseño que definen la anchura y la altura del cuadrado de 1 em para este QRawFont. Este valor se utiliza junto con el tamaño en píxeles al convertir las medidas de diseño a unidades de píxeles, ya que las medidas internas se especifican en unidades de diseño y el tamaño en píxeles indica el tamaño de 1 em en píxeles.

Véase también pixelSize() y setPixelSize().

int QRawFont::weight() const

Devuelve el peso de este QRawFont.

Véase también QFont::weight().

qreal QRawFont::xHeight() const

Devuelve la altura «x» de este objeto « QRawFont » en píxeles.

A menudo, aunque no siempre, coincide con la altura del carácter «x».

Véase también QFontMetricsF::xHeight().

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

Devuelve « true » si este « QRawFont » no es igual a « other ». En caso contrario, devuelve « false ».

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

Asigna other a esta dirección: QRawFont.

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

Devuelve « true » si « QRawFont » es igual a « other ». En caso contrario, devuelve « false ».

Elementos no miembros relacionados

[noexcept] size_t qHash(const QRawFont &key, size_t seed = 0)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.