docs/html/pango-Coverage-Maps.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Coverage Maps</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
   7 <link rel="home" href="index.html" title="Pango Reference Manual">
   8 <link rel="up" href="lowlevel.html" title="Low Level Functionality">
   9 <link rel="prev" href="pango-OpenType-Font-Handling.html" title="OpenType Font Handling">
  10 <link rel="next" href="pango-Engines.html" title="Engines">
  11 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
  14 <link rel="chapter" href="rendering.html" title="Rendering with Pango">
  15 <link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
  16 <link rel="chapter" href="tools.html" title="Pango Tools">
  17 <link rel="chapter" href="pango-hierarchy.html" title="Object Hierarchy">
  18 <link rel="index" href="index-all.html" title="Index">
  19 <link rel="index" href="index-deprecated.html" title="Index of deprecated symbols">
  20 <link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
  21 <link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
  22 <link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
  23 <link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
  24 <link rel="index" href="index-1.10.html" title="Index of new symbols in 1.10">
  25 <link rel="index" href="index-1.12.html" title="Index of new symbols in 1.12">
  26 <link rel="index" href="index-1.14.html" title="Index of new symbols in 1.14">
  27 <link rel="index" href="index-1.16.html" title="Index of new symbols in 1.16">
  28 <link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
  29 <link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
  30 <link rel="index" href="index-1.22.html" title="Index of new symbols in 1.22">
  31 <link rel="index" href="index-1.24.html" title="Index of new symbols in 1.24">
  32 <link rel="index" href="index-1.26.html" title="Index of new symbols in 1.26">
  33 </head>
  34 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  35 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  36 <tr valign="middle">
  37 <td><a accesskey="p" href="pango-OpenType-Font-Handling.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  38 <td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  39 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  40 <th width="100%" align="center">Pango Reference Manual</th>
  41 <td><a accesskey="n" href="pango-Engines.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  42 </tr>
  43 <tr><td colspan="5" class="shortcuts">
  44 <a href="#pango-Coverage-Maps.synopsis" class="shortcut">Top</a>
  45                  |
  46                 <a href="#pango-Coverage-Maps.description" class="shortcut">Description</a>
  47 </td></tr>
  48 </table>
  49 <div class="refentry" lang="en">
  50 <a name="pango-Coverage-Maps"></a><div class="titlepage"></div>
  51 <div class="refnamediv"><table width="100%"><tr>
  52 <td valign="top">
  53 <h2><span class="refentrytitle"><a name="pango-Coverage-Maps.top_of_page"></a>Coverage Maps</span></h2>
  54 <p>Coverage Maps — Unicode character range coverage storage</p>
  55 </td>
  56 <td valign="top" align="right"></td>
  57 </tr></table></div>
  58 <div class="refsynopsisdiv">
  59 <a name="pango-Coverage-Maps.synopsis"></a><h2>Synopsis</h2>
  60 <pre class="synopsis">
  61 enum                <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel">PangoCoverageLevel</a>;
  62 #define             <a class="link" href="pango-Coverage-Maps.html#PANGO-TYPE-COVERAGE-LEVEL--CAPS" title="PANGO_TYPE_COVERAGE_LEVEL">PANGO_TYPE_COVERAGE_LEVEL</a>
  63                     <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a>;
  64
  65 <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     <a class="link" href="pango-Coverage-Maps.html#pango-coverage-new" title="pango_coverage_new ()">pango_coverage_new</a>                  (void);
  66 <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     <a class="link" href="pango-Coverage-Maps.html#pango-coverage-ref" title="pango_coverage_ref ()">pango_coverage_ref</a>                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);
  67 void                <a class="link" href="pango-Coverage-Maps.html#pango-coverage-unref" title="pango_coverage_unref ()">pango_coverage_unref</a>                (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);
  68 <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     <a class="link" href="pango-Coverage-Maps.html#pango-coverage-copy" title="pango_coverage_copy ()">pango_coverage_copy</a>                 (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);
  69 <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel">PangoCoverageLevel</a>  <a class="link" href="pango-Coverage-Maps.html#pango-coverage-get" title="pango_coverage_get ()">pango_coverage_get</a>                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
  70                                                          int index_);
  71 void                <a class="link" href="pango-Coverage-Maps.html#pango-coverage-max" title="pango_coverage_max ()">pango_coverage_max</a>                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
  72                                                          <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *other);
  73 void                <a class="link" href="pango-Coverage-Maps.html#pango-coverage-set" title="pango_coverage_set ()">pango_coverage_set</a>                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
  74                                                          int index_,
  75                                                          <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel">PangoCoverageLevel</a> level);
  76 void                <a class="link" href="pango-Coverage-Maps.html#pango-coverage-to-bytes" title="pango_coverage_to_bytes ()">pango_coverage_to_bytes</a>             (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
  77                                                          <a
  78 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
  79 >guchar</a> **bytes,
  80                                                          int *n_bytes);
  81 <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     <a class="link" href="pango-Coverage-Maps.html#pango-coverage-from-bytes" title="pango_coverage_from_bytes ()">pango_coverage_from_bytes</a>           (<a
  82 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
  83 >guchar</a> *bytes,
  84                                                          int n_bytes);
  85 </pre>
  86 </div>
  87 <div class="refsect1" lang="en">
  88 <a name="pango-Coverage-Maps.description"></a><h2>Description</h2>
  89 <p>
  90 It is often necessary in Pango to determine if a particular font can
  91 represent a particular character, and also how well it can represent
  92 that character. The <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> is a data structure that is used
  93 to represent that information.
  94 </p>
  95 </div>
  96 <div class="refsect1" lang="en">
  97 <a name="pango-Coverage-Maps.details"></a><h2>Details</h2>
  98 <div class="refsect2" lang="en">
  99 <a name="PangoCoverageLevel"></a><h3>enum PangoCoverageLevel</h3>
 100 <pre class="programlisting">typedef enum {
 101   PANGO_COVERAGE_NONE,
 102   PANGO_COVERAGE_FALLBACK,
 103   PANGO_COVERAGE_APPROXIMATE,
 104   PANGO_COVERAGE_EXACT
 105 } PangoCoverageLevel;
 106 </pre>
 107 <p>
 108 Used to indicate how well a font can represent a particular Unicode
 109 character point for a particular script.
 110 </p>
 111 <div class="variablelist"><table border="0">
 112 <col align="left" valign="top">
 113 <tbody>
 114 <tr>
 115 <td><p><a name="PANGO-COVERAGE-NONE--CAPS"></a><span class="term"><code class="literal">PANGO_COVERAGE_NONE</code></span></p></td>
 116 <td>The character is not representable with the font.
 117 </td>
 118 </tr>
 119 <tr>
 120 <td><p><a name="PANGO-COVERAGE-FALLBACK--CAPS"></a><span class="term"><code class="literal">PANGO_COVERAGE_FALLBACK</code></span></p></td>
 121 <td>The character is represented in a way that may be
 122                           comprehensible but is not the correct graphical form.
 123                           For instance, a Hangul character represented as a
 124                           a sequence of Jamos, or a Latin transliteration of
 125                           a Cyrillic word.
 126 </td>
 127 </tr>
 128 <tr>
 129 <td><p><a name="PANGO-COVERAGE-APPROXIMATE--CAPS"></a><span class="term"><code class="literal">PANGO_COVERAGE_APPROXIMATE</code></span></p></td>
 130 <td>The character is represented as basically the correct
 131                              graphical form, but with a stylistic variant inappropriate for
 132                              the current script.
 133 </td>
 134 </tr>
 135 <tr>
 136 <td><p><a name="PANGO-COVERAGE-EXACT--CAPS"></a><span class="term"><code class="literal">PANGO_COVERAGE_EXACT</code></span></p></td>
 137 <td>The character is represented as the correct graphical form.
 138 </td>
 139 </tr>
 140 </tbody>
 141 </table></div>
 142 </div>
 143 <hr>
 144 <div class="refsect2" lang="en">
 145 <a name="PANGO-TYPE-COVERAGE-LEVEL--CAPS"></a><h3>PANGO_TYPE_COVERAGE_LEVEL</h3>
 146 <pre class="programlisting">#define PANGO_TYPE_COVERAGE_LEVEL (pango_coverage_level_get_type())
 147 </pre>
 148 <p>
 149 The <a
 150 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 151 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel"><span class="type">PangoCoverageLevel</span></a>.
 152 </p>
 153 </div>
 154 <hr>
 155 <div class="refsect2" lang="en">
 156 <a name="PangoCoverage"></a><h3>PangoCoverage</h3>
 157 <pre class="programlisting">typedef struct _PangoCoverage PangoCoverage;</pre>
 158 <p>
 159 The <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> structure represents a map from Unicode characters
 160 to <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel"><span class="type">PangoCoverageLevel</span></a>. It is an opaque structure with no public fields.
 161 </p>
 162 </div>
 163 <hr>
 164 <div class="refsect2" lang="en">
 165 <a name="pango-coverage-new"></a><h3>pango_coverage_new ()</h3>
 166 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     pango_coverage_new                  (void);</pre>
 167 <p>
 168 Create a new <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a></p>
 169 <p>
 170 </p>
 171 <div class="variablelist"><table border="0">
 172 <col align="left" valign="top">
 173 <tbody><tr>
 174 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 175 <td> the newly allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>,
 176               initialized to <a class="link" href="pango-Coverage-Maps.html#PANGO-COVERAGE-NONE--CAPS"><code class="literal">PANGO_COVERAGE_NONE</code></a>
 177               with a reference count of one, which
 178               should be freed with <a class="link" href="pango-Coverage-Maps.html#pango-coverage-unref" title="pango_coverage_unref ()"><code class="function">pango_coverage_unref()</code></a>.
 179 </td>
 180 </tr></tbody>
 181 </table></div>
 182 </div>
 183 <hr>
 184 <div class="refsect2" lang="en">
 185 <a name="pango-coverage-ref"></a><h3>pango_coverage_ref ()</h3>
 186 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     pango_coverage_ref                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);</pre>
 187 <p>
 188 Increase the reference count on the <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> by one</p>
 189 <p>
 190 </p>
 191 <div class="variablelist"><table border="0">
 192 <col align="left" valign="top">
 193 <tbody>
 194 <tr>
 195 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 196 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 197 </td>
 198 </tr>
 199 <tr>
 200 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 201 <td> <em class="parameter"><code>coverage</code></em>
 202 </td>
 203 </tr>
 204 </tbody>
 205 </table></div>
 206 </div>
 207 <hr>
 208 <div class="refsect2" lang="en">
 209 <a name="pango-coverage-unref"></a><h3>pango_coverage_unref ()</h3>
 210 <pre class="programlisting">void                pango_coverage_unref                (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);</pre>
 211 <p>
 212 Decrease the reference count on the <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> by one.
 213 If the result is zero, free the coverage and all associated memory.</p>
 214 <p>
 215 </p>
 216 <div class="variablelist"><table border="0">
 217 <col align="left" valign="top">
 218 <tbody><tr>
 219 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 220 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 221 </td>
 222 </tr></tbody>
 223 </table></div>
 224 </div>
 225 <hr>
 226 <div class="refsect2" lang="en">
 227 <a name="pango-coverage-copy"></a><h3>pango_coverage_copy ()</h3>
 228 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     pango_coverage_copy                 (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage);</pre>
 229 <p>
 230 Copy an existing <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>. (This function may now be unnecessary
 231 since we refcount the structure. File a bug if you use it.)</p>
 232 <p>
 233 </p>
 234 <div class="variablelist"><table border="0">
 235 <col align="left" valign="top">
 236 <tbody>
 237 <tr>
 238 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 239 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 240 </td>
 241 </tr>
 242 <tr>
 243 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 244 <td> the newly allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>,
 245               with a reference count of one, which
 246               should be freed with <a class="link" href="pango-Coverage-Maps.html#pango-coverage-unref" title="pango_coverage_unref ()"><code class="function">pango_coverage_unref()</code></a>.
 247 </td>
 248 </tr>
 249 </tbody>
 250 </table></div>
 251 </div>
 252 <hr>
 253 <div class="refsect2" lang="en">
 254 <a name="pango-coverage-get"></a><h3>pango_coverage_get ()</h3>
 255 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel">PangoCoverageLevel</a>  pango_coverage_get                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
 256                                                          int index_);</pre>
 257 <p>
 258 Determine whether a particular index is covered by <em class="parameter"><code>coverage</code></em></p>
 259 <p>
 260 </p>
 261 <div class="variablelist"><table border="0">
 262 <col align="left" valign="top">
 263 <tbody>
 264 <tr>
 265 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 266 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 267 </td>
 268 </tr>
 269 <tr>
 270 <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
 271 <td> the index to check
 272 </td>
 273 </tr>
 274 <tr>
 275 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 276 <td> the coverage level of <em class="parameter"><code>coverage</code></em> for character <em class="parameter"><code>index_</code></em>.
 277 </td>
 278 </tr>
 279 </tbody>
 280 </table></div>
 281 </div>
 282 <hr>
 283 <div class="refsect2" lang="en">
 284 <a name="pango-coverage-max"></a><h3>pango_coverage_max ()</h3>
 285 <pre class="programlisting">void                pango_coverage_max                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
 286                                                          <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *other);</pre>
 287 <p>
 288 Set the coverage for each index in <em class="parameter"><code>coverage</code></em> to be the max (better)
 289 value of the current coverage for the index and the coverage for
 290 the corresponding index in <em class="parameter"><code>other</code></em>.</p>
 291 <p>
 292 </p>
 293 <div class="variablelist"><table border="0">
 294 <col align="left" valign="top">
 295 <tbody>
 296 <tr>
 297 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 298 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 299 </td>
 300 </tr>
 301 <tr>
 302 <td><p><span class="term"><em class="parameter"><code>other</code></em> :</span></p></td>
 303 <td> another <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 304 </td>
 305 </tr>
 306 </tbody>
 307 </table></div>
 308 </div>
 309 <hr>
 310 <div class="refsect2" lang="en">
 311 <a name="pango-coverage-set"></a><h3>pango_coverage_set ()</h3>
 312 <pre class="programlisting">void                pango_coverage_set                  (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
 313                                                          int index_,
 314                                                          <a class="link" href="pango-Coverage-Maps.html#PangoCoverageLevel" title="enum PangoCoverageLevel">PangoCoverageLevel</a> level);</pre>
 315 <p>
 316 Modify a particular index within <em class="parameter"><code>coverage</code></em></p>
 317 <p>
 318 </p>
 319 <div class="variablelist"><table border="0">
 320 <col align="left" valign="top">
 321 <tbody>
 322 <tr>
 323 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 324 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 325 </td>
 326 </tr>
 327 <tr>
 328 <td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
 329 <td> the index to modify
 330 </td>
 331 </tr>
 332 <tr>
 333 <td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
 334 <td> the new level for <em class="parameter"><code>index_</code></em>
 335 </td>
 336 </tr>
 337 </tbody>
 338 </table></div>
 339 </div>
 340 <hr>
 341 <div class="refsect2" lang="en">
 342 <a name="pango-coverage-to-bytes"></a><h3>pango_coverage_to_bytes ()</h3>
 343 <pre class="programlisting">void                pango_coverage_to_bytes             (<a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *coverage,
 344                                                          <a
 345 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
 346 >guchar</a> **bytes,
 347                                                          int *n_bytes);</pre>
 348 <p>
 349 Convert a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a> structure into a flat binary format</p>
 350 <p>
 351 </p>
 352 <div class="variablelist"><table border="0">
 353 <col align="left" valign="top">
 354 <tbody>
 355 <tr>
 356 <td><p><span class="term"><em class="parameter"><code>coverage</code></em> :</span></p></td>
 357 <td> a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 358 </td>
 359 </tr>
 360 <tr>
 361 <td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
 362 <td> location to store result (must be freed with <a
 363 href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"
 364 ><code class="function">g_free()</code></a>)
 365 </td>
 366 </tr>
 367 <tr>
 368 <td><p><span class="term"><em class="parameter"><code>n_bytes</code></em> :</span></p></td>
 369 <td> location to store size of result
 370 </td>
 371 </tr>
 372 </tbody>
 373 </table></div>
 374 </div>
 375 <hr>
 376 <div class="refsect2" lang="en">
 377 <a name="pango-coverage-from-bytes"></a><h3>pango_coverage_from_bytes ()</h3>
 378 <pre class="programlisting"><a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage">PangoCoverage</a> *     pango_coverage_from_bytes           (<a
 379 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"
 380 >guchar</a> *bytes,
 381                                                          int n_bytes);</pre>
 382 <p>
 383 Convert data generated from <code class="function">pango_converage_to_bytes()</code> back
 384 to a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a></p>
 385 <p>
 386 </p>
 387 <div class="variablelist"><table border="0">
 388 <col align="left" valign="top">
 389 <tbody>
 390 <tr>
 391 <td><p><span class="term"><em class="parameter"><code>bytes</code></em> :</span></p></td>
 392 <td> binary data representing a <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>
 393 </td>
 394 </tr>
 395 <tr>
 396 <td><p><span class="term"><em class="parameter"><code>n_bytes</code></em> :</span></p></td>
 397 <td> the size of <em class="parameter"><code>bytes</code></em> in bytes
 398 </td>
 399 </tr>
 400 <tr>
 401 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 402 <td> a newly allocated <a class="link" href="pango-Coverage-Maps.html#PangoCoverage" title="PangoCoverage"><span class="type">PangoCoverage</span></a>, or <a
 403 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 404 ><code class="literal">NULL</code></a> if
 405               the data was invalid.
 406 </td>
 407 </tr>
 408 </tbody>
 409 </table></div>
 410 </div>
 411 </div>
 412 </div>
 413 <div class="footer">
 414 <hr>
 415           Generated by GTK-Doc V1.11</div>
 416 </body>
 417 </html>