<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>cairomm: Cairo::ScaledFont Class Reference</title>
<link href="cairomm.css" rel="stylesheet" type="text/css">
</head>
<body>
<!-- Generated by Doxygen 1.5.9 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceCairo.html">Cairo</a>::<a class="el" href="classCairo_1_1ScaledFont.html">ScaledFont</a>
</div>
</div>
<div class="contents">
<h1>Cairo::ScaledFont Class Reference</h1><!-- doxytag: class="Cairo::ScaledFont" -->A <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> is a font scaled to a particular size and device resolution.
<a href="#_details">More...</a>
<p>
Inherited by <a class="el" href="classCairo_1_1FtScaledFont.html">Cairo::FtScaledFont</a>, and <a class="el" href="classCairo_1_1Win32ScaledFont.html">Cairo::Win32ScaledFont</a>.
<p>
<p>
<a href="classCairo_1_1ScaledFont-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef cairo_scaled_font_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The underlying C cairo object type. <a href="#2d6be7ee16b4cbdcff67e6fdf3682b2a"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#db6a80b560e695f10e39810bfede01b4">cobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides acces to the underlying C cairo object. <a href="#db6a80b560e695f10e39810bfede01b4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#59b9ad6357e84be0e020ae163eeb7ffc">cobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides acces to the underlying C cairo object. <a href="#59b9ad6357e84be0e020ae163eeb7ffc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#4407baae7eda0bf820e7c38596edcf7f">ScaledFont</a> (<a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* cobj, bool has_reference=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a C++ wrapper object from the C instance. <a href="#4407baae7eda0bf820e7c38596edcf7f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#09ca7c3ff04102bd54c3898f740eea3e">~ScaledFont</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#bd99255e4eb802e9350143ec81a197af">get_extents</a> (<a class="el" href="namespaceCairo.html#a7da46c699a67bfbdd5400af7e6b7b39">FontExtents</a>& extents) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the metrics for a <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a>. <a href="#bd99255e4eb802e9350143ec81a197af"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#a64969e519ce44fba35f2061594e6f81">extents</a> (<a class="el" href="namespaceCairo.html#a7da46c699a67bfbdd5400af7e6b7b39">FontExtents</a>& extents) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#757a8effcae445a5c46bf4501424abae">get_text_extents</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a>& utf8, <a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& extents) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the extents for a string of text. <a href="#757a8effcae445a5c46bf4501424abae"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#396afc516d53234a04e81693a75b0203">text_extents</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a>& utf8, <a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& extents) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#abfe38c6ca3e1c575b85aa7094e8601d">get_glyph_extents</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& glyphs, <a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& extents)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the extents for an array of glyphs. <a href="#abfe38c6ca3e1c575b85aa7094e8601d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#859bbee5886b15e1d8ab599dabab9833">glyph_extents</a> (const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& glyphs, <a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& extents)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#c20c70e78e70276842ab460bdc75513e">get_font_face</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The <a class="el" href="classCairo_1_1FontFace.html" title="A FontFace represents a particular font at a particular weight, slant, and other...">FontFace</a> with which this <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created. <a href="#c20c70e78e70276842ab460bdc75513e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#77b387d0cd3f23a71997d3719e270fd6">get_font_options</a> (<a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& options) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classCairo_1_1FontOptions.html" title="How a font should be rendered.">FontOptions</a> with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created. <a href="#77b387d0cd3f23a71997d3719e270fd6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#3f4c3924cc10b3cffb025b6f6fa2e13b">get_font_matrix</a> (<a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& font_matrix) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the font matrix with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created. <a href="#3f4c3924cc10b3cffb025b6f6fa2e13b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#ba264e1844f7fe7704115a984a39f437">get_font_matrix</a> (<a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& font_matrix) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#2ecb41822d51284c2f52a83b05cede8e">get_ctm</a> (<a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& ctm) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the CTM with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created. <a href="#2ecb41822d51284c2f52a83b05cede8e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#86b6d3179b10491e2c755b886ef49b9e">get_ctm</a> (<a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& ctm) const </td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespaceCairo.html#23e1a9a5be49d16cf3871e841e8ab522">FontType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#eabb462f690ec9e22fc0096af38c46bc">get_type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the type of scaled Font. <a href="#eabb462f690ec9e22fc0096af38c46bc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#bf1bb0d07de65cc8d8f7e64d83f0be26">text_to_glyphs</a> (double x, double y, const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a>& utf8, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& glyphs, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#3c23510889078c8a75d66add004ab288">TextCluster</a> >& clusters, <a class="el" href="namespaceCairo.html#61b770cf36c555a4098b5428e030542a">TextClusterFlags</a>& cluster_flags)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#c31d37dc06c1a95830cb9e30425f609c">get_scale_matrix</a> (<a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& scale_matrix) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Stores the scale matrix of this scaled font into matrix. <a href="#c31d37dc06c1a95830cb9e30425f609c"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1ScaledFont.html">ScaledFont</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#dddf87ea689711ddbbee3028ed30e02b">create</a> (const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& font_face, const <a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& font_matrix, const <a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& ctm, const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& options=<a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>())</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> object from a font face and matrices that describe the size of the font and the environment in which it will be used. <a href="#dddf87ea689711ddbbee3028ed30e02b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1ScaledFont.html">ScaledFont</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#2d422798461d1ad67d0191b71df1c25e">create</a> (const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& font_face, const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& font_matrix, const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& ctm, const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& options=<a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>())</td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#ca31f49f3121d2a6673205bebe7720c0">ScaledFont</a> (const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& font_face, const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& font_matrix, const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& ctm, const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& options=<a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>())</td></tr>
<tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classCairo_1_1ScaledFont.html#a6f45de0a89807dd6678029807227757">m_cobject</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The underlying C cairo object that is wrapped by this <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a>. <a href="#a6f45de0a89807dd6678029807227757"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
A <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> is a font scaled to a particular size and device resolution.
<p>
It is most useful for low-level font usage where a library or application wants to cache a reference to a scaled font to speed up the computation of metrics. <hr><h2>Member Typedef Documentation</h2>
<a class="anchor" name="2d6be7ee16b4cbdcff67e6fdf3682b2a"></a><!-- doxytag: member="Cairo::ScaledFont::cobject" ref="2d6be7ee16b4cbdcff67e6fdf3682b2a" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef cairo_scaled_font_t <a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">Cairo::ScaledFont::cobject</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The underlying C cairo object type.
<p>
</div>
</div><p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="4407baae7eda0bf820e7c38596edcf7f"></a><!-- doxytag: member="Cairo::ScaledFont::ScaledFont" ref="4407baae7eda0bf820e7c38596edcf7f" args="(cobject *cobj, bool has_reference=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Cairo::ScaledFont::ScaledFont </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* </td>
<td class="paramname"> <em>cobj</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>has_reference</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a C++ wrapper object from the C instance.
<p>
This C++ object should then be given to a <a class="el" href="classCairo_1_1RefPtr.html" title="RefPtr<> is a reference-counting shared smartpointer.">RefPtr</a>.
</div>
</div><p>
<a class="anchor" name="09ca7c3ff04102bd54c3898f740eea3e"></a><!-- doxytag: member="Cairo::ScaledFont::~ScaledFont" ref="09ca7c3ff04102bd54c3898f740eea3e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Cairo::ScaledFont::~ScaledFont </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="ca31f49f3121d2a6673205bebe7720c0"></a><!-- doxytag: member="Cairo::ScaledFont::ScaledFont" ref="ca31f49f3121d2a6673205bebe7720c0" args="(const RefPtr< FontFace > &font_face, const cairo_matrix_t &font_matrix, const cairo_matrix_t &ctm, const FontOptions &options=FontOptions())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Cairo::ScaledFont::ScaledFont </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& </td>
<td class="paramname"> <em>font_face</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>font_matrix</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>ctm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& </td>
<td class="paramname"> <em>options</em> = <code><a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="59b9ad6357e84be0e020ae163eeb7ffc"></a><!-- doxytag: member="Cairo::ScaledFont::cobj" ref="59b9ad6357e84be0e020ae163eeb7ffc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* Cairo::ScaledFont::cobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides acces to the underlying C cairo object.
<p>
</div>
</div><p>
<a class="anchor" name="db6a80b560e695f10e39810bfede01b4"></a><!-- doxytag: member="Cairo::ScaledFont::cobj" ref="db6a80b560e695f10e39810bfede01b4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* Cairo::ScaledFont::cobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Provides acces to the underlying C cairo object.
<p>
</div>
</div><p>
<a class="anchor" name="2d422798461d1ad67d0191b71df1c25e"></a><!-- doxytag: member="Cairo::ScaledFont::create" ref="2d422798461d1ad67d0191b71df1c25e" args="(const RefPtr< FontFace > &font_face, const cairo_matrix_t &font_matrix, const cairo_matrix_t &ctm, const FontOptions &options=FontOptions())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a><<a class="el" href="classCairo_1_1ScaledFont.html">ScaledFont</a>> Cairo::ScaledFont::create </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& </td>
<td class="paramname"> <em>font_face</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>font_matrix</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>ctm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& </td>
<td class="paramname"> <em>options</em> = <code><a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="dddf87ea689711ddbbee3028ed30e02b"></a><!-- doxytag: member="Cairo::ScaledFont::create" ref="dddf87ea689711ddbbee3028ed30e02b" args="(const RefPtr< FontFace > &font_face, const Matrix &font_matrix, const Matrix &ctm, const FontOptions &options=FontOptions())" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a><<a class="el" href="classCairo_1_1ScaledFont.html">ScaledFont</a>> Cairo::ScaledFont::create </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a>< <a class="el" href="classCairo_1_1FontFace.html">FontFace</a> >& </td>
<td class="paramname"> <em>font_face</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& </td>
<td class="paramname"> <em>font_matrix</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& </td>
<td class="paramname"> <em>ctm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& </td>
<td class="paramname"> <em>options</em> = <code><a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>()</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Creates a <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> object from a font face and matrices that describe the size of the font and the environment in which it will be used.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>font_face</em> </td><td>A font face. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>font_matrix</em> </td><td>font space to user space transformation matrix for the font. In the simplest case of a N point font, this matrix is just a scale by N, but it can also be used to shear the font or stretch it unequally along the two axes. See <a class="el" href="classCairo_1_1Context.html#7981bd1109ec5538fb505b36ec377757">Context::set_font_matrix()</a>. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ctm</em> </td><td>user to device transformation matrix with which the font will be used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>options to use when getting metrics for the font and rendering with it. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="a64969e519ce44fba35f2061594e6f81"></a><!-- doxytag: member="Cairo::ScaledFont::extents" ref="a64969e519ce44fba35f2061594e6f81" args="(FontExtents &extents) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::extents </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#a7da46c699a67bfbdd5400af7e6b7b39">FontExtents</a>& </td>
<td class="paramname"> <em>extents</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="deprecated" compact><dt><b><a class="el" href="deprecated.html#_deprecated000002">Deprecated:</a></b></dt><dd>Use <a class="el" href="classCairo_1_1ScaledFont.html#bd99255e4eb802e9350143ec81a197af" title="Gets the metrics for a ScaledFont.">get_extents()</a> instead </dd></dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="86b6d3179b10491e2c755b886ef49b9e"></a><!-- doxytag: member="Cairo::ScaledFont::get_ctm" ref="86b6d3179b10491e2c755b886ef49b9e" args="(cairo_matrix_t &ctm) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_ctm </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>ctm</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="2ecb41822d51284c2f52a83b05cede8e"></a><!-- doxytag: member="Cairo::ScaledFont::get_ctm" ref="2ecb41822d51284c2f52a83b05cede8e" args="(Matrix &ctm) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_ctm </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& </td>
<td class="paramname"> <em>ctm</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the CTM with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="bd99255e4eb802e9350143ec81a197af"></a><!-- doxytag: member="Cairo::ScaledFont::get_extents" ref="bd99255e4eb802e9350143ec81a197af" args="(FontExtents &extents) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_extents </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#a7da46c699a67bfbdd5400af7e6b7b39">FontExtents</a>& </td>
<td class="paramname"> <em>extents</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the metrics for a <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a>.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.8 </dd></dl>
</div>
</div><p>
<a class="anchor" name="c20c70e78e70276842ab460bdc75513e"></a><!-- doxytag: member="Cairo::ScaledFont::get_font_face" ref="c20c70e78e70276842ab460bdc75513e" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classCairo_1_1RefPtr.html">RefPtr</a><<a class="el" href="classCairo_1_1FontFace.html">FontFace</a>> Cairo::ScaledFont::get_font_face </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The <a class="el" href="classCairo_1_1FontFace.html" title="A FontFace represents a particular font at a particular weight, slant, and other...">FontFace</a> with which this <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ba264e1844f7fe7704115a984a39f437"></a><!-- doxytag: member="Cairo::ScaledFont::get_font_matrix" ref="ba264e1844f7fe7704115a984a39f437" args="(cairo_matrix_t &font_matrix) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_font_matrix </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classcairo__matrix__t.html">cairo_matrix_t</a>& </td>
<td class="paramname"> <em>font_matrix</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="3f4c3924cc10b3cffb025b6f6fa2e13b"></a><!-- doxytag: member="Cairo::ScaledFont::get_font_matrix" ref="3f4c3924cc10b3cffb025b6f6fa2e13b" args="(Matrix &font_matrix) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_font_matrix </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& </td>
<td class="paramname"> <em>font_matrix</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the font matrix with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="77b387d0cd3f23a71997d3719e270fd6"></a><!-- doxytag: member="Cairo::ScaledFont::get_font_options" ref="77b387d0cd3f23a71997d3719e270fd6" args="(FontOptions &options) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_font_options </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCairo_1_1FontOptions.html">FontOptions</a>& </td>
<td class="paramname"> <em>options</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the <a class="el" href="classCairo_1_1FontOptions.html" title="How a font should be rendered.">FontOptions</a> with which the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> was created.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="abfe38c6ca3e1c575b85aa7094e8601d"></a><!-- doxytag: member="Cairo::ScaledFont::get_glyph_extents" ref="abfe38c6ca3e1c575b85aa7094e8601d" args="(const std::vector< Glyph > &glyphs, TextExtents &extents)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_glyph_extents </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& </td>
<td class="paramname"> <em>glyphs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& </td>
<td class="paramname"> <em>extents</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the extents for an array of glyphs.
<p>
The extents describe a user-space rectangle that encloses the "inked" portion of the glyphs, (as they would be drawn by <a class="el" href="classCairo_1_1Context.html#f51f2c2ff72e8af66abeea3d15d25553">Context::show_glyphs()</a> if the cairo graphics state were set to the same font_face, font_matrix, ctm, and font_options as the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> object). Additionally, the x_advance and y_advance values indicate the amount by which the current point would be advanced by <a class="el" href="classCairo_1_1Context.html#f51f2c2ff72e8af66abeea3d15d25553">Context::show_glyphs()</a>.<p>
Note that whitespace glyphs do not contribute to the size of the rectangle (extents.width and extents.height).<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>glyphs</em> </td><td>A vector of glyphs to calculate the extents of. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>extents</em> </td><td>Returns the extents for the array of glyphs.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.8 </dd></dl>
</div>
</div><p>
<a class="anchor" name="c31d37dc06c1a95830cb9e30425f609c"></a><!-- doxytag: member="Cairo::ScaledFont::get_scale_matrix" ref="c31d37dc06c1a95830cb9e30425f609c" args="(Matrix &scale_matrix) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_scale_matrix </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classCairo_1_1Matrix.html">Matrix</a>& </td>
<td class="paramname"> <em>scale_matrix</em> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Stores the scale matrix of this scaled font into matrix.
<p>
The scale matrix is product of the font matrix and the ctm associated with the scaled font, and hence is the matrix mapping from font space to device space.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>scale_matrix</em> </td><td>return value for the matrix.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.8 </dd></dl>
</div>
</div><p>
<a class="anchor" name="757a8effcae445a5c46bf4501424abae"></a><!-- doxytag: member="Cairo::ScaledFont::get_text_extents" ref="757a8effcae445a5c46bf4501424abae" args="(const std::string &utf8, TextExtents &extents) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::get_text_extents </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a> & </td>
<td class="paramname"> <em>utf8</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& </td>
<td class="paramname"> <em>extents</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the extents for a string of text.
<p>
The extents describe a user-space rectangle that encloses the "inked" portion of the text drawn at the origin (0,0) (as it would be drawn by <a class="el" href="classCairo_1_1Context.html#584596d6f12dbea30519b908cacce038">Context::show_text()</a> if the cairo graphics state were set to the same font_face, font_matrix, ctm, and font_options as the <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a> object). Additionally, the x_advance and y_advance values indicate the amount by which the current point would be advanced by <a class="el" href="classCairo_1_1Context.html#584596d6f12dbea30519b908cacce038">Context::show_text()</a>.<p>
Note that whitespace characters do not directly contribute to the size of the rectangle (extents.width and extents.height). They do contribute indirectly by changing the position of non-whitespace characters. In particular, trailing whitespace characters are likely to not affect the size of the rectangle, though they will affect the x_advance and y_advance values.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>utf8</em> </td><td>a string of text, encoded in UTF-8. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>extents</em> </td><td>Returns the extents of the given string.</td></tr>
</table>
</dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.8 </dd></dl>
</div>
</div><p>
<a class="anchor" name="eabb462f690ec9e22fc0096af38c46bc"></a><!-- doxytag: member="Cairo::ScaledFont::get_type" ref="eabb462f690ec9e22fc0096af38c46bc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceCairo.html#23e1a9a5be49d16cf3871e841e8ab522">FontType</a> Cairo::ScaledFont::get_type </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the type of scaled Font.
<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="859bbee5886b15e1d8ab599dabab9833"></a><!-- doxytag: member="Cairo::ScaledFont::glyph_extents" ref="859bbee5886b15e1d8ab599dabab9833" args="(const std::vector< Glyph > &glyphs, TextExtents &extents)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::glyph_extents </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& </td>
<td class="paramname"> <em>glyphs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& </td>
<td class="paramname"> <em>extents</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="deprecated" compact><dt><b><a class="el" href="deprecated.html#_deprecated000004">Deprecated:</a></b></dt><dd>Use <a class="el" href="classCairo_1_1ScaledFont.html#abfe38c6ca3e1c575b85aa7094e8601d" title="Gets the extents for an array of glyphs.">get_glyph_extents()</a> instead </dd></dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="396afc516d53234a04e81693a75b0203"></a><!-- doxytag: member="Cairo::ScaledFont::text_extents" ref="396afc516d53234a04e81693a75b0203" args="(const std::string &utf8, TextExtents &extents) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::text_extents </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a> & </td>
<td class="paramname"> <em>utf8</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#f6d8a4744616383984c99f8f052c7a5d">TextExtents</a>& </td>
<td class="paramname"> <em>extents</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="deprecated" compact><dt><b><a class="el" href="deprecated.html#_deprecated000003">Deprecated:</a></b></dt><dd>Use <a class="el" href="classCairo_1_1ScaledFont.html#757a8effcae445a5c46bf4501424abae" title="Gets the extents for a string of text.">get_text_extents()</a> instead </dd></dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.2 </dd></dl>
</div>
</div><p>
<a class="anchor" name="bf1bb0d07de65cc8d8f7e64d83f0be26"></a><!-- doxytag: member="Cairo::ScaledFont::text_to_glyphs" ref="bf1bb0d07de65cc8d8f7e64d83f0be26" args="(double x, double y, const std::string &utf8, std::vector< Glyph > &glyphs, std::vector< TextCluster > &clusters, TextClusterFlags &cluster_flags)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Cairo::ScaledFont::text_to_glyphs </td>
<td>(</td>
<td class="paramtype">double </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">double </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00218.html">std::string</a> & </td>
<td class="paramname"> <em>utf8</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#2483f165322e844c095c7be95849fdc2">Glyph</a> >& </td>
<td class="paramname"> <em>glyphs</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00599.html">std::vector</a>< <a class="el" href="namespaceCairo.html#3c23510889078c8a75d66add004ab288">TextCluster</a> >& </td>
<td class="paramname"> <em>clusters</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceCairo.html#61b770cf36c555a4098b5428e030542a">TextClusterFlags</a>& </td>
<td class="paramname"> <em>cluster_flags</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>X position to place first glyph. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>Y position to place first glyph. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>utf8</em> </td><td>a string of text encoded in UTF-8. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>glyphs</em> </td><td>pointer to array of glyphs to fill. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>clusters</em> </td><td>pointer to array of cluster mapping information to fill. cluster mapping flags</td></tr>
</table>
</dl>
Converts UTF-8 text to an array of glyphs, with cluster mapping, that can be used to render later.<p>
For details of how (<em>clusters</em> and <em>cluster_flags</em> map input UTF-8 text to the output glyphs see <a class="el" href="classCairo_1_1Context.html#45723fd605cc2343ab46cf603d330002">Context::show_text_glyphs()</a>.<p>
The output values can be readily passed to <a class="el" href="classCairo_1_1Context.html#45723fd605cc2343ab46cf603d330002">Context::show_text_glyphs()</a> <a class="el" href="classCairo_1_1Context.html#f51f2c2ff72e8af66abeea3d15d25553">Context::show_glyphs()</a>, or related functions, assuming that the exact same scaled font is used for the operation.<p>
<dl class="since" compact><dt><b>Since:</b></dt><dd>1.8 </dd></dl>
</div>
</div><p>
<hr><h2>Member Data Documentation</h2>
<a class="anchor" name="a6f45de0a89807dd6678029807227757"></a><!-- doxytag: member="Cairo::ScaledFont::m_cobject" ref="a6f45de0a89807dd6678029807227757" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classCairo_1_1ScaledFont.html#2d6be7ee16b4cbdcff67e6fdf3682b2a">cobject</a>* <a class="el" href="classCairo_1_1ScaledFont.html#a6f45de0a89807dd6678029807227757">Cairo::ScaledFont::m_cobject</a><code> [protected]</code> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The underlying C cairo object that is wrapped by this <a class="el" href="classCairo_1_1ScaledFont.html" title="A ScaledFont is a font scaled to a particular size and device resolution.">ScaledFont</a>.
<p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li>cairomm/scaledfont.h</ul>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Thu Aug 13 11:40:14 2009 for cairomm by 
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.9 </small></address>
</body>
</html>
