path: root/docs/tmpl/main.sgml

<!-- ##### SECTION Title ##### -->
Rendering

<!-- ##### SECTION Short_Description ##### -->
Functions to run the rendering pipeline.

<!-- ##### SECTION Long_Description ##### -->
<para>
The Pango rendering pipeline takes a string of
Unicode characters and converts it into glyphs.
The functions described in this section accomplish
various steps of this process.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### STRUCT PangoContext ##### -->
<para>
The #PangoContext structure stores global information
used to control the itemization process. It contains
the following fields:

<informaltable pgwide=1 frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>

<row>
<entry>gchar *lang;</entry>
<entry>the global default language in the standard form
       "fr" or "fr_FR". (This may be overriden
       with the @lang_info parameter to pango_itemize().)</entry>
</row>

<row>
<entry>gchar *render_type;</entry>
<entry>a string identifier for the rendering system to use,
       for instance %PANGO_RENDER_TYPE_X</entry>
</row>

</tbody></tgroup></informaltable>
</para>


<!-- ##### STRUCT PangoItem ##### -->
<para>
The #PangoItem structure stores information about
a segment of text. It contains the following fields:

<informaltable pgwide=1 frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>

<row>
<entry>gint offset;</entry>
<entry>the offset of the segment from the beginning of the
       string in bytes.</entry>
</row>

<row>
<entry>gint length;</entry>
<entry>the length of the segment in bytes.</entry>
</row>

<row>
<entry>gint num_chars;</entry>
<entry>the length of the segment in characters.</entry>
</row>

<row>
<entry>gint analysis;</entry>
<entry>the properties of the segment.</entry>
</row>

</tbody></tgroup></informaltable>
</para>

@offset: 
@length: 
@num_chars: 
@extra_attrs: 
@analysis: 

<!-- ##### STRUCT PangoAnalysis ##### -->
<para>
The #PangoAnalysis structure stores information about
the properties of a segment of text. It has the following
fields:

<informaltable pgwide=1 frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>

<row>
<entry>#PangoEngineShape *shape_engine;</entry>
<entry>the engine for doing rendering-system-dependent processing</entry>
</row>

<row>
<entry>#PangoEngineLang *lang_engine;</entry>
<entry>the engine for doing rendering-system-independent processing</entry>
</row>

<row>
<entry>guint8 level;</entry>
<entry>the bidrectional level for this segment.</entry>
</row>

</tbody></tgroup></informaltable>
</para>

@shape_engine: 
@lang_engine: 
@font: 
@level: 

<!-- ##### STRUCT PangoLangRange ##### -->
<para>
The #PangoLangRange structure stores language tagging
information for a range of character positions of text. 
It contains the following fields:

<informaltable pgwide=1 frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
<tbody>

<row>
<entry>gint start;</entry>
<entry>the start position of this tagged range in bytes.</entry>
</row>

<row>
<entry>gint length;</entry>
<entry>the length of this tagged range in bytes.</entry>
</row>

<row>
<entry>gchar *lang;</entry> 
<entry>the language for this range, in the standard form 
       "fr" or "fr_FR".</entry>
</row>

</tbody></tgroup></informaltable>
</para>

@start: 
@length: 
@lang: 

<!-- ##### ENUM PangoDirection ##### -->
<para>
The #PangoDirection type represents the direction of writing
for text.
</para>

@PANGO_DIRECTION_LTR: The text is written left-to-right
@PANGO_DIRECTION_RTL: The text is written right-to-left
@PANGO_DIRECTION_TTB_LTR: The text is written vertically
                          top-to-bottom, with the rows ordered from
                          left to right.
@PANGO_DIRECTION_TTB_RTL: The text is written vertically
                          top-to-bottom, with the rows ordered from
                          right to left.

<!-- ##### FUNCTION pango_itemize ##### -->
<para>

</para>

@context: 
@text: 
@length: 
@attrs: 
@Returns: 
<!-- # Unused Parameters # -->
@lang_info: 
@n_langs: 


<!-- ##### FUNCTION pango_item_free ##### -->
<para>

</para>

@item: 


<!-- ##### FUNCTION pango_item_copy ##### -->
<para>

</para>

@item: 
@Returns: 


<!-- ##### FUNCTION pango_item_new ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION pango_reorder_items ##### -->
<para>

</para>

@logical_items: 
@Returns: 


<!-- ##### FUNCTION pango_context_new ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION pango_context_add_font_map ##### -->
<para>

</para>

@context: 
@font_map: 


<!-- ##### FUNCTION pango_context_get_font_description ##### -->
<para>

</para>

@context: 
@Returns: 


<!-- ##### FUNCTION pango_context_set_font_description ##### -->
<para>

</para>

@context: 
@desc: 


<!-- ##### FUNCTION pango_context_get_base_dir ##### -->
<para>

</para>

@context: 
@Returns: 


<!-- ##### FUNCTION pango_context_set_base_dir ##### -->
<para>

</para>

@context: 
@direction: 


<!-- ##### FUNCTION pango_context_get_lang ##### -->
<para>

</para>

@context: 
@Returns: 


<!-- ##### FUNCTION pango_context_set_lang ##### -->
<para>

</para>

@context: 
@lang: 


<!-- ##### FUNCTION pango_context_load_font ##### -->
<para>

</para>

@context: 
@desc: 
@Returns: 
<!-- # Unused Parameters # -->
@size: 


<!-- ##### FUNCTION pango_context_list_families ##### -->
<para>

</para>

@context: 
@families: 
@n_families: 


<!-- ##### FUNCTION pango_context_list_fonts ##### -->
<para>

</para>

@context: 
@family: 
@descs: 
@n_descs: 


<!-- ##### FUNCTION pango_break ##### -->
<para>

</para>

@text: 
@length: 
@analysis: 
@attrs: 


<!-- ##### STRUCT PangoLogAttr ##### -->
<para>
The #PangoLogAttr structure stores information
about the attributes of a single character.
</para>

@is_break: 
@is_white: 
@is_char_stop: 
@is_word_stop: 

<!-- ##### FUNCTION pango_shape ##### -->
<para>

</para>

@text: 
@length: 
@analysis: 
@glyphs: 
<!-- # Unused Parameters # -->
@font: 


<!-- ##### FUNCTION pango_justify ##### -->
<para>

</para>

@glyphs: 
@new_line_width: 
@min_kashida_width: