QRawFont Class

成员函数文档

QRawFont::QRawFont()

构建了一个无效的 QRawFont。

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

构建一个 QRawFont 对象，该对象表示所提供的fontData 中包含的字体，其大小（以像素为单位）由pixelSize 指定，并使用由hintingPreference 指定的提示首选项。

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

创建一个 QRawFont 对象，该对象表示由fileName 引用的文件中所包含的字体，其大小（以像素为单位）由pixelSize 指定，并使用由hintingPreference 指定的提示首选项。

QRawFont::QRawFont(const QRawFont &other)

创建一个 QRawFont 对象，该对象是other 的副本。

[noexcept] QRawFont::~QRawFont()

摧毁了QRawFont

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

返回QRawFont 中每个glyphIndexes 的间距值（单位为像素）。这些间距值表示从给定字形的位置到下一个字形应绘制位置的距离，以使两个字形看起来没有间隙。间距值的计算方式由layoutFlags 控制。

另请参阅 QTextLine::horizontalAdvance()、QFontMetricsF::horizontalAdvance() 和QTextLayout::glyphRuns()。

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

返回QRawFont 中每个glyphIndexes 的间距（单位为像素）。这些间距表示从给定字形的位置到下一个字形应绘制位置的距离，以确保两个字形看起来没有间隔。 字形索引通过数组glyphIndexes 提供，而结果则通过advances 返回，两者都必须包含numGlyphs 个元素。间距的计算方式由layoutFlags 控制。

另请参阅 QTextLine::horizontalAdvance()、QFontMetricsF::horizontalAdvance() 和QTextLayout::glyphRuns()。

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

返回QRawFont 中每个glyphIndexes 的间距（单位为像素）。这些间距表示从给定字形的位置到下一个字形应绘制位置的距离，以确保这两个字形看起来没有间隙。每个字形的间距均单独计算。

另请参阅 QTextLine::horizontalAdvance() 和QFontMetricsF::horizontalAdvance()。

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

返回QRawFont 中每个glyphIndexes 的间距值，单位为像素。这些间距值表示从给定字形的位置到下一个字形应绘制位置的距离，以使这两个字形看起来没有间距。 字形索引通过数组glyphIndexes 提供，而结果通过advances 返回，两者都必须包含numGlyphs 个元素。每个字形的间距均单独计算

另请参阅 QTextLine::horizontalAdvance() 和QFontMetricsF::horizontalAdvance()。

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

该函数使用指定的transform ，返回底层字体中位于给定glyphIndex 处的字形栅格化图像。如果QRawFont 无效，该函数将返回一个无效的QImage 。

如果该字体是彩色字体，则生成的图像将包含以当前像素大小渲染的字形。在这种情况下，antialiasingType 将被忽略。

否则，如果antialiasingType 设置为QRawFont::SubPixelAntialiasing ，则生成的图像将采用QImage::Format_RGB32 格式，且每个像素的 RGB 值将代表字形光栅化过程中该像素的亚像素不透明度。否则，图像将采用QImage::Format_Indexed8 格式，且每个像素将包含光栅化过程中该像素的不透明度。

另请参阅 pathForGlyph() 和QPainter::drawGlyphRun()。

qreal QRawFont::ascent() const

返回该QRawFont 的升高值（以像素为单位）。

字体的升高是指从基线到字符延伸到的最高位置之间的距离。实际上，有些字体设计师会打破这一规则，例如在字符上方添加多个重音符号，或者为了适应某种特殊语言中的非常规字符，因此该值可能（尽管很少见）会过小。

另请参阅 QFontMetricsF::ascent()。

qreal QRawFont::averageCharWidth() const

返回该QRawFont 的平均字符宽度（单位为像素）。

另请参阅 QFontMetricsF::averageCharWidth()。

QRectF QRawFont::boundingRect(quint32 glyphIndex) const

返回包含具有给定glyphIndex 的字形的最小的矩形。

qreal QRawFont::capHeight() const

返回此QRawFont 的字母高度，单位为像素。

字体的“大写字母高度”是指大写字母高于基线的高度。具体而言，它指的是平顶大写字母（如 H 或 I）的高度，而非圆顶字母（如 O）或尖顶字母（如 A）的高度——后两者在显示时可能会出现超出基线的情况。

另请参阅 QFontMetricsF::capHeight()。

qreal QRawFont::descent() const

返回该QRawFont 的下伸高度（单位为像素）。

下伸高度是指从基线到字符延伸到的最低点的距离。实际上，有些字体设计师会打破这一规则，例如为了适应某种罕见语言中的特殊字符，因此该值可能（尽管很少见）过小。

另请参阅 QFontMetricsF::descent()。

QString QRawFont::familyName() const

返回此QRawFont 的家族名称。

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

从底层物理字体中检索由tag 指定的sfnt表；若未找到该表，则返回一个空字节数组。返回的字体表的字节序为大端序，这与sfnt格式的规定一致。

该函数于 Qt 6.7 中引入。

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

名称必须是一个由四个字符组成的字符串。

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

根据font 查询获取字体的物理表示形式。返回的物理字体是Qt在所选writingSystem 中显示文本时优先使用的字体。

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

返回该QRawFont 中的字形数量。

该函数于 Qt 6.11 中引入。

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

使用底层字体中的 CMAP 表，将一串 Unicode 点转换为字形索引。 该函数的工作原理与glyphIndexesForString()类似，不同之处在于它接受一个数组（chars ），结果将通过glyphIndexes 数组返回，且字形数量将设置在numGlyphs 中。glyphIndexes 数组的大小必须至少为numChars ，如果仍不足，该函数将返回false，此时您可以根据numGlyphs 中返回的大小调整glyphIndexes 的大小。

另请参阅 glyphIndexesForString(),advancesForGlyphIndexes(),QGlyphRun,QTextLayout::glyphRuns() 以及QTextFragment::glyphRuns()。

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

使用底层字体中的 CMAP 表，将text 返回的 Unicode 点字符串转换为字形索引，并返回一个包含结果的列表。

请注意，如果字体中存在其他会影响文本造型的表格，则返回的字形索引将无法正确反映文本的渲染效果。 要获得形状正确的文本，您可以使用QTextLayout 来布局和调整文本形状，然后调用 QTextLayout::glyphs() 来获取字形索引列表和QRawFont 对的集合。

另请参阅 advancesForGlyphIndexes()、glyphIndexesForChars()、QGlyphRun 、QTextLayout::glyphRuns() 以及QTextFragment::glyphRuns()。

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

返回给定glyphIndex 的名称。

如果该字形在字体中没有显式名称，则会根据其字形索引合成一个名称。

该函数于 Qt 6.11 中引入。

QFont::HintingPreference QRawFont::hintingPreference() const

返回用于构建此QRawFont 的提示偏好设置。

另请参阅 QFont::hintingPreference()。

bool QRawFont::isValid() const

如果QRawFont 有效，则返回true ；否则返回false。

qreal QRawFont::leading() const

返回此QRawFont 的行首间距，单位为像素。

这是自然的行间距。

另请参阅 QFontMetricsF::leading()。

qreal QRawFont::lineThickness() const

返回使用此字体绘制文本时，其附属线条（下划线、上划线等）的粗细。

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

将当前的QRawFont 替换为fontData 中包含的字体，字号（以像素为单位）由pixelSize 指定，并使用由hintingPreference 指定的提示偏好设置。

fontData 必须包含 TrueType 或 OpenType 字体。

另请参阅 loadFromFile()。

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

将当前的QRawFont 替换为fileName 所引用的文件内容，尺寸（以像素为单位）由pixelSize 指定，并使用hintingPreference 指定的提示首选项。

该文件必须指向一种 TrueType 或 OpenType 字体。

另请参阅 loadFromData()。

qreal QRawFont::maxCharWidth() const

返回字体中宽度最大的字符的宽度。

另请参阅 QFontMetricsF::maxWidth()。

QPainterPath QRawFont::pathForGlyph(quint32 glyphIndex) const

如果QRawFont 有效，则该函数返回底层字体中给定glyphIndex 处字形的形状；否则，它将返回一个空的QPainterPath 。

返回的字形始终未经过提示处理。

另请参阅 alphaMapForGlyph() 和QPainterPath::addText()。

qreal QRawFont::pixelSize() const

返回为该QRawFont 设置的像素大小。像素大小会影响字形如何被栅格化，以及pathForGlyph()返回的字形大小，并用于将内部度量单位从设计单位转换为逻辑像素单位。

另请参阅 setPixelSize()。

void QRawFont::setPixelSize(qreal pixelSize)

将此字体的渲染像素大小设置为pixelSize 。

另请参阅 pixelSize()。

QFont::Style QRawFont::style() const

返回此QRawFont 的样式。

另请参阅 QFont::style()。

QString QRawFont::styleName() const

返回此QRawFont 的样式名称。

另请参阅 QFont::styleName()。

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

根据字体文件中设计者提供的信息，返回该字体支持的书写系统列表。请注意，这并不保证字体支持某个特定的Unicode点。您可以使用supportsCharacter() 来检查对单个特定字符的支持情况。

另请参阅 supportsCharacter()。

bool QRawFont::supportsCharacter(QChar character) const

如果该字体中存在与给定的character 相对应的字形，则返回true 。

另请参阅 supportedWritingSystems()。

bool QRawFont::supportsCharacter(uint ucs4) const

如果该字体包含与 UCS-4 编码字符ucs4 对应的字形，则返回true 。

另请参阅 supportedWritingSystems()。

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

将此原始字体替换为other 。此操作速度极快，且绝不会失败。

qreal QRawFont::underlinePosition() const

返回以该字体渲染的文本下方绘制下划线时，相对于基线的起始位置。

qreal QRawFont::unitsPerEm() const

返回定义此QRawFont 中 em 方块宽度和高度的设计单位数量。在将设计度量单位转换为像素单位时，该值将与像素大小结合使用，因为内部度量单位以设计单位指定，而像素大小则表示 1 em 在像素中的尺寸。

另请参阅 pixelSize() 和setPixelSize()。

int QRawFont::weight() const

返回此QRawFont 的权重。

另请参阅 QFont::weight()。

qreal QRawFont::xHeight() const

返回此QRawFont 的xHeight，单位为像素。

这通常（但并非总是）与字符“x”的高度相同。

另请参阅 QFontMetricsF::xHeight()。

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

如果该QRawFont 不等于other ，则返回true 。否则，返回false 。

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

将other 分配给此QRawFont 。

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

如果该QRawFont 等于other ，则返回true 。否则，返回false 。