pango-text-processing.html

linux

If you are using Pango as part of a higher-level system,
that system may have it's own ways of create a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.
For instance, the GTK+ toolkit has, among others,
<code class="function">gdk_pango_context_get_for_screen()</code>, and
<code class="function">gtk_widget_get_pango_context()</code>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the newly allocated <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</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>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3085909"></a><h3>
<a name="pango-context-set-font-map"></a>pango_context_set_font_map ()</h3>
<a class="indexterm" name="id3085922"></a><pre class="programlisting">void                pango_context_set_font_map          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
                                                         <a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> *font_map);</pre>
<p>
Sets the font map to be searched when fonts are looked-up in this context.
This is only for internal use by Pango backends, a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> obtained
via one of the recommended methods should already have a suitable font map.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>font_map</code></em>&#160;:</span></td>
<td> the <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> to set.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086022"></a><h3>
<a name="pango-context-get-font-map"></a>pango_context_get_font_map ()</h3>
<a class="indexterm" name="id3086038"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>*       pango_context_get_font_map          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context);</pre>
<p>
Gets the <span class="type">PangoFontmap</span> used to look up fonts for this context.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the font map for the <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>. This value
 is owned by Pango and should not be unreferenced.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  1.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086132"></a><h3>
<a name="pango-context-get-font-description"></a>pango_context_get_font_description ()</h3>
<a class="indexterm" name="id3086146"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_context_get_font_description
                                                        (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context);</pre>
<p>
Retrieve the default font description for the context.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> a pointer to the context's default font description.
              This value must not be modified or freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086218"></a><h3>
<a name="pango-context-set-font-description"></a>pango_context_set_font_description ()</h3>
<a class="indexterm" name="id3086232"></a><pre class="programlisting">void                pango_context_set_font_description  (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
                                                         const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre>
<p>
Set the default font description for the context</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td>
<td> the new pango font description
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086314"></a><h3>
<a name="pango-context-get-language"></a>pango_context_get_language ()</h3>
<a class="indexterm" name="id3086327"></a><pre class="programlisting"><a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a>*      pango_context_get_language          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context);</pre>
<p>
Retrieves the global language tag for the context.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the global language tag.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086396"></a><h3>
<a name="pango-context-set-language"></a>pango_context_set_language ()</h3>
<a class="indexterm" name="id3086410"></a><pre class="programlisting">void                pango_context_set_language          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
                                                         <a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);</pre>
<p>
Sets the global language tag for the context.  The default language
for the locale of the running process can be found using
<a href="pango-Miscellaneous-Utilities.html#pango-language-get-default"><code class="function">pango_language_get_default()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>language</code></em>&#160;:</span></td>
<td> the new language tag.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086504"></a><h3>
<a name="pango-context-get-base-dir"></a>pango_context_get_base_dir ()</h3>
<a class="indexterm" name="id3086517"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoDirection">PangoDirection</a>      pango_context_get_base_dir          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context);</pre>
<p>
Retrieves the base direction for the context. See
<a href="pango-Text-Processing.html#pango-context-set-base-dir"><code class="function">pango_context_set_base_dir()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> the base direction for the context.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086598"></a><h3>
<a name="pango-context-set-base-dir"></a>pango_context_set_base_dir ()</h3>
<a class="indexterm" name="id3086611"></a><pre class="programlisting">void                pango_context_set_base_dir          (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context,
                                                         <a href="pango-Text-Processing.html#PangoDirection">PangoDirection</a> direction);</pre>
<p>
Sets the base direction for the context.
</p>
<p>
The base direction is used in applying the Unicode bidirectional
algorithm; if the <em class="parameter"><code>direction</code></em> is <a href="pango-Text-Processing.html#PANGO-DIRECTION-LTR:CAPS"><code class="literal">PANGO_DIRECTION_LTR</code></a> or
<a href="pango-Text-Processing.html#PANGO-DIRECTION-RTL:CAPS"><code class="literal">PANGO_DIRECTION_RTL</code></a>, then the value will be used as the paragraph
direction in the Unicode bidirectional algorithm.  A value of
<a href="pango-Text-Processing.html#PANGO-DIRECTION-WEAK-LTR:CAPS"><code class="literal">PANGO_DIRECTION_WEAK_LTR</code></a> or <a href="pango-Text-Processing.html#PANGO-DIRECTION-WEAK-RTL:CAPS"><code class="literal">PANGO_DIRECTION_WEAK_RTL</code></a> is used only
for paragraphs that do not contain any strong characters themselves.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>context</code></em>&#160;:</span></td>
<td> a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>direction</code></em>&#160;:</span></td>
<td> the new base direction
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3086751"></a><h3>
<a name="pango-context-get-base-gravity"></a>pango_context_get_base_gravity ()</h3>
<a class="indexterm" name="id3086766"></a><pre class="programlisting"><a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a>        pango_context_get_base_gravity      (<a href="pango-Text-Processing.html#PangoContext">PangoContext</a> *context);</pre>
<p>
Retrieves the base gravity for the context. See
<a href="pango-Text-Processing.html#pango-context-set-base-gravity"><code class="function">pango_context_set_base_gravity()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">