1
1
<refentry id="pango-Modules">
3
<refentrytitle role="top_of_page">Modules</refentrytitle>
3
<refentrytitle role="top_of_page" id="pango-Modules.top_of_page">Modules</refentrytitle>
4
4
<manvolnum>3</manvolnum>
5
5
<refmiscinfo>PANGO Library</refmiscinfo>
11
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
14
<refsynopsisdiv id="pango-Modules.synopsis" role="synopsis">
15
15
<title role="synopsis.title">Synopsis</title>
21
18
<link linkend="PangoIncludedModule">PangoIncludedModule</link>;
22
19
<link linkend="PangoMap">PangoMap</link>;
23
20
<link linkend="PangoMapEntry">PangoMapEntry</link>;
53
<refsect1 role="details">
50
<refsect1 id="pango-Modules.details" role="details">
54
51
<title role="details.title">Details</title>
56
<title><anchor id="PangoIncludedModule" role="struct"/>PangoIncludedModule</title>
57
<indexterm><primary>PangoIncludedModule</primary></indexterm><programlisting>typedef struct {
52
<refsect2 id="PangoIncludedModule" role="struct">
53
<title>PangoIncludedModule</title>
54
<indexterm zone="PangoIncludedModule"><primary>PangoIncludedModule</primary></indexterm><programlisting>typedef struct {
58
55
void (*list) (PangoEngineInfo **engines,
60
57
void (*init) (GTypeModule *module);
89
86
</simpara></listitem>
91
88
</variablelist></refsect2>
93
<title><anchor id="PangoMap" role="struct"/>PangoMap</title>
94
<indexterm><primary>PangoMap</primary></indexterm><programlisting>typedef struct _PangoMap PangoMap;</programlisting>
89
<refsect2 id="PangoMap" role="struct">
90
<title>PangoMap</title>
91
<indexterm zone="PangoMap"><primary>PangoMap</primary></indexterm><programlisting>typedef struct _PangoMap PangoMap;</programlisting>
96
93
A <link linkend="PangoMap"><type>PangoMap</type></link> structure can be used to determine the engine to
97
94
use for each character.
100
<title><anchor id="PangoMapEntry" role="struct"/>PangoMapEntry</title>
101
<indexterm><primary>PangoMapEntry</primary></indexterm><programlisting>typedef struct _PangoMapEntry PangoMapEntry;</programlisting>
96
<refsect2 id="PangoMapEntry" role="struct">
97
<title>PangoMapEntry</title>
98
<indexterm zone="PangoMapEntry"><primary>PangoMapEntry</primary></indexterm><programlisting>typedef struct _PangoMapEntry PangoMapEntry;</programlisting>
103
100
A <link linkend="PangoMapEntry"><type>PangoMapEntry</type></link> contains information about the engine that should be used
104
101
for the codepoint to which this entry belongs and also whether the engine
105
102
matches the language tag for this entry's map exactly or just approximately.
106
103
</para></refsect2>
108
<title><anchor id="pango-find-map" role="function"/>pango_find_map ()</title>
109
<indexterm><primary>pango_find_map</primary></indexterm><programlisting><link linkend="PangoMap">PangoMap</link>* pango_find_map (<link linkend="PangoLanguage">PangoLanguage</link> *language,
104
<refsect2 id="pango-find-map" role="function">
105
<title>pango_find_map ()</title>
106
<indexterm zone="pango-find-map"><primary>pango_find_map</primary></indexterm><programlisting><link linkend="PangoMap">PangoMap</link>* pango_find_map (<link linkend="PangoLanguage">PangoLanguage</link> *language,
110
107
<link linkend="guint">guint</link> engine_type_id,
111
108
<link linkend="guint">guint</link> render_type_id);</programlisting>
128
125
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the suitable <link linkend="PangoMap"><type>PangoMap</type></link>.
129
126
</simpara></listitem></varlistentry>
130
127
</variablelist></refsect2>
132
<title><anchor id="pango-map-get-engine" role="function"/>pango_map_get_engine ()</title>
133
<indexterm><primary>pango_map_get_engine</primary></indexterm><programlisting><link linkend="PangoEngine">PangoEngine</link>* pango_map_get_engine (<link linkend="PangoMap">PangoMap</link> *map,
128
<refsect2 id="pango-map-get-engine" role="function">
129
<title>pango_map_get_engine ()</title>
130
<indexterm zone="pango-map-get-engine"><primary>pango_map_get_engine</primary></indexterm><programlisting><link linkend="PangoEngine">PangoEngine</link>* pango_map_get_engine (<link linkend="PangoMap">PangoMap</link> *map,
134
131
<link linkend="PangoScript">PangoScript</link> script);</programlisting>
136
133
Returns the best engine listed in the map for a given script</para>
150
147
returned is arbitrary.
151
148
</simpara></listitem></varlistentry>
152
149
</variablelist></refsect2>
154
<title><anchor id="pango-map-get-engines" role="function" condition="since:1.4"/>pango_map_get_engines ()</title>
155
<indexterm role="1.4"><primary>pango_map_get_engines</primary></indexterm><programlisting><link linkend="void">void</link> pango_map_get_engines (<link linkend="PangoMap">PangoMap</link> *map,
150
<refsect2 id="pango-map-get-engines" role="function" condition="since:1.4">
151
<title>pango_map_get_engines ()</title>
152
<indexterm zone="pango-map-get-engines" role="1.4"><primary>pango_map_get_engines</primary></indexterm><programlisting><link linkend="void">void</link> pango_map_get_engines (<link linkend="PangoMap">PangoMap</link> *map,
156
153
<link linkend="PangoScript">PangoScript</link> script,
157
154
<link linkend="GSList">GSList</link> **exact_engines,
158
155
<link linkend="GSList">GSList</link> **fallback_engines);</programlisting>
180
177
</simpara></listitem></varlistentry>
181
178
</variablelist><para role="since">Since 1.4
182
179
</para></refsect2>
184
<title><anchor id="pango-module-register" role="function"/>pango_module_register ()</title>
185
<indexterm><primary>pango_module_register</primary></indexterm><programlisting><link linkend="void">void</link> pango_module_register (<link linkend="PangoIncludedModule">PangoIncludedModule</link> *module);</programlisting>
180
<refsect2 id="pango-module-register" role="function">
181
<title>pango_module_register ()</title>
182
<indexterm zone="pango-module-register"><primary>pango_module_register</primary></indexterm><programlisting><link linkend="void">void</link> pango_module_register (<link linkend="PangoIncludedModule">PangoIncludedModule</link> *module);</programlisting>
187
184
Registers a statically linked module with Pango. The
188
185
<link linkend="PangoIncludedModule"><type>PangoIncludedModule</type></link> structure that is passed in contains the