scripts.xml

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

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

<refnamediv>
<refname>Scripts</refname>
<refpurpose>Identifying writing systems</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

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

<synopsis>
                    <link linkend="PangoScriptIter">PangoScriptIter</link>;
enum                <link linkend="PangoScript">PangoScript</link>;
#define             <link linkend="PANGO-TYPE-SCRIPT:CAPS">PANGO_TYPE_SCRIPT</link>
<link linkend="PangoScript">PangoScript</link>         <link linkend="pango-script-for-unichar">pango_script_for_unichar</link>            (<link linkend="gunichar">gunichar</link> ch);
<link linkend="PangoLanguage">PangoLanguage</link>*      <link linkend="pango-script-get-sample-language">pango_script_get_sample_language</link>    (<link linkend="PangoScript">PangoScript</link> script);
<link linkend="gboolean">gboolean</link>            <link linkend="pango-language-includes-script">pango_language_includes_script</link>      (<link linkend="PangoLanguage">PangoLanguage</link> *language,
                                                         <link linkend="PangoScript">PangoScript</link> script);
<link linkend="PangoScriptIter">PangoScriptIter</link>*    <link linkend="pango-script-iter-new">pango_script_iter_new</link>               (const <link linkend="char">char</link> *text,
                                                         <link linkend="int">int</link> length);
<link linkend="void">void</link>                <link linkend="pango-script-iter-get-range">pango_script_iter_get_range</link>         (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter,
                                                         G_CONST_RETURN <link linkend="char">char</link> **start,
                                                         G_CONST_RETURN <link linkend="char">char</link> **end,
                                                         <link linkend="PangoScript">PangoScript</link> *script);
<link linkend="gboolean">gboolean</link>            <link linkend="pango-script-iter-next">pango_script_iter_next</link>              (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter);
<link linkend="void">void</link>                <link linkend="pango-script-iter-free">pango_script_iter_free</link>              (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter);
</synopsis>
</refsynopsisdiv>









<refsect1 id="pango-Scripts.description" role="desc">
<title role="desc.title">Description</title>
<para>
The functions in this section are used to identify the writing
system, or <firstterm>script</firstterm> of individual characters
and of ranges within a larger text string.
</para>
</refsect1>

<refsect1 id="pango-Scripts.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PangoScriptIter" role="struct">
<title>PangoScriptIter</title>
<indexterm zone="PangoScriptIter"><primary>PangoScriptIter</primary></indexterm><programlisting>typedef struct _PangoScriptIter PangoScriptIter;</programlisting>
<para>
A <link linkend="PangoScriptIter"><type>PangoScriptIter</type></link> is used to iterate through a string
and identify ranges in different scripts.</para>
<para>

</para></refsect2>
<refsect2 id="PangoScript" role="enum">
<title>enum PangoScript</title>
<indexterm zone="PangoScript"><primary>PangoScript</primary></indexterm><programlisting>typedef enum {                         /* ISO 15924 code */
      PANGO_SCRIPT_INVALID_CODE = -1,
      PANGO_SCRIPT_COMMON       = 0,   /* Zyyy */
      PANGO_SCRIPT_INHERITED,          /* Qaai */
      PANGO_SCRIPT_ARABIC,             /* Arab */
      PANGO_SCRIPT_ARMENIAN,           /* Armn */
      PANGO_SCRIPT_BENGALI,            /* Beng */
      PANGO_SCRIPT_BOPOMOFO,           /* Bopo */
      PANGO_SCRIPT_CHEROKEE,           /* Cher */
      PANGO_SCRIPT_COPTIC,             /* Qaac */
      PANGO_SCRIPT_CYRILLIC,           /* Cyrl (Cyrs) */
      PANGO_SCRIPT_DESERET,            /* Dsrt */
      PANGO_SCRIPT_DEVANAGARI,         /* Deva */
      PANGO_SCRIPT_ETHIOPIC,           /* Ethi */
      PANGO_SCRIPT_GEORGIAN,           /* Geor (Geon, Geoa) */
      PANGO_SCRIPT_GOTHIC,             /* Goth */
      PANGO_SCRIPT_GREEK,              /* Grek */
      PANGO_SCRIPT_GUJARATI,           /* Gujr */
      PANGO_SCRIPT_GURMUKHI,           /* Guru */
      PANGO_SCRIPT_HAN,                /* Hani */
      PANGO_SCRIPT_HANGUL,             /* Hang */
      PANGO_SCRIPT_HEBREW,             /* Hebr */
      PANGO_SCRIPT_HIRAGANA,           /* Hira */
      PANGO_SCRIPT_KANNADA,            /* Knda */
      PANGO_SCRIPT_KATAKANA,           /* Kana */
      PANGO_SCRIPT_KHMER,              /* Khmr */
      PANGO_SCRIPT_LAO,                /* Laoo */
      PANGO_SCRIPT_LATIN,              /* Latn (Latf, Latg) */
      PANGO_SCRIPT_MALAYALAM,          /* Mlym */
      PANGO_SCRIPT_MONGOLIAN,          /* Mong */
      PANGO_SCRIPT_MYANMAR,            /* Mymr */
      PANGO_SCRIPT_OGHAM,              /* Ogam */
      PANGO_SCRIPT_OLD_ITALIC,         /* Ital */
      PANGO_SCRIPT_ORIYA,              /* Orya */
      PANGO_SCRIPT_RUNIC,              /* Runr */
      PANGO_SCRIPT_SINHALA,            /* Sinh */
      PANGO_SCRIPT_SYRIAC,             /* Syrc (Syrj, Syrn, Syre) */
      PANGO_SCRIPT_TAMIL,              /* Taml */
      PANGO_SCRIPT_TELUGU,             /* Telu */
      PANGO_SCRIPT_THAANA,             /* Thaa */
      PANGO_SCRIPT_THAI,               /* Thai */
      PANGO_SCRIPT_TIBETAN,            /* Tibt */
      PANGO_SCRIPT_CANADIAN_ABORIGINAL, /* Cans */
      PANGO_SCRIPT_YI,                 /* Yiii */
      PANGO_SCRIPT_TAGALOG,            /* Tglg */
      PANGO_SCRIPT_HANUNOO,            /* Hano */
      PANGO_SCRIPT_BUHID,              /* Buhd */
      PANGO_SCRIPT_TAGBANWA,           /* Tagb */

      /* Unicode-4.0 additions */
      PANGO_SCRIPT_BRAILLE,            /* Brai */
      PANGO_SCRIPT_CYPRIOT,            /* Cprt */
      PANGO_SCRIPT_LIMBU,              /* Limb */
      PANGO_SCRIPT_OSMANYA,            /* Osma */
      PANGO_SCRIPT_SHAVIAN,            /* Shaw */
      PANGO_SCRIPT_LINEAR_B,           /* Linb */
      PANGO_SCRIPT_TAI_LE,             /* Tale */
      PANGO_SCRIPT_UGARITIC,           /* Ugar */

      /* Unicode-4.1 additions */
      PANGO_SCRIPT_NEW_TAI_LUE,        /* Talu */
      PANGO_SCRIPT_BUGINESE,           /* Bugi */
      PANGO_SCRIPT_GLAGOLITIC,         /* Glag */
      PANGO_SCRIPT_TIFINAGH,           /* Tfng */
      PANGO_SCRIPT_SYLOTI_NAGRI,       /* Sylo */
      PANGO_SCRIPT_OLD_PERSIAN,        /* Xpeo */
      PANGO_SCRIPT_KHAROSHTHI,         /* Khar */

      /* Unicode-5.0 additions */
      PANGO_SCRIPT_UNKNOWN,            /* Zzzz */
      PANGO_SCRIPT_BALINESE,           /* Bali */
      PANGO_SCRIPT_CUNEIFORM,          /* Xsux */
      PANGO_SCRIPT_PHOENICIAN,         /* Phnx */
      PANGO_SCRIPT_PHAGS_PA,           /* Phag */
      PANGO_SCRIPT_NKO                 /* Nkoo */
} PangoScript;
</programlisting>
<para>
The <link linkend="PangoScript"><type>PangoScript</type></link> enumeration identifies different writing
systems. The values correspond to the names as defined in the
Unicode standard.
Note that new types may be added in the future. Applications should be ready
to handle unknown values.  This enumeration is interchangeable with
<link linkend="GUnicodeScript"><type>GUnicodeScript</type></link>.  See <ulink
url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex
<link linkend="24--:CAPS"><type>""</type></link> Script names</ulink>.
</para><variablelist role="enum">
<varlistentry id="PANGO-SCRIPT-INVALID-CODE:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_INVALID_CODE</literal></term>
<listitem><simpara>a value never returned from <link linkend="pango-script-for-unichar"><function>pango_script_for_unichar()</function></link>
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-COMMON:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_COMMON</literal></term>
<listitem><simpara>a character used by multiple different scripts
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-INHERITED:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_INHERITED</literal></term>
<listitem><simpara>a mark glyph that takes its script from the
  base glyph to which it is attached
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-ARABIC:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_ARABIC</literal></term>
<listitem><simpara>	Arabic
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-ARMENIAN:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_ARMENIAN</literal></term>
<listitem><simpara>Armenian
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-BENGALI:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_BENGALI</literal></term>
<listitem><simpara>	Bengali
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-BOPOMOFO:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_BOPOMOFO</literal></term>
<listitem><simpara>Bopomofo
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-CHEROKEE:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_CHEROKEE</literal></term>
<listitem><simpara>	Cherokee
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-COPTIC:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_COPTIC</literal></term>
<listitem><simpara>	Coptic
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-CYRILLIC:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_CYRILLIC</literal></term>
<listitem><simpara>	Cyrillic
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-DESERET:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_DESERET</literal></term>
<listitem><simpara>	Deseret
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-DEVANAGARI:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_DEVANAGARI</literal></term>
<listitem><simpara>	Devanagari
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-ETHIOPIC:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_ETHIOPIC</literal></term>
<listitem><simpara>	Ethiopic
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-GEORGIAN:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_GEORGIAN</literal></term>
<listitem><simpara>	Georgian
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-GOTHIC:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_GOTHIC</literal></term>
<listitem><simpara>	Gothic
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-SCRIPT-GREEK:CAPS" role="constant">
<term><literal>PANGO_SCRIPT_GREEK</literal></term>
<listitem><simpara>	Greek
</simpara></listitem>
</varlistentry>