scripts.xml

GTK+-2.0源码之pango-1.15.6.tar.gz

<refentry id="pango-Scripts">
<refmeta>
<refentrytitle id="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="synopsis">
<title id="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="desc">
<title id="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="details">
<title id="details.title">Details</title>
<refsect2>
<title><anchor id="PangoScriptIter" role="struct"/>PangoScriptIter</title>
<indexterm><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>
<title><anchor id="PangoScript" role="enum"/>enum PangoScript</title>
<indexterm><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.
See <ulink
url="http://www.unicode.org/reports/tr24/">Unicode Standard Annex
<link linkend="24--:CAPS"><type>24:</type></link> Script names</ulink>.
</para><variablelist role="enum">
<varlistentry>
<term><anchor id="PANGO-SCRIPT-INVALID-CODE:CAPS" role="constant"/><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>
<term><anchor id="PANGO-SCRIPT-COMMON:CAPS" role="constant"/><literal>PANGO_SCRIPT_COMMON</literal></term>
<listitem><simpara>a character used by multiple different scripts
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-INHERITED:CAPS" role="constant"/><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>
<term><anchor id="PANGO-SCRIPT-ARABIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_ARABIC</literal></term>
<listitem><simpara>	Arabic
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-ARMENIAN:CAPS" role="constant"/><literal>PANGO_SCRIPT_ARMENIAN</literal></term>
<listitem><simpara>Armenian
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-BENGALI:CAPS" role="constant"/><literal>PANGO_SCRIPT_BENGALI</literal></term>
<listitem><simpara>	Bengali
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-BOPOMOFO:CAPS" role="constant"/><literal>PANGO_SCRIPT_BOPOMOFO</literal></term>
<listitem><simpara>Bopomofo
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-CHEROKEE:CAPS" role="constant"/><literal>PANGO_SCRIPT_CHEROKEE</literal></term>
<listitem><simpara>	Cherokee
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-COPTIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_COPTIC</literal></term>
<listitem><simpara>	Coptic
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-CYRILLIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_CYRILLIC</literal></term>
<listitem><simpara>	Cyrillic
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-DESERET:CAPS" role="constant"/><literal>PANGO_SCRIPT_DESERET</literal></term>
<listitem><simpara>	Deseret
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-DEVANAGARI:CAPS" role="constant"/><literal>PANGO_SCRIPT_DEVANAGARI</literal></term>
<listitem><simpara>	Devanagari
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-ETHIOPIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_ETHIOPIC</literal></term>
<listitem><simpara>	Ethiopic
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><anchor id="PANGO-SCRIPT-GEORGIAN:CAPS" role="constant"/><literal>PANGO_SCRIPT_GEORGIAN</literal></term>
<listitem><simpara>	Georgian
</simpara></listitem>
</varlistentry>