pango-xft-fonts-and-rendering.html

GTK+-2.0源码之pango-1.15.6.tar.gz

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886619"></a><h3>
<a name="pango-xft-font-unlock-face"></a>pango_xft_font_unlock_face ()</h3>
<a class="indexterm" name="id2886635"></a><a class="indexterm" name="id2886643"></a><pre class="programlisting">void        pango_xft_font_unlock_face      (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">pango_xft_font_unlock_face</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Releases a font previously obtained with
<a href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-lock-face"><code class="function">pango_xft_font_lock_face()</code></a>.
</p>
<p>
Use <a href="PangoFcFont.html#pango-fc-font-unlock-face"><code class="function">pango_fc_font_unlock_face()</code></a> instead.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
</td>
</tr></tbody>
</table></div>
<p>Since  1.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886741"></a><h3>
<a name="pango-xft-font-get-glyph"></a>pango_xft_font_get_glyph ()</h3>
<a class="indexterm" name="id2886756"></a><a class="indexterm" name="id2886765"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#guint"
>guint</a>       pango_xft_font_get_glyph        (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
                                             <a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">pango_xft_font_get_glyph</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Gets the glyph index for a given Unicode character
for <em class="parameter"><code>font</code></em>. If you only want to determine
whether the font has the glyph, use <a href="pango-Xft-Fonts-and-Rendering.html#pango-xft-font-has-char"><code class="function">pango_xft_font_has_char()</code></a>.
</p>
<p>
Use <a href="PangoFcFont.html#pango-fc-font-get-glyph"><code class="function">pango_fc_font_get_glyph()</code></a> instead.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> for the Xft backend
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em>&#160;:</span></td>
<td> Unicode codepoint to look up
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the glyph index, or 0, if the Unicode
 character does not exist in the font.

</td>
</tr>
</tbody>
</table></div>
<p>Since  1.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2886905"></a><h3>
<a name="pango-xft-font-get-unknown-glyph"></a>pango_xft_font_get_unknown_glyph ()</h3>
<a class="indexterm" name="id2886921"></a><pre class="programlisting"><a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a>  pango_xft_font_get_unknown_glyph
                                            (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
                                             <a
href="../glib/glib-Unicode-Manipulation.html#gunichar"
>gunichar</a> wc);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">pango_xft_font_get_unknown_glyph</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the index of a glyph suitable for drawing <em class="parameter"><code>wc</code></em> as an
unknown character.
</p>
<p>
Use <a href="pango-Glyph-Storage.html#PANGO-GET-UNKNOWN-GLYPH:CAPS"><code class="function">PANGO_GET_UNKNOWN_GLYPH()</code></a> instead.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>font</code></em>&#160;:</span></td>
<td> a <a href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>wc</code></em>&#160;:</span></td>
<td> the Unicode character for which a glyph is needed.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a glyph index into <em class="parameter"><code>font</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887052"></a><h3>
<a name="PangoXftRenderer"></a>PangoXftRenderer</h3>
<a class="indexterm" name="id2887068"></a><pre class="programlisting">typedef struct {
} PangoXftRenderer;
</pre>
<p>
<a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a> is a subclass of <a href="pango-PangoRenderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> used for rendering
with Pango's Xft backend. It can be used directly, or it can be
further subclassed to modify exactly how drawing of individual
elements occurs.</p>
<p>

</p>
<p>Since  1.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887110"></a><h3>
<a name="PangoXftRendererClass"></a>PangoXftRendererClass</h3>
<a class="indexterm" name="id2887126"></a><pre class="programlisting">typedef struct {
  void (*composite_trapezoids) (PangoXftRenderer *xftrenderer,
				PangoRenderPart   part,
				XTrapezoid       *trapezoids,
				int               n_trapezoids);
  void (*composite_glyphs)     (PangoXftRenderer *xftrenderer,
				XftFont          *xft_font,
				XftGlyphSpec     *glyphs,
				int               n_glyphs);
} PangoXftRendererClass;
</pre>
<p>
The class structure for <a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a></p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="structfield"><code>composite_trapezoids</code></em>&#160;()</span></td>
<td> draw the specified trapezoids using
  the current color and other attributes for <em class="parameter"><code>part</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="structfield"><code>composite_glyphs</code></em>&#160;()</span></td>
<td> draw the specified glyphs using
  the current foreground color and other foreground
  attributes
</td>
</tr>
</tbody>
</table></div>
<p>Since  1.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887202"></a><h3>
<a name="pango-xft-renderer-new"></a>pango_xft_renderer_new ()</h3>
<a class="indexterm" name="id2887218"></a><pre class="programlisting"><a href="pango-PangoRenderer.html#PangoRenderer">PangoRenderer</a>* pango_xft_renderer_new       (Display *display,
                                             int screen);</pre>
<p>
Create a new <a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a> to allow rendering Pango objects
with the Xft library. You must call <a href="pango-Xft-Fonts-and-Rendering.html#pango-xft-renderer-set-draw"><code class="function">pango_xft_renderer_set_draw()</code></a> before
using the renderer.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>display</code></em>&#160;:</span></td>
<td> an X display
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></td>
<td>   the index of the screen for <em class="parameter"><code>display</code></em> to which rendering will be done
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the newly created <a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>, which should
              be freed with <a
href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"
><code class="function">g_object_unref()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p>Since  1.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887350"></a><h3>
<a name="pango-xft-renderer-set-draw"></a>pango_xft_renderer_set_draw ()</h3>
<a class="indexterm" name="id2887367"></a><pre class="programlisting">void        pango_xft_renderer_set_draw     (<a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
                                             XftDraw *draw);</pre>
<p>
Sets the <span class="type">XftDraw</span> object that the renderer is drawing to.
The renderer must not be currently active.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>xftrenderer</code></em>&#160;:</span></td>
<td> a <a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer"><span class="type">PangoXftRenderer</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>draw</code></em>&#160;:</span></td>
<td> a <span class="type">XftDraw</span>
</td>
</tr>
</tbody>
</table></div>
<p>Since  1.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887467"></a><h3>
<a name="pango-xft-renderer-set-default-color"></a>pango_xft_renderer_set_default_color ()</h3>
<a class="indexterm" name="id2887483"></a><pre class="programlisting">void        pango_xft_renderer_set_default_color
                                            (<a href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a> *xftrenderer,
                                             <a href="pango-Text-Attributes.html#PangoColor">PangoColor</a> *default_color);</pre>
<p>
Sets the default foreground color for a <span class="type">XftRenderer</span>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>xftrenderer</code></em>&#160;:</span></td>
<td> a <span class="type">XftRenderer</span>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>default_color</code></em>&#160;:</span></td>
<td> the default foreground color
</td>
</tr>
</tbody>
</table></div>
<p>Since  1.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2887578"></a><h3>
<a name="pango-xft-render"></a>pango_xft_render ()</h3>
<a class="indexterm" name="id2887591"></a><pre class="programlisting">void        pango_xft_render                (XftDraw *draw,
                                             XftColor *color,
                                             <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
                                             <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
                                             <a
href="../glib/glib-Basic-Types.html#gint"