<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qrawfont.cpp -->
<title>Qt 4.8: QRawFont Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtgui.html">QtGui</a></li>
<li>QRawFont</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QRawFont Class Reference</h1>
<!-- $$$QRawFont-brief -->
<p>The QRawFont class provides access to a single physical instance of a font. <a href="#details">More...</a></p>
<!-- @@@QRawFont -->
<pre class="cpp"> <span class="preprocessor">#include <QRawFont></span></pre><p>This class was introduced in Qt 4.8.</p>
<ul>
<li><a href="qrawfont-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#AntialiasingType-enum">AntialiasingType</a></b> { PixelAntialiasing, SubPixelAntialiasing }</td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#QRawFont">QRawFont</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#QRawFont-2">QRawFont</a></b> ( const QString & <i>fileName</i>, qreal <i>pixelSize</i>, QFont::HintingPreference <i>hintingPreference</i> = QFont::PreferDefaultHinting )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#QRawFont-3">QRawFont</a></b> ( const QByteArray & <i>fontData</i>, qreal <i>pixelSize</i>, QFont::HintingPreference <i>hintingPreference</i> = QFont::PreferDefaultHinting )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#QRawFont-4">QRawFont</a></b> ( const QRawFont & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#dtor.QRawFont">~QRawFont</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVector<QPointF> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#advancesForGlyphIndexes">advancesForGlyphIndexes</a></b> ( const QVector<quint32> & <i>glyphIndexes</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#advancesForGlyphIndexes-2">advancesForGlyphIndexes</a></b> ( const quint32 * <i>glyphIndexes</i>, QPointF * <i>advances</i>, int <i>numGlyphs</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QImage </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#alphaMapForGlyph">alphaMapForGlyph</a></b> ( quint32 <i>glyphIndex</i>, AntialiasingType <i>antialiasingType</i> = SubPixelAntialiasing, const QTransform & <i>transform</i> = QTransform() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#ascent">ascent</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#averageCharWidth">averageCharWidth</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#descent">descent</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#familyName">familyName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QByteArray </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#fontTable">fontTable</a></b> ( const char * <i>tagName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#glyphIndexesForChars">glyphIndexesForChars</a></b> ( const QChar * <i>chars</i>, int <i>numChars</i>, quint32 * <i>glyphIndexes</i>, int * <i>numGlyphs</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QVector<quint32> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#glyphIndexesForString">glyphIndexesForString</a></b> ( const QString & <i>text</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFont::HintingPreference </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#hintingPreference">hintingPreference</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#isValid">isValid</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#leading">leading</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#loadFromData">loadFromData</a></b> ( const QByteArray & <i>fontData</i>, qreal <i>pixelSize</i>, QFont::HintingPreference <i>hintingPreference</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#loadFromFile">loadFromFile</a></b> ( const QString & <i>fileName</i>, qreal <i>pixelSize</i>, QFont::HintingPreference <i>hintingPreference</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#maxCharWidth">maxCharWidth</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QPainterPath </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#pathForGlyph">pathForGlyph</a></b> ( quint32 <i>glyphIndex</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#pixelSize">pixelSize</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#setPixelSize">setPixelSize</a></b> ( qreal <i>pixelSize</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFont::Style </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#style">style</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#styleName">styleName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QFontDatabase::WritingSystem> </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#supportedWritingSystems">supportedWritingSystems</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#supportsCharacter">supportsCharacter</a></b> ( QChar <i>character</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#supportsCharacter-2">supportsCharacter</a></b> ( quint32 <i>ucs4</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#unitsPerEm">unitsPerEm</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#weight">weight</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#xHeight">xHeight</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#operator-not-eq">operator!=</a></b> ( const QRawFont & <i>other</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QRawFont & </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#operator-eq">operator=</a></b> ( const QRawFont & <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#operator-eq-eq">operator==</a></b> ( const QRawFont & <i>other</i> ) const</td></tr>
</table>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QRawFont </td><td class="memItemRight bottomAlign"><b><a href="qrawfont.html#fromFont">fromFont</a></b> ( const QFont & <i>font</i>, QFontDatabase::WritingSystem <i>writingSystem</i> = QFontDatabase::Any )</td></tr>
</table>
<a name="details"></a>
<!-- $$$QRawFont-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QRawFont class provides access to a single physical instance of a font.</p>
<p><b>Note:</b> QRawFont is a low level class. For most purposes <a href="qfont.html">QFont</a> is a more appropriate class.</p>
<p>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.</p>
<p>Therefore, Qt's <a href="qfont.html">QFont</a> 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.</p>
<p>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.</p>
<p>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 <a href="qglyphrun.html">QGlyphRun</a> class to draw specific glyph indexes at specific positions, and also have accessors to some relevant data in the physical font.</p>
<p>QRawFont only provides support for the main font technologies: GDI and DirectWrite on Windows platforms, <a href="qt-embedded-fonts.html#freetype">FreeType</a> on Symbian and Linux platforms and CoreText on Mac OS X. For other font back-ends, the APIs will be disabled.</p>
<p>QRawFont can be constructed in a number of ways:</p>
<ul>
<li>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.</li>
<li>It can be constructed by passing a <a href="qfont.html">QFont</a> object to <a href="qrawfont.html#fromFont">QRawFont::fromFont</a>(). The function will return a QRawFont object representing the font that will be selected as response to the <a href="qfont.html">QFont</a> query and the selected writing system.</li>
<li>It can be constructed by passing a file name or <a href="qbytearray.html">QByteArray</a> directly to the QRawFont constructor, or by calling <a href="qrawfont.html#loadFromFile">loadFromFile</a>() or <a href="qrawfont.html#loadFromData">loadFromData</a>(). In this case, the font will not be registered in <a href="qfontdatabase.html">QFontDatabase</a>, and it will not be available as part of regular font selection.</li>
</ul>
<p>QRawFont is considered local to the thread in which it is constructed (either using a constructor, or by calling <a href="qrawfont.html#loadFromData">loadFromData</a>() or <a href="qrawfont.html#loadFromFile">loadFromFile</a>()). The QRawFont cannot be moved to a different thread, but will have to be recreated in the thread in question.</p>
<p><b>Note:</b> 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 <a href="qstatictext.html">QStaticText</a> 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.</p>
</div>
<!-- @@@QRawFont -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$AntialiasingType$$$PixelAntialiasing$$$SubPixelAntialiasing -->
<h3 class="fn"><a name="AntialiasingType-enum"></a>enum QRawFont::<span class="name">AntialiasingType</span></h3>
<p>This enum represents the different ways a glyph can be rasterized in the function <a href="qrawfont.html#alphaMapForGlyph">alphaMapForGlyph</a>().</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QRawFont::PixelAntialiasing</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">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.</td></tr>
<tr><td class="topAlign"><tt>QRawFont::SubPixelAntialiasing</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">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.</td></tr>
</table>
<!-- @@@AntialiasingType -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QRawFont[overload1]$$$QRawFont -->
<h3 class="fn"><a name="QRawFont"></a>QRawFont::<span class="name">QRawFont</span> ()</h3>
<p>Constructs an invalid <a href="qrawfont.html">QRawFont</a>.</p>
<!-- @@@QRawFont -->
<!-- $$$QRawFont$$$QRawFontconstQString&qrealQFont::HintingPreference -->
<h3 class="fn"><a name="QRawFont-2"></a>QRawFont::<span class="name">QRawFont</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>fileName</i>, <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> <i>pixelSize</i>, <span class="type"><a href="qfont.html#HintingPreference-enum">QFont::HintingPreference</a></span> <i>hintingPreference</i> = QFont::PreferDefaultHinting )</h3>
<p>Constructs a <a href="qrawfont.html">QRawFont</a> representing the font contained in the file referenced by <i>fileName</i> for the size (in pixels) given by <i>pixelSize</i>, and using the hinting preference specified by <i>hintingPreference</i>.</p>
<p><b>Note:</b> The referenced file must contain a TrueType or OpenType font.</p>
<!-- @@@QRawFont -->
<!-- $$$QRawFont$$$QRawFontconstQByteArray&qrealQFont::HintingPreference -->
<h3 class="fn"><a name="QRawFont-3"></a>QRawFont::<span class="name">QRawFont</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>fontData</i>, <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> <i>pixelSize</i>, <span class="type"><a href="qfont.html#HintingPreference-enum">QFont::HintingPreference</a></span> <i>hintingPreference</i> = QFont::PreferDefaultHinting )</h3>
<p>Constructs a <a href="qrawfont.html">QRawFont</a> representing the font contained in the supplied <i>fontData</i> for the size (in pixels) given by <i>pixelSize</i>, and using the hinting preference specified by <i>hintingPreference</i>.</p>
<p><b>Note:</b> The data must contain a TrueType or OpenType font.</p>
<!-- @@@QRawFont -->
<!-- $$$QRawFont$$$QRawFontconstQRawFont& -->
<h3 class="fn"><a name="QRawFont-4"></a>QRawFont::<span class="name">QRawFont</span> ( const <span class="type">QRawFont</span> & <i>other</i> )</h3>
<p>Creates a <a href="qrawfont.html">QRawFont</a> which is a copy of <i>other</i>.</p>
<!-- @@@QRawFont -->
<!-- $$$~QRawFont[overload1]$$$~QRawFont -->
<h3 class="fn"><a name="dtor.QRawFont"></a>QRawFont::<span class="name">~QRawFont</span> ()</h3>
<p>Destroys the <a href="qrawfont.html">QRawFont</a></p>
<!-- @@@~QRawFont -->
<!-- $$$advancesForGlyphIndexes[overload1]$$$advancesForGlyphIndexesconstQVector<quint32>& -->
<h3 class="fn"><a name="advancesForGlyphIndexes"></a><span class="type"><a href="qvector.html">QVector</a></span><<span class="type"><a href="qpointf.html">QPointF</a></span>> QRawFont::<span class="name">advancesForGlyphIndexes</span> ( const <span class="type"><a href="qvector.html">QVector</a></span><<span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span>> & <i>glyphIndexes</i> ) const</h3>
<p>Returns the <a href="qrawfont.html">QRawFont</a>'s advances for each of the <i>glyphIndexes</i> 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.</p>
<p><b>See also </b><a href="qtextline.html#horizontalAdvance">QTextLine::horizontalAdvance</a>() and <a href="qfontmetricsf.html#width">QFontMetricsF::width</a>().</p>
<!-- @@@advancesForGlyphIndexes -->
<!-- $$$advancesForGlyphIndexes$$$advancesForGlyphIndexesconstquint32*QPointF*int -->
<h3 class="fn"><a name="advancesForGlyphIndexes-2"></a><span class="type">bool</span> QRawFont::<span class="name">advancesForGlyphIndexes</span> ( const <span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span> * <i>glyphIndexes</i>, <span class="type"><a href="qpointf.html">QPointF</a></span> * <i>advances</i>, <span class="type">int</span> <i>numGlyphs</i> ) const</h3>
<p>Returns the <a href="qrawfont.html">QRawFont</a>'s advances for each of the <i>glyphIndexes</i> 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 <i>glyphIndexes</i> while the results are returned through <i>advances</i>, both of them must have <i>numGlyphs</i> elements.</p>
<p><b>See also </b><a href="qtextline.html#horizontalAdvance">QTextLine::horizontalAdvance</a>() and <a href="qfontmetricsf.html#width">QFontMetricsF::width</a>().</p>
<!-- @@@advancesForGlyphIndexes -->
<!-- $$$alphaMapForGlyph[overload1]$$$alphaMapForGlyphquint32AntialiasingTypeconstQTransform& -->
<h3 class="fn"><a name="alphaMapForGlyph"></a><span class="type"><a href="qimage.html">QImage</a></span> QRawFont::<span class="name">alphaMapForGlyph</span> ( <span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span> <i>glyphIndex</i>, <span class="type"><a href="qrawfont.html#AntialiasingType-enum">AntialiasingType</a></span> <i>antialiasingType</i> = SubPixelAntialiasing, const <span class="type"><a href="qtransform.html">QTransform</a></span> & <i>transform</i> = QTransform() ) const</h3>
<p>This function returns a rasterized image of the glyph at the given <i>glyphIndex</i> in the underlying font, using the <i>transform</i> specified. If the <a href="qrawfont.html">QRawFont</a> is not valid, this function will return an invalid <a href="qimage.html">QImage</a>.</p>
<p>If <i>antialiasingType</i> is set to <a href="qrawfont.html#AntialiasingType-enum">QRawFont::SubPixelAntialiasing</a>, then the resulting image will be in <a href="qimage.html#Format-enum">QImage::Format_RGB32</a> 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 <a href="qimage.html#Format-enum">QImage::Format_Indexed8</a> and each pixel will contain the opacity of the pixel in the rasterization.</p>
<p><b>See also </b><a href="qrawfont.html#pathForGlyph">pathForGlyph</a>() and <a href="qpainter.html#drawGlyphRun">QPainter::drawGlyphRun</a>().</p>
<!-- @@@alphaMapForGlyph -->
<!-- $$$ascent[overload1]$$$ascent -->
<h3 class="fn"><a name="ascent"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">ascent</span> () const</h3>
<p>Returns the ascent of this <a href="qrawfont.html">QRawFont</a> in pixel units.</p>
<p><b>See also </b><a href="qfontmetricsf.html#ascent">QFontMetricsF::ascent</a>().</p>
<!-- @@@ascent -->
<!-- $$$averageCharWidth[overload1]$$$averageCharWidth -->
<h3 class="fn"><a name="averageCharWidth"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">averageCharWidth</span> () const</h3>
<p>Returns the average character width of this <a href="qrawfont.html">QRawFont</a> in pixel units.</p>
<p><b>See also </b><a href="qfontmetricsf.html#averageCharWidth">QFontMetricsF::averageCharWidth</a>().</p>
<!-- @@@averageCharWidth -->
<!-- $$$descent[overload1]$$$descent -->
<h3 class="fn"><a name="descent"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">descent</span> () const</h3>
<p>Returns the descent of this <a href="qrawfont.html">QRawFont</a> in pixel units.</p>
<p><b>See also </b><a href="qfontmetricsf.html#descent">QFontMetricsF::descent</a>().</p>
<!-- @@@descent -->
<!-- $$$familyName[overload1]$$$familyName -->
<h3 class="fn"><a name="familyName"></a><span class="type"><a href="qstring.html">QString</a></span> QRawFont::<span class="name">familyName</span> () const</h3>
<p>Returns the family name of this <a href="qrawfont.html">QRawFont</a>.</p>
<!-- @@@familyName -->
<!-- $$$fontTable[overload1]$$$fontTableconstchar* -->
<h3 class="fn"><a name="fontTable"></a><span class="type"><a href="qbytearray.html">QByteArray</a></span> QRawFont::<span class="name">fontTable</span> ( const <span class="type">char</span> * <i>tagName</i> ) const</h3>
<p>Retrieves the sfnt table named <i>tagName</i> 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 <i>tagName</i> must be four characters long and should be formatted in the default endianness of the current platform.</p>
<!-- @@@fontTable -->
<!-- $$$fromFont[overload1]$$$fromFontconstQFont&QFontDatabase::WritingSystem -->
<h3 class="fn"><a name="fromFont"></a><span class="type">QRawFont</span> QRawFont::<span class="name">fromFont</span> ( const <span class="type"><a href="qfont.html">QFont</a></span> & <i>font</i>, <span class="type"><a href="qfontdatabase.html#WritingSystem-enum">QFontDatabase::WritingSystem</a></span> <i>writingSystem</i> = QFontDatabase::Any )<tt> [static]</tt></h3>
<p>Fetches the physical representation based on a <i>font</i> query. The physical font returned is the font that will be preferred by Qt in order to display text in the selected <i>writingSystem</i>.</p>
<!-- @@@fromFont -->
<!-- $$$glyphIndexesForChars[overload1]$$$glyphIndexesForCharsconstQChar*intquint32*int* -->
<h3 class="fn"><a name="glyphIndexesForChars"></a><span class="type">bool</span> QRawFont::<span class="name">glyphIndexesForChars</span> ( const <span class="type"><a href="qchar.html">QChar</a></span> * <i>chars</i>, <span class="type">int</span> <i>numChars</i>, <span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span> * <i>glyphIndexes</i>, <span class="type">int</span> * <i>numGlyphs</i> ) const</h3>
<p>Converts a string of unicode points to glyph indexes using the CMAP table in the underlying font. The function works like <a href="qrawfont.html#glyphIndexesForString">glyphIndexesForString</a>() except it take an array (<i>chars</i>), the results will be returned though <i>glyphIndexes</i> array and number of glyphs will be set in <i>numGlyphs</i>. The size of <i>glyphIndexes</i> array must be at least <i>numChars</i>, if that's still not enough, this function will return false, then you can resize <i>glyphIndexes</i> from the size returned in <i>numGlyphs</i>.</p>
<p><b>See also </b><a href="qrawfont.html#glyphIndexesForString">glyphIndexesForString</a>(), <a href="qrawfont.html#advancesForGlyphIndexes">advancesForGlyphIndexes</a>(), <a href="qglyphrun.html">QGlyphRun</a>, <a href="qtextlayout.html#glyphRuns">QTextLayout::glyphRuns</a>(), and <a href="qtextfragment.html#glyphRuns">QTextFragment::glyphRuns</a>().</p>
<!-- @@@glyphIndexesForChars -->
<!-- $$$glyphIndexesForString[overload1]$$$glyphIndexesForStringconstQString& -->
<h3 class="fn"><a name="glyphIndexesForString"></a><span class="type"><a href="qvector.html">QVector</a></span><<span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span>> QRawFont::<span class="name">glyphIndexesForString</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>text</i> ) const</h3>
<p>Converts the string of unicode points given by <i>text</i> to glyph indexes using the CMAP table in the underlying font, and returns a vector containing the result.</p>
<p>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 <a href="qtextlayout.html">QTextLayout</a> to lay out and shape the text, then call QTextLayout::glyphs() to get the set of glyph index list and <a href="qrawfont.html">QRawFont</a> pairs.</p>
<p><b>See also </b><a href="qrawfont.html#advancesForGlyphIndexes">advancesForGlyphIndexes</a>(), <a href="qrawfont.html#glyphIndexesForChars">glyphIndexesForChars</a>(), <a href="qglyphrun.html">QGlyphRun</a>, <a href="qtextlayout.html#glyphRuns">QTextLayout::glyphRuns</a>(), and <a href="qtextfragment.html#glyphRuns">QTextFragment::glyphRuns</a>().</p>
<!-- @@@glyphIndexesForString -->
<!-- $$$hintingPreference[overload1]$$$hintingPreference -->
<h3 class="fn"><a name="hintingPreference"></a><span class="type"><a href="qfont.html#HintingPreference-enum">QFont::HintingPreference</a></span> QRawFont::<span class="name">hintingPreference</span> () const</h3>
<p>Returns the hinting preference used to construct this <a href="qrawfont.html">QRawFont</a>.</p>
<p><b>See also </b><a href="qfont.html#hintingPreference">QFont::hintingPreference</a>().</p>
<!-- @@@hintingPreference -->
<!-- $$$isValid[overload1]$$$isValid -->
<h3 class="fn"><a name="isValid"></a><span class="type">bool</span> QRawFont::<span class="name">isValid</span> () const</h3>
<p>Returns true if the <a href="qrawfont.html">QRawFont</a> is valid and false otherwise.</p>
<!-- @@@isValid -->
<!-- $$$leading[overload1]$$$leading -->
<h3 class="fn"><a name="leading"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">leading</span> () const</h3>
<p>Returns the leading of this <a href="qrawfont.html">QRawFont</a> in pixel units.</p>
<p><b>See also </b><a href="qfontmetricsf.html#leading">QFontMetricsF::leading</a>().</p>
<!-- @@@leading -->
<!-- $$$loadFromData[overload1]$$$loadFromDataconstQByteArray&qrealQFont::HintingPreference -->
<h3 class="fn"><a name="loadFromData"></a><span class="type">void</span> QRawFont::<span class="name">loadFromData</span> ( const <span class="type"><a href="qbytearray.html">QByteArray</a></span> & <i>fontData</i>, <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> <i>pixelSize</i>, <span class="type"><a href="qfont.html#HintingPreference-enum">QFont::HintingPreference</a></span> <i>hintingPreference</i> )</h3>
<p>Replaces the current <a href="qrawfont.html">QRawFont</a> with the font contained in the supplied <i>fontData</i> for the size (in pixels) given by <i>pixelSize</i>, and using the hinting preference specified by <i>hintingPreference</i>.</p>
<p>The <i>fontData</i> must contain a TrueType or OpenType font.</p>
<p><b>See also </b><a href="qrawfont.html#loadFromFile">loadFromFile</a>().</p>
<!-- @@@loadFromData -->
<!-- $$$loadFromFile[overload1]$$$loadFromFileconstQString&qrealQFont::HintingPreference -->
<h3 class="fn"><a name="loadFromFile"></a><span class="type">void</span> QRawFont::<span class="name">loadFromFile</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>fileName</i>, <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> <i>pixelSize</i>, <span class="type"><a href="qfont.html#HintingPreference-enum">QFont::HintingPreference</a></span> <i>hintingPreference</i> )</h3>
<p>Replaces the current <a href="qrawfont.html">QRawFont</a> with the contents of the file referenced by <i>fileName</i> for the size (in pixels) given by <i>pixelSize</i>, and using the hinting preference specified by <i>hintingPreference</i>.</p>
<p>The file must reference a TrueType or OpenType font.</p>
<p><b>See also </b><a href="qrawfont.html#loadFromData">loadFromData</a>().</p>
<!-- @@@loadFromFile -->
<!-- $$$maxCharWidth[overload1]$$$maxCharWidth -->
<h3 class="fn"><a name="maxCharWidth"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">maxCharWidth</span> () const</h3>
<p>Returns the width of the widest character in the font.</p>
<p><b>See also </b><a href="qfontmetricsf.html#maxWidth">QFontMetricsF::maxWidth</a>().</p>
<!-- @@@maxCharWidth -->
<!-- $$$pathForGlyph[overload1]$$$pathForGlyphquint32 -->
<h3 class="fn"><a name="pathForGlyph"></a><span class="type"><a href="qpainterpath.html">QPainterPath</a></span> QRawFont::<span class="name">pathForGlyph</span> ( <span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span> <i>glyphIndex</i> ) const</h3>
<p>This function returns the shape of the glyph at a given <i>glyphIndex</i> in the underlying font if the <a href="qrawfont.html">QRawFont</a> is valid. Otherwise, it returns an empty <a href="qpainterpath.html">QPainterPath</a>.</p>
<p>The returned glyph will always be unhinted.</p>
<p><b>See also </b><a href="qrawfont.html#alphaMapForGlyph">alphaMapForGlyph</a>() and <a href="qpainterpath.html#addText">QPainterPath::addText</a>().</p>
<!-- @@@pathForGlyph -->
<!-- $$$pixelSize[overload1]$$$pixelSize -->
<h3 class="fn"><a name="pixelSize"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">pixelSize</span> () const</h3>
<p>Returns the pixel size set for this <a href="qrawfont.html">QRawFont</a>. The pixel size affects how glyphs are rasterized, the size of glyphs returned by <a href="qrawfont.html#pathForGlyph">pathForGlyph</a>(), and is used to convert internal metrics from design units to logical pixel units.</p>
<p><b>See also </b><a href="qrawfont.html#setPixelSize">setPixelSize</a>().</p>
<!-- @@@pixelSize -->
<!-- $$$setPixelSize[overload1]$$$setPixelSizeqreal -->
<h3 class="fn"><a name="setPixelSize"></a><span class="type">void</span> QRawFont::<span class="name">setPixelSize</span> ( <span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> <i>pixelSize</i> )</h3>
<p>Sets the pixel size with which this font should be rendered to <i>pixelSize</i>.</p>
<p><b>See also </b><a href="qrawfont.html#pixelSize">pixelSize</a>().</p>
<!-- @@@setPixelSize -->
<!-- $$$style[overload1]$$$style -->
<h3 class="fn"><a name="style"></a><span class="type"><a href="qfont.html#Style-enum">QFont::Style</a></span> QRawFont::<span class="name">style</span> () const</h3>
<p>Returns the style of this <a href="qrawfont.html">QRawFont</a>.</p>
<p><b>See also </b><a href="qfont.html#style">QFont::style</a>().</p>
<!-- @@@style -->
<!-- $$$styleName[overload1]$$$styleName -->
<h3 class="fn"><a name="styleName"></a><span class="type"><a href="qstring.html">QString</a></span> QRawFont::<span class="name">styleName</span> () const</h3>
<p>Returns the style name of this <a href="qrawfont.html">QRawFont</a>.</p>
<p><b>See also </b><a href="qfont.html#styleName">QFont::styleName</a>().</p>
<!-- @@@styleName -->
<!-- $$$supportedWritingSystems[overload1]$$$supportedWritingSystems -->
<h3 class="fn"><a name="supportedWritingSystems"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qfontdatabase.html#WritingSystem-enum">QFontDatabase::WritingSystem</a></span>> QRawFont::<span class="name">supportedWritingSystems</span> () const</h3>
<p>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 <a href="qrawfont.html#supportsCharacter">supportsCharacter</a>() to check support for a single, specific character.</p>
<p><b>Note:</b> 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.</p>
<p><b>See also </b><a href="qrawfont.html#supportsCharacter">supportsCharacter</a>().</p>
<!-- @@@supportedWritingSystems -->
<!-- $$$supportsCharacter[overload1]$$$supportsCharacterQChar -->
<h3 class="fn"><a name="supportsCharacter"></a><span class="type">bool</span> QRawFont::<span class="name">supportsCharacter</span> ( <span class="type"><a href="qchar.html">QChar</a></span> <i>character</i> ) const</h3>
<p>Returns true if the font has a glyph that corresponds to the given <i>character</i>.</p>
<p><b>See also </b><a href="qrawfont.html#supportedWritingSystems">supportedWritingSystems</a>().</p>
<!-- @@@supportsCharacter -->
<!-- $$$supportsCharacter$$$supportsCharacterquint32 -->
<h3 class="fn"><a name="supportsCharacter-2"></a><span class="type">bool</span> QRawFont::<span class="name">supportsCharacter</span> ( <span class="type"><a href="qtglobal.html#quint32-typedef">quint32</a></span> <i>ucs4</i> ) const</h3>
<p>This is an overloaded function.</p>
<p>Returns true if the font has a glyph that corresponds to the UCS-4 encoded character <i>ucs4</i>.</p>
<p><b>See also </b><a href="qrawfont.html#supportedWritingSystems">supportedWritingSystems</a>().</p>
<!-- @@@supportsCharacter -->
<!-- $$$unitsPerEm[overload1]$$$unitsPerEm -->
<h3 class="fn"><a name="unitsPerEm"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">unitsPerEm</span> () const</h3>
<p>Returns the number of design units define the width and height of the em square for this <a href="qrawfont.html">QRawFont</a>. 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.</p>
<p><b>See also </b><a href="qrawfont.html#pixelSize">pixelSize</a>() and <a href="qrawfont.html#setPixelSize">setPixelSize</a>().</p>
<!-- @@@unitsPerEm -->
<!-- $$$weight[overload1]$$$weight -->
<h3 class="fn"><a name="weight"></a><span class="type">int</span> QRawFont::<span class="name">weight</span> () const</h3>
<p>Returns the weight of this <a href="qrawfont.html">QRawFont</a>.</p>
<p><b>See also </b><a href="qfont.html#weight">QFont::weight</a>().</p>
<!-- @@@weight -->
<!-- $$$xHeight[overload1]$$$xHeight -->
<h3 class="fn"><a name="xHeight"></a><span class="type"><a href="qtglobal.html#qreal-typedef">qreal</a></span> QRawFont::<span class="name">xHeight</span> () const</h3>
<p>Returns the xHeight of this <a href="qrawfont.html">QRawFont</a> in pixel units.</p>
<p><b>See also </b><a href="qfontmetricsf.html#xHeight">QFontMetricsF::xHeight</a>().</p>
<!-- @@@xHeight -->
<!-- $$$operator!=[overload1]$$$operator!=constQRawFont& -->
<h3 class="fn"><a name="operator-not-eq"></a><span class="type">bool</span> QRawFont::<span class="name">operator!=</span> ( const <span class="type">QRawFont</span> & <i>other</i> ) const</h3>
<p>Returns true if this <a href="qrawfont.html">QRawFont</a> is not equal to <i>other</i>. Otherwise, returns false.</p>
<!-- @@@operator!= -->
<!-- $$$operator=[overload1]$$$operator=constQRawFont& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">QRawFont</span> & QRawFont::<span class="name">operator=</span> ( const <span class="type">QRawFont</span> & <i>other</i> )</h3>
<p>Assigns <i>other</i> to this <a href="qrawfont.html">QRawFont</a>.</p>
<!-- @@@operator= -->
<!-- $$$operator==[overload1]$$$operator==constQRawFont& -->
<h3 class="fn"><a name="operator-eq-eq"></a><span class="type">bool</span> QRawFont::<span class="name">operator==</span> ( const <span class="type">QRawFont</span> & <i>other</i> ) const</h3>
<p>Returns true if this <a href="qrawfont.html">QRawFont</a> is equal to <i>other</i>. Otherwise, returns false.</p>
<!-- @@@operator== -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
