QRawFont Class Reference

The QRawFont class provides access to a single physical instance of a font. More...

#include <qrawfont.h>

Public Types
enum	AntialiasingType { PixelAntialiasing, SubPixelAntialiasing }
	This enum represents the different ways a glyph can be rasterized in the function alphaMapForGlyph(). More...

Public Functions
QVector< QPointF >	advancesForGlyphIndexes (const QVector< quint32 > &glyphIndexes) const
	Returns the QRawFont's advances for each of the glyphIndexes in pixel units. More...
bool	advancesForGlyphIndexes (const quint32 *glyphIndexes, QPointF *advances, int numGlyphs) const
	Returns the QRawFont's advances for each of the glyphIndexes in pixel units. More...
QImage	alphaMapForGlyph (quint32 glyphIndex, AntialiasingType antialiasingType=SubPixelAntialiasing, const QTransform &transform=QTransform()) const
	This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified. More...
qreal	ascent () const
	Returns the ascent of this QRawFont in pixel units. More...
qreal	averageCharWidth () const
	Returns the average character width of this QRawFont in pixel units. More...
qreal	descent () const
	Returns the descent of this QRawFont in pixel units. More...
QString	familyName () const
	Returns the family name of this QRawFont. More...
QByteArray	fontTable (const char *tagName) const
	Retrieves the sfnt table named tagName from the underlying physical font, or an empty byte array if no such table was found. More...
bool	glyphIndexesForChars (const QChar *chars, int numChars, quint32 *glyphIndexes, int *numGlyphs) const
	Converts a string of unicode points to glyph indexes using the CMAP table in the underlying font. More...
QVector< quint32 >	glyphIndexesForString (const QString &text) const
	Converts the string of unicode points given by text to glyph indexes using the CMAP table in the underlying font, and returns a vector containing the result. More...
QFont::HintingPreference	hintingPreference () const
	Returns the hinting preference used to construct this QRawFont. More...
bool	isValid () const
	Returns true if the QRawFont is valid and false otherwise. More...
qreal	leading () const
	Returns the leading of this QRawFont in pixel units. More...
void	loadFromData (const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference)
	Replaces the current QRawFont with the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference. More...
void	loadFromFile (const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference)
	Replaces the current QRawFont with the contents of the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference. More...
qreal	maxCharWidth () const
	Returns the width of the widest character in the font. More...
bool	operator!= (const QRawFont &other) const
	Returns true if this QRawFont is not equal to other. More...
QRawFont &	operator= (const QRawFont &other)
	Assigns other to this QRawFont. More...
bool	operator== (const QRawFont &other) const
	Returns true if this QRawFont is equal to other. More...
QPainterPath	pathForGlyph (quint32 glyphIndex) const
	This function returns the shape of the glyph at a given glyphIndex in the underlying font if the QRawFont is valid. More...
qreal	pixelSize () const
	Returns the pixel size set for this QRawFont. More...
	QRawFont ()
	Constructs an invalid QRawFont. More...
	QRawFont (const QString &fileName, qreal pixelSize, QFont::HintingPreference hintingPreference=QFont::PreferDefaultHinting)
	Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference. More...
	QRawFont (const QByteArray &fontData, qreal pixelSize, QFont::HintingPreference hintingPreference=QFont::PreferDefaultHinting)
	Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference. More...
	QRawFont (const QRawFont &other)
	Creates a QRawFont which is a copy of other. More...
void	setPixelSize (qreal pixelSize)
	Sets the pixel size with which this font should be rendered to pixelSize. More...
QFont::Style	style () const
	Returns the style of this QRawFont. More...
QString	styleName () const
	Returns the style name of this QRawFont. More...
QList< QFontDatabase::WritingSystem >	supportedWritingSystems () const
	Returns a list of writing systems supported by the font according to designer supplied information in the font file. More...
bool	supportsCharacter (quint32 ucs4) const
	Returns true if the font has a glyph that corresponds to the UCS-4 encoded character ucs4. More...
bool	supportsCharacter (QChar character) const
	Returns true if the font has a glyph that corresponds to the given character. More...
qreal	unitsPerEm () const
	Returns the number of design units define the width and height of the em square for this QRawFont. More...
int	weight () const
	Returns the weight of this QRawFont. More...
qreal	xHeight () const
	Returns the xHeight of this QRawFont in pixel units. More...
	~QRawFont ()
	Destroys the QRawFont. More...

Static Public Functions
static QRawFont	fromFont (const QFont &font, QFontDatabase::WritingSystem writingSystem=QFontDatabase::Any)
	Fetches the physical representation based on a font query. More...

Properties
QExplicitlySharedDataPointer< QRawFontPrivate >	d

Friends
class	QRawFontPrivate

Detailed Description

The QRawFont class provides access to a single physical instance of a font.

Since

4.8

Note

QRawFont is a low level class. For most purposes QFont is a more appropriate class.

Most commonly, when presenting text in a user interface, the exact fonts used to render the characters is to some extent unknown. This can be the case for several reasons: For instance, the actual, physical fonts present on the target system could be unexpected to the developers, or the text could contain user selected styles, sizes or writing systems that are not supported by font chosen in the code.

Therefore, Qt's QFont class really represents a query for fonts. When text is interpreted, Qt will do its best to match the text to the query, but depending on the support, different fonts can be used behind the scenes.

For most use cases, this is both expected and necessary, as it minimizes the possibility of text in the user interface being undisplayable. In some cases, however, more direct control over the process might be useful. It is for these use cases the QRawFont class exists.

A QRawFont object represents a single, physical instance of a given font in a given pixel size. I.e. in the typical case it represents a set of TrueType or OpenType font tables and uses a user specified pixel size to convert metrics into logical pixel units. It can be used in combination with the QGlyphRun class to draw specific glyph indexes at specific positions, and also have accessors to some relevant data in the physical font.

QRawFont only provides support for the main font technologies: GDI and DirectWrite on Windows platforms, FreeType on Symbian and Linux platforms and CoreText on Mac OS X. For other font back-ends, the APIs will be disabled.

QRawFont can be constructed in a number of ways:

• It can be constructed by calling QTextLayout::glyphs() or QTextFragment::glyphs(). The returned QGlyphs objects will contain QRawFont objects which represent the actual fonts used to render each portion of the text.
• It can be constructed by passing a QFont object to QRawFont::fromFont(). The function will return a QRawFont object representing the font that will be selected as response to the QFont query and the selected writing system.
• It can be constructed by passing a file name or QByteArray directly to the QRawFont constructor, or by calling loadFromFile() or loadFromData(). In this case, the font will not be registered in QFontDatabase, and it will not be available as part of regular font selection.

QRawFont is considered local to the thread in which it is constructed (either using a constructor, or by calling loadFromData() or loadFromFile()). The QRawFont cannot be moved to a different thread, but will have to be recreated in the thread in question.

Note

For the requirement of caching glyph indexes and font selections for static text to avoid reshaping and relayouting in the inner loop of an application, a better choice is the QStaticText class, since it optimizes the memory cost of the cache and also provides the possibility of paint engine specific caches for an additional speed-up.

Definition at line 63 of file qrawfont.h.

Enumerations

AntialiasingType

enum QRawFont::AntialiasingType

This enum represents the different ways a glyph can be rasterized in the function alphaMapForGlyph().

• PixelAntialiasing Will rasterize by measuring the coverage of the shape on whole pixels. The returned image contains the alpha values of each pixel based on the coverage of the glyph shape.
• SubPixelAntialiasing Will rasterize by measuring the coverage of each subpixel, returning a separate alpha value for each of the red, green and blue components of each pixel.

Enumerator
PixelAntialiasing
SubPixelAntialiasing

Definition at line 66 of file qrawfont.h.

                          {
        PixelAntialiasing,
        SubPixelAntialiasing
    };

Constructors and Destructors

QRawFont() [1/4]

QRawFont::QRawFont

(

)

Constructs an invalid QRawFont.

Definition at line 134 of file qrawfont.cpp.

    : d(new QRawFontPrivate)
{
}

QRawFont() [2/4]

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

Constructs a QRawFont representing the font contained in the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.

Note

The referenced file must contain a TrueType or OpenType font.

Definition at line 146 of file qrawfont.cpp.

    : d(new QRawFontPrivate)
{
    loadFromFile(fileName, pixelSize, hintingPreference);
}

QRawFont() [3/4]

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

Constructs a QRawFont representing the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.

Note

The data must contain a TrueType or OpenType font.

Definition at line 161 of file qrawfont.cpp.

    : d(new QRawFontPrivate)
{
    loadFromData(fontData, pixelSize, hintingPreference);
}

QRawFont() [4/4]

QRawFont::QRawFont

(

const QRawFont &

other

)

Creates a QRawFont which is a copy of other.

Definition at line 172 of file qrawfont.cpp.

{
    d = other.d;
}

~QRawFont()

QRawFont::~QRawFont

(

)

Destroys the QRawFont.

Definition at line 180 of file qrawfont.cpp.

{
}

Functions

advancesForGlyphIndexes() [1/2]

QVector< QPointF > QRawFont::advancesForGlyphIndexes

(

const QVector< quint32 > &

glyphIndexes

)

const

Returns the QRawFont's advances for each of the glyphIndexes in pixel units.

The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced.

See also

QTextLine::horizontalAdvance(), QFontMetricsF::width()

Definition at line 486 of file qrawfont.cpp.

{
    if (!d->isValid())
        return QVector<QPointF>();

    int numGlyphs = glyphIndexes.size();
    QVarLengthGlyphLayoutArray glyphs(numGlyphs);
    qMemCopy(glyphs.glyphs, glyphIndexes.data(), numGlyphs * sizeof(quint32));

    d->fontEngine->recalcAdvances(&glyphs, 0);

    QVector<QPointF> advances;
    for (int i=0; i<numGlyphs; ++i)
        advances.append(QPointF(glyphs.advances_x[i].toReal(), glyphs.advances_y[i].toReal()));

    return advances;
}

advancesForGlyphIndexes() [2/2]

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

Returns the QRawFont's advances for each of the glyphIndexes in pixel units.

The advances give the distance from the position of a given glyph to where the next glyph should be drawn to make it appear as if the two glyphs are unspaced. The glyph indexes are given with the array glyphIndexes while the results are returned through advances, both of them must have numGlyphs elements.

See also

QTextLine::horizontalAdvance(), QFontMetricsF::width()

Definition at line 513 of file qrawfont.cpp.

{
    if (!d->isValid())
        return false;

    QGlyphLayout glyphs;
    glyphs.glyphs = const_cast<HB_Glyph *>(glyphIndexes);
    glyphs.numGlyphs = numGlyphs;
    QVarLengthArray<QFixed> advances_x(numGlyphs);
    QVarLengthArray<QFixed> advances_y(numGlyphs);
    glyphs.advances_x = advances_x.data();
    glyphs.advances_y = advances_y.data();

    d->fontEngine->recalcAdvances(&glyphs, 0);

    for (int i=0; i<numGlyphs; ++i)
        advances[i] = QPointF(glyphs.advances_x[i].toReal(), glyphs.advances_y[i].toReal());

    return true;
}

alphaMapForGlyph()

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

This function returns a rasterized image of the glyph at the given glyphIndex in the underlying font, using the transform specified.

If the QRawFont is not valid, this function will return an invalid QImage.

If antialiasingType is set to QRawFont::SubPixelAntialiasing, then the resulting image will be in QImage::Format_RGB32 and the RGB values of each pixel will represent the subpixel opacities of the pixel in the rasterization of the glyph. Otherwise, the image will be in the format of QImage::Format_Indexed8 and each pixel will contain the opacity of the pixel in the rasterization.

See also

pathForGlyph(), QPainter::drawGlyphRun()

Definition at line 252 of file qrawfont.cpp.

{
    if (!d->isValid())
        return QImage();

    if (antialiasingType == SubPixelAntialiasing)
        return d->fontEngine->alphaRGBMapForGlyph(glyphIndex, QFixed(), 0, transform);

    return d->fontEngine->alphaMapForGlyph(glyphIndex, QFixed(), transform);
}

ascent()

qreal QRawFont::ascent

(

)

const

Returns the ascent of this QRawFont in pixel units.

See also

QFontMetricsF::ascent()

Definition at line 305 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->ascent().toReal() : 0.0;
}

averageCharWidth()

qreal QRawFont::averageCharWidth

(

)

const

Returns the average character width of this QRawFont in pixel units.

See also

QFontMetricsF::averageCharWidth()

Definition at line 345 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->averageCharWidth().toReal() : 0.0;
}

descent()

qreal QRawFont::descent

(

)

const

Returns the descent of this QRawFont in pixel units.

See also

QFontMetricsF::descent()

Definition at line 315 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->descent().toReal() : 0.0;
}

familyName()

QString QRawFont::familyName

(

)

const

Returns the family name of this QRawFont.

Definition at line 388 of file qrawfont.cpp.

Referenced by fromFont().

{
    return d->isValid() ? d->fontEngine->fontDef.family : QString();
}

fontTable()

QByteArray QRawFont::fontTable

(

const char *

tagName

)

const

Retrieves the sfnt table named tagName from the underlying physical font, or an empty byte array if no such table was found.

The returned font table's byte order is Big Endian, like the sfnt format specifies. The tagName must be four characters long and should be formatted in the default endianness of the current platform.

Definition at line 550 of file qrawfont.cpp.

Referenced by supportedWritingSystems().

{
    if (!d->isValid())
        return QByteArray();

    const quint32 *tagId = reinterpret_cast<const quint32 *>(tagName);
    return d->fontEngine->getSfntTable(qToBigEndian(*tagId));
}

fromFont()

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

static

Fetches the physical representation based on a font query.

The physical font returned is the font that will be preferred by Qt in order to display text in the selected writingSystem.

Definition at line 640 of file qrawfont.cpp.

{
    QRawFont rawFont;
#if defined(Q_WS_MAC)
    QTextLayout layout(QFontDatabase::writingSystemSample(writingSystem), font);
    layout.beginLayout();
    QTextLine line = layout.createLine();
    layout.endLayout();
    QList<QGlyphRun> list = layout.glyphRuns();
    if (list.size()) {
        // Pick the one matches the family name we originally requested,
        // if none of them match, just pick the first one
        for (int i = 0; i < list.size(); i++) {
            rawFont = list.at(i).rawFont();
            if (rawFont.familyName() == font.family())
                return rawFont;
        }
        return list.at(0).rawFont();
    }
#else
    QFontPrivate *font_d = QFontPrivate::get(font);
    int script = qt_script_for_writing_system(writingSystem);
    QFontEngine *fe = font_d->engineForScript(script);

    if (fe != 0 && fe->type() == QFontEngine::Multi) {
        QFontEngineMulti *multiEngine = static_cast<QFontEngineMulti *>(fe);
        fe = multiEngine->engine(0);
        if (fe == 0) {
            multiEngine->loadEngine(0);
            fe = multiEngine->engine(0);
        }
    }

    if (fe != 0) {
        rawFont.d.data()->fontEngine = fe;
        rawFont.d.data()->fontEngine->ref.ref();
        rawFont.d.data()->hintingPreference = font.hintingPreference();
    }
#endif
    return rawFont;
}

glyphIndexesForChars()

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

Converts a string of unicode points to glyph indexes using the CMAP table in the underlying font.

The function works like glyphIndexesForString() except it take an array (chars), the results will be returned though glyphIndexes array and number of glyphs will be set in numGlyphs. The size of glyphIndexes array must be at least numChars, if that's still not enough, this function will return false, then you can resize glyphIndexes from the size returned in numGlyphs.

See also

glyphIndexesForString(), advancesForGlyphIndexes(), QGlyphRun, QTextLayout::glyphRuns(), QTextFragment::glyphRuns()

Definition at line 469 of file qrawfont.cpp.

Referenced by glyphIndexesForString().

{
    if (!d->isValid())
        return false;

    QGlyphLayout glyphs;
    glyphs.glyphs = glyphIndexes;
    return d->fontEngine->stringToCMap(chars, numChars, &glyphs, numGlyphs, QTextEngine::GlyphIndicesOnly);
}

glyphIndexesForString()

QVector< quint32 > QRawFont::glyphIndexesForString

(

const QString &

text

)

const

Converts the string of unicode points given by text to glyph indexes using the CMAP table in the underlying font, and returns a vector containing the result.

Note that, in cases where there are other tables in the font that affect the shaping of the text, the returned glyph indexes will not correctly represent the rendering of the text. To get the correctly shaped text, you can use QTextLayout to lay out and shape the text, then call QTextLayout::glyphs() to get the set of glyph index list and QRawFont pairs.

See also

advancesForGlyphIndexes(), glyphIndexesForChars(), QGlyphRun, QTextLayout::glyphRuns(), QTextFragment::glyphRuns()

Definition at line 436 of file qrawfont.cpp.

{
    if (!d->isValid())
        return QVector<quint32>();

    int nglyphs = text.size();
    QVarLengthGlyphLayoutArray glyphs(nglyphs);
    if (!glyphIndexesForChars(text.data(), text.size(), glyphs.glyphs, &nglyphs)) {
        glyphs.resize(nglyphs);
        if (!glyphIndexesForChars(text.data(), text.size(), glyphs.glyphs, &nglyphs)) {
            Q_ASSERT_X(false, Q_FUNC_INFO, "stringToCMap shouldn't fail twice");
            return QVector<quint32>();
        }
    }

    QVector<quint32> glyphIndexes;
    for (int i=0; i<nglyphs; ++i)
        glyphIndexes.append(glyphs.glyphs[i]);

    return glyphIndexes;
}

hintingPreference()

QFont::HintingPreference QRawFont::hintingPreference

(

)

const

Returns the hinting preference used to construct this QRawFont.

See also

QFont::hintingPreference()

Definition at line 539 of file qrawfont.cpp.

Referenced by QRawFontPrivate::cleanUp(), loadFromData(), and loadFromFile().

{
    return d->isValid() ? d->hintingPreference : QFont::PreferDefaultHinting;
}

isValid()

bool QRawFont::isValid

(

)

const

Returns true if the QRawFont is valid and false otherwise.

Definition at line 196 of file qrawfont.cpp.

Referenced by QPainter::drawGlyphRun().

{
    return d->isValid();
}

leading()

qreal QRawFont::leading

(

)

const

Returns the leading of this QRawFont in pixel units.

See also

QFontMetricsF::leading()

Definition at line 335 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->leading().toReal() : 0.0;
}

loadFromData()

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

Replaces the current QRawFont with the font contained in the supplied fontData for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.

The fontData must contain a TrueType or OpenType font.

See also

loadFromFile()

Definition at line 228 of file qrawfont.cpp.

Referenced by loadFromFile(), and QRawFont().

{
    d.detach();
    d->cleanUp();
    d->hintingPreference = hintingPreference;
    d->thread = QThread::currentThread();
    d->platformLoadFromData(fontData, pixelSize, hintingPreference);
}

loadFromFile()

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

Replaces the current QRawFont with the contents of the file referenced by fileName for the size (in pixels) given by pixelSize, and using the hinting preference specified by hintingPreference.

The file must reference a TrueType or OpenType font.

See also

loadFromData()

Definition at line 210 of file qrawfont.cpp.

Referenced by QRawFont().

{
    QFile file(fileName);
    if (file.open(QIODevice::ReadOnly))
        loadFromData(file.readAll(), pixelSize, hintingPreference);
}

maxCharWidth()

qreal QRawFont::maxCharWidth

(

)

const

Returns the width of the widest character in the font.

See also

QFontMetricsF::maxWidth()

Definition at line 355 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->maxCharWidth() : 0.0;
}

operator!=()

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

inline

Returns true if this QRawFont is not equal to other.

Otherwise, returns false.

Definition at line 86 of file qrawfont.h.

    { return !operator==(other); }

operator=()

QRawFont & QRawFont::operator=

(

const QRawFont &

other

)

Assigns other to this QRawFont.

Definition at line 187 of file qrawfont.cpp.

{
    d = other.d;
    return *this;
}

operator==()

bool QRawFont::operator==

(

const QRawFont &

other

)

const

Returns true if this QRawFont is equal to other.

Otherwise, returns false.

Definition at line 286 of file qrawfont.cpp.

{
    return d->fontEngine == other.d->fontEngine;
}

pathForGlyph()

QPainterPath QRawFont::pathForGlyph

(

quint32

glyphIndex

)

const

This function returns the shape of the glyph at a given glyphIndex in the underlying font if the QRawFont is valid.

Otherwise, it returns an empty QPainterPath.

The returned glyph will always be unhinted.

See also

alphaMapForGlyph(), QPainterPath::addText()

Definition at line 272 of file qrawfont.cpp.

{
    if (!d->isValid())
        return QPainterPath();

    QFixedPoint position;
    QPainterPath path;
    d->fontEngine->addGlyphsToPath(&glyphIndex, &position, 1, &path, 0);
    return path;
}

pixelSize()

qreal QRawFont::pixelSize

(

)

const

Returns the pixel size set for this QRawFont.

The pixel size affects how glyphs are rasterized, the size of glyphs returned by pathForGlyph(), and is used to convert internal metrics from design units to logical pixel units.

See also

setPixelSize()

Definition at line 367 of file qrawfont.cpp.

Referenced by loadFromFile().

{
    return d->isValid() ? d->fontEngine->fontDef.pixelSize : 0.0;
}

setPixelSize()

void QRawFont::setPixelSize

(

qreal

pixelSize

)

Sets the pixel size with which this font should be rendered to pixelSize.

Definition at line 685 of file qrawfont.cpp.

{
    if (d->fontEngine == 0)
        return;

    d.detach();
    QFontEngine *oldFontEngine = d->fontEngine;

    d->fontEngine = d->fontEngine->cloneWithSize(pixelSize);
    if (d->fontEngine != 0)
        d->fontEngine->ref.ref();

    oldFontEngine->ref.deref();
    if (oldFontEngine->cache_count == 0 && oldFontEngine->ref == 0)
        delete oldFontEngine;
}

style()

QFont::Style QRawFont::style

(

)

const

Returns the style of this QRawFont.

See also

QFont::style()

Definition at line 408 of file qrawfont.cpp.

{
    return d->isValid() ? QFont::Style(d->fontEngine->fontDef.style) : QFont::StyleNormal;
}

styleName()

QString QRawFont::styleName

(

)

const

Returns the style name of this QRawFont.

See also

QFont::styleName()

Definition at line 398 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->fontDef.styleName : QString();
}

supportedWritingSystems()

QList< QFontDatabase::WritingSystem > QRawFont::supportedWritingSystems

(

)

const

Returns a list of writing systems supported by the font according to designer supplied information in the font file.

Please note that this does not guarantee support for a specific unicode point in the font. You can use the supportsCharacter() to check support for a single, specific character.

Note

The list is determined based on the unicode ranges and codepage ranges set in the font's OS/2 table and requires such a table to be present in the underlying font file.

See also

supportsCharacter()

Definition at line 573 of file qrawfont.cpp.

{
    if (d->isValid()) {
        QByteArray os2Table = fontTable("OS/2");
        if (os2Table.size() > 86) {
            char *data = os2Table.data();
            quint32 *bigEndianUnicodeRanges = reinterpret_cast<quint32 *>(data + 42);
            quint32 *bigEndianCodepageRanges = reinterpret_cast<quint32 *>(data + 78);

            quint32 unicodeRanges[4];
            quint32 codepageRanges[2];

            for (int i=0; i<4; ++i) {
                if (i < 2)
                    codepageRanges[i] = qFromBigEndian(bigEndianCodepageRanges[i]);
                unicodeRanges[i] = qFromBigEndian(bigEndianUnicodeRanges[i]);
            }

            return qt_determine_writing_systems_from_truetype_bits(unicodeRanges, codepageRanges);
        }
    }

    return QList<QFontDatabase::WritingSystem>();
}

supportsCharacter() [1/2]

bool QRawFont::supportsCharacter

(

quint32

ucs4

)

const

Returns true if the font has a glyph that corresponds to the UCS-4 encoded character ucs4.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

See also

supportedWritingSystems()

Definition at line 617 of file qrawfont.cpp.

{
    QChar str[2];
    int len;
    if (!QChar::requiresSurrogates(ucs4)) {
        str[0] = QChar(ucs4);
        len = 1;
    } else {
        str[0] = QChar(QChar::highSurrogate(ucs4));
        str[1] = QChar(QChar::lowSurrogate(ucs4));
        len = 2;
    }

    return d->isValid() && d->fontEngine->canRender(str, len);
}

supportsCharacter() [2/2]

bool QRawFont::supportsCharacter

(

QChar

character

)

const

Returns true if the font has a glyph that corresponds to the given character.

See also

supportedWritingSystems()

Definition at line 603 of file qrawfont.cpp.

{
    return d->isValid() && d->fontEngine->canRender(&character, 1);
}

unitsPerEm()

qreal QRawFont::unitsPerEm

(

)

const

Returns the number of design units define the width and height of the em square for this QRawFont.

This value is used together with the pixel size when converting design metrics to pixel units, as the internal metrics are specified in design units and the pixel size gives the size of 1 em in pixels.

See also

pixelSize(), setPixelSize()

Definition at line 380 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->emSquareSize().toReal() : 0.0;
}

weight()

int QRawFont::weight

(

)

const

Returns the weight of this QRawFont.

See also

QFont::weight()

Definition at line 418 of file qrawfont.cpp.

{
    return d->isValid() ? int(d->fontEngine->fontDef.weight) : -1;
}

xHeight()

qreal QRawFont::xHeight

(

)

const

Returns the xHeight of this QRawFont in pixel units.

See also

QFontMetricsF::xHeight()

Definition at line 325 of file qrawfont.cpp.

{
    return d->isValid() ? d->fontEngine->xHeight().toReal() : 0.0;
}

Friends and Related Functions

QRawFontPrivate

friend class QRawFontPrivate

friend

Definition at line 137 of file qrawfont.h.

Properties

d

QExplicitlySharedDataPointer<QRawFontPrivate> QRawFont::d

private

Definition at line 138 of file qrawfont.h.

Referenced by advancesForGlyphIndexes(), alphaMapForGlyph(), ascent(), averageCharWidth(), descent(), familyName(), fontTable(), fromFont(), glyphIndexesForChars(), glyphIndexesForString(), hintingPreference(), isValid(), leading(), loadFromData(), maxCharWidth(), operator=(), operator==(), pathForGlyph(), pixelSize(), QRawFont(), setPixelSize(), style(), styleName(), supportedWritingSystems(), supportsCharacter(), unitsPerEm(), weight(), and xHeight().

---

The documentation for this class was generated from the following files:

• /src/gui/text/qrawfont.h
• /src/gui/text/qrawfont.cpp