main.xml

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

  guint8 level;
  guint8 gravity; /* PangoGravity */
  guint8 flags;

  guint8 script; /* PangoScript */
  PangoLanguage *language;

  GSList *extra_attrs;
} PangoAnalysis;
</programlisting>
<para>
The <link linkend="PangoAnalysis"><type>PangoAnalysis</type></link> structure stores information about
the properties of a segment of text. It has the following
fields:
</para><variablelist role="struct">
<varlistentry>
<term><link linkend="PangoEngineShape">PangoEngineShape</link>&nbsp;*<structfield>shape_engine</structfield>;</term>
<listitem><simpara>the engine for doing rendering-system-dependent processing.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="PangoEngineLang">PangoEngineLang</link>&nbsp;*<structfield>lang_engine</structfield>;</term>
<listitem><simpara>the engine for doing rendering-system-independent processing.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="PangoFont">PangoFont</link>&nbsp;*<structfield>font</structfield>;</term>
<listitem><simpara>the font for this segment.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="guint8">guint8</link>&nbsp;<structfield>level</structfield>;</term>
<listitem><simpara>the bidirectional level for this segment.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="guint8">guint8</link>&nbsp;<structfield>gravity</structfield>;</term>
<listitem><simpara>the glyph orientation for this segment (A <link linkend="PangoGravity"><type>PangoGravity</type></link>).
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="guint8">guint8</link>&nbsp;<structfield>flags</structfield>;</term>
<listitem><simpara>boolean flags for this segment (currently only one) (Since: 1.16).
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="guint8">guint8</link>&nbsp;<structfield>script</structfield>;</term>
<listitem><simpara>the detected script for this segment (A <link linkend="PangoScript"><type>PangoScript</type></link>) (Since: 1.18).
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="PangoLanguage">PangoLanguage</link>&nbsp;*<structfield>language</structfield>;</term>
<listitem><simpara>the detected language for this segment.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="GSList">GSList</link>&nbsp;*<structfield>extra_attrs</structfield>;</term>
<listitem><simpara>extra attributes for this segment.

</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-ANALYSIS-FLAG-CENTERED-BASELINE:CAPS" role="macro">
<title>PANGO_ANALYSIS_FLAG_CENTERED_BASELINE</title>
<indexterm zone="PANGO-ANALYSIS-FLAG-CENTERED-BASELINE:CAPS"><primary>PANGO_ANALYSIS_FLAG_CENTERED_BASELINE</primary></indexterm><programlisting>#define PANGO_ANALYSIS_FLAG_CENTERED_BASELINE (1 &lt;&lt; 0)
</programlisting>
<para>
Whether the segment should be shifted to center around the baseline.
Used in vertical writing directions mostly.

Since: 1.16
</para></refsect2>
<refsect2 id="PangoDirection" role="enum">
<title>enum PangoDirection</title>
<indexterm zone="PangoDirection"><primary>PangoDirection</primary></indexterm><programlisting>typedef enum {
  PANGO_DIRECTION_LTR,
  PANGO_DIRECTION_RTL,
  PANGO_DIRECTION_TTB_LTR,
  PANGO_DIRECTION_TTB_RTL,
  PANGO_DIRECTION_WEAK_LTR,
  PANGO_DIRECTION_WEAK_RTL,
  PANGO_DIRECTION_NEUTRAL
} PangoDirection;
</programlisting>
<para>
The <link linkend="PangoDirection"><type>PangoDirection</type></link> type represents a direction in the
Unicode bidirectional algorithm; not every value in this
enumeration makes sense for every usage of <link linkend="PangoDirection"><type>PangoDirection</type></link>;
for example, the return value of <link linkend="pango-unichar-direction"><function>pango_unichar_direction()</function></link>
and <link linkend="pango-find-base-dir"><function>pango_find_base_dir()</function></link> cannot be <link linkend="PANGO-DIRECTION-WEAK-LTR:CAPS"><literal>PANGO_DIRECTION_WEAK_LTR</literal></link>
or <link linkend="PANGO-DIRECTION-WEAK-RTL:CAPS"><literal>PANGO_DIRECTION_WEAK_RTL</literal></link>, since every character is either
neutral or has a strong direction; on the other hand
<link linkend="PANGO-DIRECTION-NEUTRAL:CAPS"><literal>PANGO_DIRECTION_NEUTRAL</literal></link> doesn't make sense to pass
to <link linkend="pango-itemize-with-base-dir"><function>pango_itemize_with_base_dir()</function></link>.
</para>
<para>
The <link linkend="PANGO-DIRECTION-TTB-LTR:CAPS"><literal>PANGO_DIRECTION_TTB_LTR</literal></link>, <link linkend="PANGO-DIRECTION-TTB-RTL:CAPS"><literal>PANGO_DIRECTION_TTB_RTL</literal></link>
values come from an earlier interpretation of this
enumeration as the writing direction of a block of
text and are no longer used; See <link linkend="PangoGravity"><type>PangoGravity</type></link> for how
vertical text is handled in Pango.</para>
<para>
</para><variablelist role="enum">
<varlistentry id="PANGO-DIRECTION-LTR:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_LTR</literal></term>
<listitem><simpara> A strong left-to-right direction
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-RTL:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_RTL</literal></term>
<listitem><simpara> A strong right-to-left direction
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-TTB-LTR:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_TTB_LTR</literal></term>
<listitem><simpara> Deprecated value; treated the
  same as <link linkend="PANGO-DIRECTION-RTL:CAPS"><literal>PANGO_DIRECTION_RTL</literal></link>.
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-TTB-RTL:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_TTB_RTL</literal></term>
<listitem><simpara> Deprecated value; treated the
  same as <link linkend="PANGO-DIRECTION-LTR:CAPS"><literal>PANGO_DIRECTION_LTR</literal></link>
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-WEAK-LTR:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_WEAK_LTR</literal></term>
<listitem><simpara> A weak left-to-right direction
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-WEAK-RTL:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_WEAK_RTL</literal></term>
<listitem><simpara> A weak right-to-left direction
</simpara></listitem>
</varlistentry>
<varlistentry id="PANGO-DIRECTION-NEUTRAL:CAPS" role="constant">
<term><literal>PANGO_DIRECTION_NEUTRAL</literal></term>
<listitem><simpara> No direction specified
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-TYPE-DIRECTION:CAPS" role="macro">
<title>PANGO_TYPE_DIRECTION</title>
<indexterm zone="PANGO-TYPE-DIRECTION:CAPS"><primary>PANGO_TYPE_DIRECTION</primary></indexterm><programlisting>#define PANGO_TYPE_DIRECTION (pango_direction_get_type())
</programlisting>
<para>
The <link linkend="GObject"><type>GObject</type></link> type for <link linkend="PangoDirection"><type>PangoDirection</type></link>.
</para></refsect2>
<refsect2 id="pango-itemize" role="function">
<title>pango_itemize ()</title>
<indexterm zone="pango-itemize"><primary>pango_itemize</primary></indexterm><programlisting><link linkend="GList">GList</link>*              pango_itemize                       (<link linkend="PangoContext">PangoContext</link> *context,
                                                         const <link linkend="char">char</link> *text,
                                                         <link linkend="int">int</link> start_index,
                                                         <link linkend="int">int</link> length,
                                                         <link linkend="PangoAttrList">PangoAttrList</link> *attrs,
                                                         <link linkend="PangoAttrIterator">PangoAttrIterator</link> *cached_iter);</programlisting>
<para>
Breaks a piece of text into segments with consistent
directional level and shaping engine. Each byte of <parameter>text</parameter> will
be contained in exactly one of the items in the returned list;
the generated list of items will be in logical order (the start
offsets of the items are ascending).
</para>
<para>
<parameter>cached_iter</parameter> should be an iterator over <parameter>attrs</parameter> currently positioned at a
range before or containing <parameter>start_index</parameter>; <parameter>cached_iter</parameter> will be advanced to
the range covering the position just after <parameter>start_index</parameter> + <parameter>length</parameter>.
(i.e. if itemizing in a loop, just keep passing in the same <parameter>cached_iter</parameter>).</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>context</parameter>&nbsp;:</term>
<listitem><simpara>   a structure holding information that affects
	       the itemization process.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>text</parameter>&nbsp;:</term>
<listitem><simpara>      the text to itemize.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>start_index</parameter>&nbsp;:</term>
<listitem><simpara> first byte in <parameter>text</parameter> to process
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>length</parameter>&nbsp;:</term>
<listitem><simpara>    the number of bytes (not characters) to process
            after <parameter>start_index</parameter>.
            This must be &gt;= 0.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>attrs</parameter>&nbsp;:</term>
<listitem><simpara>     the set of attributes that apply to <parameter>text</parameter>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cached_iter</parameter>&nbsp;:</term>
<listitem><simpara>      Cached attribute iterator, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GList"><type>GList</type></link> of <link linkend="PangoItem"><type>PangoItem</type></link> structures.