QRawFont Class

멤버 함수 설명서

QRawFont::QRawFont()

유효하지 않은 QRawFont 객체를 생성합니다.

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

fontData pixelSize 에 지정된 폰트가 포함된 QRawFont 객체를 생성하며, 이 때 에서 지정한 크기(픽셀 단위)를 사용하고, 에서 지정한 힌팅 기본 설정을 적용합니다. hintingPreference

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

fileName 가 참조하는 파일에 포함된 글꼴을 나타내는 QRawFont 객체를, pixelSize 로 지정된 크기(픽셀 단위)로, hintingPreference 로 지정된 힌팅 기본 설정을 사용하여 생성합니다.

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 의 어드밴스(advances)를 픽셀 단위로 반환합니다. 어드밴스는 주어진 글리프의 위치에서 다음 글리프가 간격 없이 이어져 보이도록 그려져야 할 위치까지의 거리를 나타냅니다. 어드밴스의 계산 방식은 layoutFlags 에 의해 제어됩니다.

QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance(), QTextLayout::glyphRuns()도 참조하십시오 .

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

각 glyphIndexes 에 대해 QRawFont 의 이동량(advances)을 픽셀 단위로 반환합니다. 이 이동량은 주어진 글리프의 위치에서 다음 글리프가 간격 없이 표시되도록 그려져야 할 위치까지의 거리를 나타냅니다. 글리프 인덱스는 배열 ` glyphIndexes `로 제공되며, 결과는 ` advances`를 통해 반환됩니다. 두 배열 모두 ` numGlyphs `개의 요소를 가져야 합니다. 어드밴스의 계산 방식은 ` layoutFlags`에 의해 제어됩니다.

QTextLine::horizontalAdvance(), QFontMetricsF::horizontalAdvance(), QTextLayout::glyphRuns()도 참조하십시오 .

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

각 glyphIndexes 에 대한 ' QRawFont'의 간격(advances)을 픽셀 단위로 반환합니다. 이 간격은 주어진 글리프의 위치에서 다음 글리프가 마치 두 글리프 사이에 간격이 없는 것처럼 보이도록 그려져야 할 위치까지의 거리를 나타냅니다. 각 글리프의 간격은 별도로 계산됩니다.

QTextLine::horizontalAdvance() 및 QFontMetricsF::horizontalAdvance()도 참조하십시오 .

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

각 glyphIndexes 에 대해 QRawFont 의 이동량(advances)을 픽셀 단위로 반환합니다. 이 이동량은 주어진 글리프의 위치에서 다음 글리프가 간격 없이 표시되도록 그려져야 할 위치까지의 거리를 나타냅니다. 글리프 인덱스는 배열 ` 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

이름은 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

기본 폰트의 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 로 지정된 유니코드 포인트 문자열을 기본 폰트의 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 를 반환합니다.