coverage-maps.xml

Pango is a library for layout and rendering of text, with an emphasis on internationalization. Pang

<refentry id="pango-Coverage-Maps">
<refmeta>
<refentrytitle role="top_of_page" id="pango-Coverage-Maps.top_of_page">Coverage Maps</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PANGO Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Coverage Maps</refname>
<refpurpose>Unicode character range coverage storage</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="pango-Coverage-Maps.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
enum                <link linkend="PangoCoverageLevel">PangoCoverageLevel</link>;
#define             <link linkend="PANGO-TYPE-COVERAGE-LEVEL:CAPS">PANGO_TYPE_COVERAGE_LEVEL</link>
                    <link linkend="PangoCoverage">PangoCoverage</link>;

<link linkend="PangoCoverage">PangoCoverage</link>*      <link linkend="pango-coverage-new">pango_coverage_new</link>                  (void);
<link linkend="PangoCoverage">PangoCoverage</link>*      <link linkend="pango-coverage-ref">pango_coverage_ref</link>                  (<link linkend="PangoCoverage">PangoCoverage</link> *coverage);
<link linkend="void">void</link>                <link linkend="pango-coverage-unref">pango_coverage_unref</link>                (<link linkend="PangoCoverage">PangoCoverage</link> *coverage);
<link linkend="PangoCoverage">PangoCoverage</link>*      <link linkend="pango-coverage-copy">pango_coverage_copy</link>                 (<link linkend="PangoCoverage">PangoCoverage</link> *coverage);
<link linkend="PangoCoverageLevel">PangoCoverageLevel</link>  <link linkend="pango-coverage-get">pango_coverage_get</link>                  (<link linkend="PangoCoverage">PangoCoverage</link> *coverage,
                                                         <link linkend="int">int</link> index_);
<link linkend="void">void</link>                <link linkend="pango-coverage-max">pango_coverage_max</link>                  (<link linkend="PangoCoverage">PangoCoverage</link> *coverage,
                                                         <link linkend="PangoCoverage">PangoCoverage</link> *other);
<link linkend="void">void</link>                <link linkend="pango-coverage-set">pango_coverage_set</link>                  (<link linkend="PangoCoverage">PangoCoverage</link> *coverage,
                                                         <link linkend="int">int</link> index_,
                                                         <link linkend="PangoCoverageLevel">PangoCoverageLevel</link> level);
<link linkend="void">void</link>                <link linkend="pango-coverage-to-bytes">pango_coverage_to_bytes</link>             (<link linkend="PangoCoverage">PangoCoverage</link> *coverage,
                                                         <link linkend="guchar">guchar</link> **bytes,
                                                         <link linkend="int">int</link> *n_bytes);
<link linkend="PangoCoverage">PangoCoverage</link>*      <link linkend="pango-coverage-from-bytes">pango_coverage_from_bytes</link>           (<link linkend="guchar">guchar</link> *bytes,
                                                         <link linkend="int">int</link> n_bytes);
</synopsis>
</refsynopsisdiv>









<refsect1 id="pango-Coverage-Maps.description" role="desc">
<title role="desc.title">Description</title>
<para>
It is often necessary in Pango to determine if a particular font can
represent a particular character, and also how well it can represent
that character. The <link linkend="PangoCoverage"><type>PangoCoverage</type></link> is a data structure that is used
to represent that information.
</para>
</refsect1>

<refsect1 id="pango-Coverage-Maps.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PangoCoverageLevel" role="enum">
<title>enum PangoCoverageLevel</title>
<indexterm zone="PangoCoverageLevel"><primary>PangoCoverageLevel</primary></indexterm><programlisting>typedef enum {
  PANGO_COVERAGE_NONE,
  PANGO_COVERAGE_FALLBACK,
  PANGO_COVERAGE_APPROXIMATE,
  PANGO_COVERAGE_EXACT
} PangoCoverageLevel;
</programlisting>
<para>
Used to indicate how well a font can represent a particular Unicode
character point for a particular script.
</para><variablelist role="enum">
<varlistentry id="PANGO-COVERAGE-NONE:CAPS" role="constant">
<term><literal>PANGO_COVERAGE_NONE</literal></term>
<listitem><simpara>The character is not representable with the font.
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-COVERAGE-FALLBACK:CAPS" role="constant">
<term><literal>PANGO_COVERAGE_FALLBACK</literal></term>
<listitem><simpara>The character is represented in a way that may be
                          comprehensible but is not the correct graphical form.
                          For instance, a Hangul character represented as a
                          a sequence of Jamos, or a Latin transliteration of
                          a Cyrillic word.
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-COVERAGE-APPROXIMATE:CAPS" role="constant">
<term><literal>PANGO_COVERAGE_APPROXIMATE</literal></term>
<listitem><simpara>The character is represented as basically the correct
                             graphical form, but with a stylistic variant inappropriate for
                             the current script.
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-COVERAGE-EXACT:CAPS" role="constant">
<term><literal>PANGO_COVERAGE_EXACT</literal></term>
<listitem><simpara>The character is represented as the correct graphical form.

</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-TYPE-COVERAGE-LEVEL:CAPS" role="macro">
<title>PANGO_TYPE_COVERAGE_LEVEL</title>
<indexterm zone="PANGO-TYPE-COVERAGE-LEVEL:CAPS"><primary>PANGO_TYPE_COVERAGE_LEVEL</primary></indexterm><programlisting>#define PANGO_TYPE_COVERAGE_LEVEL (pango_coverage_level_get_type())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoCoverageLevel"><type>PangoCoverageLevel</type></link>.
</para></refsect2>
<refsect2 id="PangoCoverage" role="struct">
<title>PangoCoverage</title>
<indexterm zone="PangoCoverage"><primary>PangoCoverage</primary></indexterm><programlisting>typedef struct _PangoCoverage PangoCoverage;</programlisting>
<para>
The <link linkend="PangoCoverage"><type>PangoCoverage</type></link> structure represents a map from Unicode characters
to <link linkend="PangoCoverageLevel"><type>PangoCoverageLevel</type></link>. It is an opaque structure with no public fields.
</para></refsect2>
<refsect2 id="pango-coverage-new" role="function">
<title>pango_coverage_new ()</title>
<indexterm zone="pango-coverage-new"><primary>pango_coverage_new</primary></indexterm><programlisting><link linkend="PangoCoverage">PangoCoverage</link>*      pango_coverage_new                  (void);</programlisting>
<para>
Create a new <link linkend="PangoCoverage"><type>PangoCoverage</type></link></para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoCoverage"><type>PangoCoverage</type></link>,
              initialized to <link linkend="PANGO-COVERAGE-NONE:CAPS"><literal>PANGO_COVERAGE_NONE</literal></link>
              with a reference count of one, which
              should be freed with <link linkend="pango-coverage-unref"><function>pango_coverage_unref()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-coverage-ref" role="function">
<title>pango_coverage_ref ()</title>
<indexterm zone="pango-coverage-ref"><primary>pango_coverage_ref</primary></indexterm><programlisting><link linkend="PangoCoverage">PangoCoverage</link>*      pango_coverage_ref                  (<link linkend="PangoCoverage">PangoCoverage</link> *coverage);</programlisting>
<para>
Increase the reference count on the <link linkend="PangoCoverage"><type>PangoCoverage</type></link> by one</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>coverage</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoCoverage"><type>PangoCoverage</type></link>