QRawFont Class

成员函数文档

QRawFont::QRawFont()

构造无效的 QRawFont。

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

根据pixelSize 给出的尺寸（像素），并使用hintingPreference 指定的提示首选项，构造一个 QRawFont，代表所提供的fontData 中包含的字体。

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 表，如果没有找到该表，则读取空字节数组。返回的字体表的字节序为大端（Big Endian），与 sfnt 格式指定的一样。

此函数在 Qt 6.7 中引入。

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

此函数重载fontTable(QFont::Tag)。

名称必须是四个字符的字符串。

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

根据font 查询获取物理表示。返回的物理字体是 Qt 为显示所选writingSystem 中的文本而首选的字体。

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() 。

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)

使用所提供的fontData 中包含的字体替换当前的QRawFont ，字体大小（像素）由pixelSize 给定，并使用由hintingPreference 指定的提示首选项。

fontData 必须包含 TrueType 或 OpenType 字体。

另请参阅 loadFromFile() 。

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

使用fileName 引用的文件内容替换当前的QRawFont ，文件大小（像素）由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 。