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>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT PangoContext ##### -->
<para>
The #PangoContext structure stores global information
used to control the itemization process. 
</para>


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

@offset: the offset of the segment from the beginning of the
         string in bytes.
@length: the length of the segment in bytes.
@num_chars: the length of the segment in characters.
@analysis: the properties of the segment.

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

@shape_engine: the engine for doing rendering-system-dependent processing.
@lang_engine: the engine for doing rendering-system-independent processing.
@font: 
@level: the bidrectional level for this segment.
@language: 
@extra_attrs: 

<!-- ##### ENUM PangoDirection ##### -->
<para>
</para>

@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: 

<!-- ##### MACRO PANGO_TYPE_DIRECTION ##### -->
<para>
The GObject type for #PangoDirection.
</para>



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

</para>

@context: 
@text: 
@start_index: 
@length: 
@attrs: 
@cached_iter: 
@Returns: 


<!-- ##### FUNCTION pango_itemize_with_base_dir ##### -->
<para>

</para>

@context: 
@base_dir: 
@text: 
@start_index: 
@length: 
@attrs: 
@cached_iter: 
@Returns: 


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

</para>

@item: 


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

</para>

@item: 
@Returns: 


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

</para>

@Returns: 


<!-- ##### FUNCTION pango_item_split ##### -->
<para>

</para>

@orig: 
@split_index: 
@split_offset: 
@Returns: 


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

</para>

@logical_items: 
@Returns: 


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

</para>

@Returns: 


<!-- ##### FUNCTION pango_context_set_font_map ##### -->
<para>

</para>

@context: 
@font_map: 


<!-- ##### FUNCTION pango_context_get_font_map ##### -->
<para>

</para>

@context: 
@Returns: 


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

</para>

@context: 
@Returns: 


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

</para>

@context: 
@desc: 


<!-- ##### FUNCTION pango_context_get_language ##### -->
<para>

</para>

@context: 
@Returns: 


<!-- ##### FUNCTION pango_context_set_language ##### -->
<para>

</para>

@context: 
@language: 


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

</para>

@context: 
@Returns: 


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

</para>

@context: 
@direction: 


<!-- ##### FUNCTION pango_context_get_matrix ##### -->
<para>

</para>

@context: 
@Returns: 


<!-- ##### FUNCTION pango_context_set_matrix ##### -->
<para>

</para>

@context: 
@matrix: 


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

</para>

@context: 
@desc: 
@Returns: 


<!-- ##### FUNCTION pango_context_load_fontset ##### -->
<para>

</para>

@context: 
@desc: 
@language: 
@Returns: 


<!-- ##### FUNCTION pango_context_get_metrics ##### -->
<para>

</para>

@context: 
@desc: 
@language: 
@Returns: 


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

</para>

@context: 
@families: 
@n_families: 


<!-- ##### FUNCTION pango_get_mirror_char ##### -->
<para>

</para>

@ch: 
@mirrored_ch: 
@Returns: 


<!-- ##### FUNCTION pango_unichar_direction ##### -->
<para>
Determines the direction of a character; either
%PANGO_DIRECTION_LTR, %PANGO_DIRECTION_LTR, or
%PANGO_DIRECTION_NEUTRAL.
</para>

@ch: character to examine
@Returns:  the direction of a character, as used in the
  Unicode bidirectional algorithm.


<!-- ##### FUNCTION pango_find_base_dir ##### -->
<para>

</para>

@text: 
@length: 
@Returns: 


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

</para>

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


<!-- ##### FUNCTION pango_get_log_attrs ##### -->
<para>

</para>

@text: 
@length: 
@level: 
@language: 
@log_attrs: 
@attrs_len: 


<!-- ##### FUNCTION pango_find_paragraph_boundary ##### -->
<para>

</para>

@text: 
@length: 
@paragraph_delimiter_index: 
@next_paragraph_start: 


<!-- ##### FUNCTION pango_default_break ##### -->
<para>

</para>

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


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

@is_line_break: 
@is_mandatory_break: 
@is_char_break: 
@is_white: 
@is_cursor_position: 
@is_word_start: 
@is_word_end: 
@is_sentence_boundary: 
@is_sentence_start: 
@is_sentence_end: 
@backspace_deletes_character: If set, backspace deletes one character
                              rather than the entire grapheme cluster. This
                              field is only meaningful on grapheme
                              boundaries (where @is_cursor_position is
                              set).  In some languages, the full grapheme
                              (e.g.  letter + diacritics) is considered a
                              unit, while in others, each decomposed
                              character in the grapheme is a unit. In the
                              default implementation of #pango_break, this
                              bit is set on all grapheme boundaries except
                              those following Latin, Cyrillic or Greek base
                              characters.

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

</para>

@text: 
@length: 
@analysis: 
@glyphs: