QRawFont Class

メンバ関数のドキュメント

QRawFont::QRawFont()

無効な QRawFont を生成します。

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

指定されたfontData に含まれるフォントを、pixelSize で指定されたサイズ（ピクセル単位）で、hintingPreference で指定されたヒンティング設定を使用して、QRawFontとして生成します。

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

fileName で参照されるファイルに含まれるフォントを、pixelSize で指定されたサイズ（ピクセル単位）で、hintingPreference で指定されたヒンティング設定を使用して、QRawFont オブジェクトとして生成します。

QRawFont::QRawFont(const QRawFont &other)

other のコピーであるQRawFontを作成します。

[noexcept] QRawFont::~QRawFont()

を破壊するQRawFont

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

各glyphIndexes に対するQRawFont のアドバンスをピクセル単位で返します。アドバンスとは、2つのグリフにスペースがないかのように見せるために、指定されたグリフの位置から次のグリフが描画されるべき位置までの距離を指します。アドバンスの計算方法は、layoutFlags によって制御されます。

QTextLine::horizontalAdvance()、QFontMetricsF::horizontalAdvance()、およびQTextLayout::glyphRuns()も参照してください 。

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

各glyphIndexes に対するQRawFont のアドバンスをピクセル単位で返します。このアドバンスは、指定されたグリフの位置から、2つのグリフの間にスペースがないように見えるように次のグリフを描画すべき位置までの距離を表します。 グリフインデックスは配列 `glyphIndexes ` で指定され、結果は `advances` を通じて返されます。これらはいずれもnumGlyphs 個の要素を持つ必要があります。アドバンスの計算方法は、layoutFlags によって制御されます。

QTextLine::horizontalAdvance()、QFontMetricsF::horizontalAdvance()、およびQTextLayout::glyphRuns()も参照してください 。

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

各glyphIndexes に対するQRawFont のアドバンスをピクセル単位で返します。アドバンスとは、2つのグリフの間にスペースがないかのように見せるために、指定されたグリフの位置から次のグリフを描画すべき位置までの距離を指します。各グリフのアドバンスは個別に計算されます。

QTextLine::horizontalAdvance() およびQFontMetricsF::horizontalAdvance()も参照してください 。

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

各glyphIndexes に対するQRawFont のアドバンスをピクセル単位で返します。このアドバンスは、2つのグリフの間にスペースがないように見せるために、指定されたグリフの位置から次のグリフが描画されるべき位置までの距離を表します。 グリフのインデックスは配列 `glyphIndexes ` で指定され、結果は `advances` を通じて返されます。両者ともnumGlyphs 個の要素を持つ必要があります。各グリフのアドバンスは個別に計算されます。

QTextLine::horizontalAdvance() およびQFontMetricsF::horizontalAdvance()も参照してください 。

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

この関数は、指定されたglyphIndex に対応する、基となるフォント内のグリフのラスタライズ済み画像を、指定されたtransform を使用して返します。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 のような先端が尖った文字とは対照的です。後者の2種類は、オーバーシュートが発生する可能性があります。

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

名前は4文字の文字列でなければなりません。

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

font クエリに基づいて、物理的な表現を取得します。返される物理フォントは、選択されたwritingSystem でテキストを表示する際に、Qtが優先して使用するフォントです。

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

このQRawFont に含まれるグリフの数を返します。

この関数は Qt 6.11 で導入されました。

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

Unicodeポイントの文字列を、基となるフォントのCMAPテーブルを使用してグリフインデックスに変換します。 この関数は、glyphIndexesForString()と同様に動作しますが、引数として配列（chars ）を受け取る点が異なります。結果はglyphIndexes 配列を通じて返され、グリフの数はnumGlyphs に設定されます。glyphIndexes 配列のサイズは、少なくともnumChars でなければなりません。それでも容量が不足している場合、この関数はfalseを返します。その場合は、numGlyphs で返されたサイズに基づいてglyphIndexes のサイズを変更してください。

関連項目： glyphIndexesForString()、advancesForGlyphIndexes()、QGlyphRun 、QTextLayout::glyphRuns()、およびQTextFragment::glyphRuns()。

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

text で指定された Unicode ポイントの文字列を、基となるフォントの CMAP テーブルを使用してグリフインデックスに変換し、その結果を含むリストを返します。

なお、フォント内にテキストのシェーピングに影響を与える他のテーブルが存在する場合、返されるグリフインデックスはテキストのレンダリングを正しく表さないことに注意してください。 正しく整形されたテキストを取得するには、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 を、pixelSize で指定されたサイズ（ピクセル単位）で、fontData に含まれるフォントに置き換え、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

フォントファイル内のデザイナーが提供した情報に基づき、そのフォントがサポートする文字体系のリストを返します。ただし、これはフォントが特定のユニコードポイントをサポートしていることを保証するものではない点にご注意ください。個々の特定の文字のサポート状況を確認するには、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` を返します。