path: root/docs/tmpl/fonts.sgml

<!-- ##### SECTION Title ##### -->
Fonts

<!-- ##### SECTION Short_Description ##### -->
Structures representing abstract fonts.

<!-- ##### SECTION Long_Description ##### -->
<para>
Pango supports a flexible architecture where a
particular rendering architecture can supply an
implementation of fonts. The #PangoFont structure
representn an abstract rendering-system-indepent font.
Pango provides routines to list available fonts, and
to load a font of a given description.
</para>

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

</para>

<!-- ##### STRUCT PangoFontDescription ##### -->
<para>
The #PangoFontDescription structure represents the description
of an ideal font. These structures are used both to list
what fonts are available on the system and also for specifying
the characteristics of a font to load.
</para>

@family_name: the name of the font family.
@style: the style (slant) of the font.
@variant: the variant (normal or small caps) of the font.
@weight: the weight (boldness) of the font.
@stretch: the relative width of the font.

<!-- ##### ENUM PangoStyle ##### -->
<para>
An enumeration specifying the various slant styles possible for a font.
</para>

@PANGO_STYLE_NORMAL: the font is upright.
@PANGO_STYLE_OBLIQUE: the font is slanted, but in a roman style.
@PANGO_STYLE_ITALIC: the font is slanted in an italic style.

<!-- ##### ENUM PangoWeight ##### -->
<para>
An enumeration specifying the weight (boldness) of a font. This is a numerical
value ranging from 100 to 900, but there are two predefined values:
</para>

@PANGO_WEIGHT_NORMAL: the default weight (= 400)
@PANGO_WEIGHT_BOLD: the bold weight (= 700)

<!-- ##### ENUM PangoVariant ##### -->
<para>
An enumeration specifying capitalization variant of the font.
</para>

@PANGO_VARIANT_NORMAL: A normal font.
@PANGO_VARIANT_SMALL_CAPS: A font with the lower case characters
  replaced by smaller variants of the capital characters.

<!-- ##### ENUM PangoStretch ##### -->
<para>
An enumeration specifying the width of the font relative to other designs
within a family.
</para>

@PANGO_STRETCH_ULTRA_CONDENSED: 
@PANGO_STRETCH_EXTRA_CONDENSED: 
@PANGO_STRETCH_CONDENSED: 
@PANGO_STRETCH_SEMI_CONDENSED: 
@PANGO_STRETCH_NORMAL: the normal width
@PANGO_STRETCH_SEMI_EXPANDED: 
@PANGO_STRETCH_EXPANDED: 
@PANGO_STRETCH_EXTRA_EXPANDED: 
@PANGO_STRETCH_ULTRA_EXPANDED: 

<!-- ##### FUNCTION pango_font_description_copy ##### -->
<para>

</para>

@desc: 
@Returns: 


<!-- ##### FUNCTION pango_font_description_compare ##### -->
<para>

</para>

@desc1: 
@desc2: 
@Returns: 


<!-- ##### FUNCTION pango_font_descriptions_free ##### -->
<para>

</para>

@descs: 
@n_descs: 


<!-- ##### FUNCTION pango_font_description_free ##### -->
<para>

</para>

@desc: 


<!-- ##### STRUCT PangoFont ##### -->
<para>
The #PangoFont structure is used to represent
a font in a rendering-system-independent matter.
To create an implementation of a #PangoFont,
the rendering-system specific code should malloc
a larger structure that contains a nested
#PangoFont, fill in the klass member of
the nested #PangoFont with a pointer to
a appropriate #PangoFontClass, then call
pango_font_init() on the structure.
</para>
<para>
The #PangoFont structure contains one member
which the implementation fills in:
</para>

@klass: a pointer to the <firstterm>class structure</firstterm>
        for this font. People using a #PangoFont should
        not directly access this member; they should use the
        appropriate wrapper functions.

<!-- ##### STRUCT PangoFontClass ##### -->
<para>
The PangoFontClass structure contains the virtual
functions for an implementation of a a PangoFont.

It contains the following member:

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

<row>
<entry>void (*destroy) (#PangoFont *font);</entry>
<entry>a function to free the font structure and associated resources.</entry>
</row>
</tbody></tgroup></informaltable>
</para>

@destroy: a function to free the font structure and associated resources.
@describe: a function to describe the characteristics of a font. See
           pango_font_describe().
@get_coverage: A function to get a coverage map for the font.
               See pango_font_get_coverage().
@find_shaper: A function to find the shaper for a particular character 
              point. See pango_font_find_shaper.

<!-- ##### FUNCTION pango_font_init ##### -->
<para>

</para>

@font: 


<!-- ##### FUNCTION pango_font_ref ##### -->
<para>

</para>

@font: 


<!-- ##### FUNCTION pango_font_unref ##### -->
<para>

</para>

@font: 


<!-- ##### FUNCTION pango_font_find_shaper ##### -->
<para>

</para>

@font: 
@lang: 
@ch: 
@Returns: 
<!-- # Unused Parameters # -->
@char: 


<!-- ##### FUNCTION pango_font_describe ##### -->
<para>

</para>

@font: 
@Returns: 


<!-- ##### FUNCTION pango_font_get_coverage ##### -->
<para>

</para>

@font: 
@lang: 
@Returns: 


<!-- ##### FUNCTION pango_font_get_data ##### -->
<para>

</para>

@font: 
@key: 
@Returns: 


<!-- ##### FUNCTION pango_font_set_data ##### -->
<para>

</para>

@font: 
@key: 
@data: 
@destroy_func: 


<!-- ##### STRUCT PangoFontMap ##### -->
<para>
The #PangoFontMap represents the set of fonts available for a
particular rendering system. This is a virtual object with
implementations being specific to particular rendering systems.  To
create an implementation of a #PangoFontMap, the rendering-system
specific code should malloc a larger structure that contains a nested
#PangoFontMap, fill in the klass member of the nested #PangoFontMap with a
pointer to a appropriate #PangoFontMapClass, then call
pango_font_map_init() on the structure.
</para>
<para>
The #PangoFont structure contains one member which the implementation fills in:
</para>

@klass: a pointer to the <firstterm>class structure</firstterm>
        for this font map. People using a #PangoFontMap should
        not directly access this member; they should use the
        appropriate wrapper functions.

<!-- ##### STRUCT PangoFontMapClass ##### -->
<para>
The #PangoFontMapClass structure holds the virtual functions for
a particular #PangoFontMap implementation.
</para>

@destroy: a function to free the font map structure and associated resources.
@load_font: a function to load a font with a given description. See
            pango_font_map_load_font()
@list_fonts: A function to list available fonts. See pango_font_map_list_fonts()
@list_families: 

<!-- ##### FUNCTION pango_font_map_init ##### -->
<para>

</para>

@fontmap: 


<!-- ##### FUNCTION pango_font_map_ref ##### -->
<para>

</para>

@fontmap: 


<!-- ##### FUNCTION pango_font_map_unref ##### -->
<para>

</para>

@fontmap: 


<!-- ##### FUNCTION pango_font_map_load_font ##### -->
<para>

</para>

@fontmap: 
@desc: 
@size: 
@Returns: 


<!-- ##### FUNCTION pango_font_map_list_families ##### -->
<para>

</para>

@fontmap: 
@families: 
@n_families: 


<!-- ##### FUNCTION pango_font_map_free_families ##### -->
<para>

</para>

@families: 
@n_families: 


<!-- ##### FUNCTION pango_font_map_list_fonts ##### -->
<para>

</para>

@fontmap: 
@family: 
@descs: 
@n_descs: