fonts.xml

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

<title>pango_font_description_get_style ()</title>
<indexterm zone="pango-font-description-get-style"><primary>pango_font_description_get_style</primary></indexterm><programlisting><link linkend="PangoStyle">PangoStyle</link>          pango_font_description_get_style    (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the style field of a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. See
<link linkend="pango-font-description-set-style"><function>pango_font_description_set_style()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the style field for the font description.
  Use <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-set-variant" role="function">
<title>pango_font_description_set_variant ()</title>
<indexterm zone="pango-font-description-set-variant"><primary>pango_font_description_set_variant</primary></indexterm><programlisting><link linkend="void">void</link>                pango_font_description_set_variant  (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                                         <link linkend="PangoVariant">PangoVariant</link> variant);</programlisting>
<para>
Sets the variant field of a font description. The <link linkend="PangoVariant"><type>PangoVariant</type></link>
can either be <link linkend="PANGO-VARIANT-NORMAL:CAPS"><literal>PANGO_VARIANT_NORMAL</literal></link> or <link linkend="PANGO-VARIANT-SMALL-CAPS:CAPS"><literal>PANGO_VARIANT_SMALL_CAPS</literal></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>variant</parameter>&nbsp;:</term>
<listitem><simpara> the variant type for the font description.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-get-variant" role="function">
<title>pango_font_description_get_variant ()</title>
<indexterm zone="pango-font-description-get-variant"><primary>pango_font_description_get_variant</primary></indexterm><programlisting><link linkend="PangoVariant">PangoVariant</link>        pango_font_description_get_variant  (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the variant field of a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>. See
<link linkend="pango-font-description-set-variant"><function>pango_font_description_set_variant()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the variant field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-set-weight" role="function">
<title>pango_font_description_set_weight ()</title>
<indexterm zone="pango-font-description-set-weight"><primary>pango_font_description_set_weight</primary></indexterm><programlisting><link linkend="void">void</link>                pango_font_description_set_weight   (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                                         <link linkend="PangoWeight">PangoWeight</link> weight);</programlisting>
<para>
Sets the weight field of a font description. The weight field
specifies how bold or light the font should be. In addition
to the values of the <link linkend="PangoWeight"><type>PangoWeight</type></link> enumeration, other intermediate
numeric values are possible.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>weight</parameter>&nbsp;:</term>
<listitem><simpara> the weight for the font description.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-get-weight" role="function">
<title>pango_font_description_get_weight ()</title>
<indexterm zone="pango-font-description-get-weight"><primary>pango_font_description_get_weight</primary></indexterm><programlisting><link linkend="PangoWeight">PangoWeight</link>         pango_font_description_get_weight   (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the weight field of a font description. See
<link linkend="pango-font-description-set-weight"><function>pango_font_description_set_weight()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the weight field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-set-stretch" role="function">
<title>pango_font_description_set_stretch ()</title>
<indexterm zone="pango-font-description-set-stretch"><primary>pango_font_description_set_stretch</primary></indexterm><programlisting><link linkend="void">void</link>                pango_font_description_set_stretch  (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                                         <link linkend="PangoStretch">PangoStretch</link> stretch);</programlisting>
<para>
Sets the stretch field of a font description. The stretch field
specifies how narrow or wide the font should be.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>stretch</parameter>&nbsp;:</term>
<listitem><simpara> the stretch for the font description
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-get-stretch" role="function">
<title>pango_font_description_get_stretch ()</title>
<indexterm zone="pango-font-description-get-stretch"><primary>pango_font_description_get_stretch</primary></indexterm><programlisting><link linkend="PangoStretch">PangoStretch</link>        pango_font_description_get_stretch  (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the stretch field of a font description.
See <link linkend="pango-font-description-set-stretch"><function>pango_font_description_set_stretch()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the stretch field for the font description. Use
  <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to find out if
  the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-set-size" role="function">
<title>pango_font_description_set_size ()</title>
<indexterm zone="pango-font-description-set-size"><primary>pango_font_description_set_size</primary></indexterm><programlisting><link linkend="void">void</link>                pango_font_description_set_size     (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                                         <link linkend="gint">gint</link> size);</programlisting>
<para>
Sets the size field of a font description in fractional points. This is mutually
exclusive with <link linkend="pango-font-description-set-absolute-size"><function>pango_font_description_set_absolute_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the size of the font in points, scaled by PANGO_SCALE. (That is,
       a <parameter>size</parameter> value of 10 * PANGO_SCALE is a 10 point font. The conversion
       factor between points and device units depends on system configuration
       and the output device. For screen display, a logical DPI of 96 is
       common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3
       pixel font. Use <link linkend="pango-font-description-set-absolute-size"><function>pango_font_description_set_absolute_size()</function></link> if you need
       a particular size in device units.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-get-size" role="function">
<title>pango_font_description_get_size ()</title>
<indexterm zone="pango-font-description-get-size"><primary>pango_font_description_get_size</primary></indexterm><programlisting><link linkend="gint">gint</link>                pango_font_description_get_size     (const <link linkend="PangoFontDescription">PangoFontDescription</link> *desc);</programlisting>
<para>
Gets the size field of a font description.
See <link linkend="pango-font-description-set-size"><function>pango_font_description_set_size()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the size field for the font description in points or device units.
  You must call <link linkend="pango-font-description-get-size-is-absolute"><function>pango_font_description_get_size_is_absolute()</function></link>
  to find out which is the case. Returns 0 if the size field has not
  previously been set or it has been set to 0 explicitly.
  Use <link linkend="pango-font-description-get-set-fields"><function>pango_font_description_get_set_fields()</function></link> to
  find out if the field was explicitly set or not.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-font-description-set-absolute-size" role="function" condition="since:1.8">
<title>pango_font_description_set_absolute_size ()</title>
<indexterm zone="pango-font-description-set-absolute-size" role="1.8"><primary>pango_font_description_set_absolute_size</primary></indexterm><programlisting><link linkend="void">void</link>                pango_font_description_set_absolute_size
                                                        (<link linkend="PangoFontDescription">PangoFontDescription</link> *desc,
                                                         <link linkend="double">double</link> size);</programlisting>
<para>
Sets the size field of a font description, in device units. This is mutually
exclusive with <link linkend="pango-font-description-set-size"><function>pango_font_description_set_size()</function></link> which sets the font size
in points.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>desc</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFontDescription"><type>PangoFontDescription</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>size</parameter>&nbsp;:</term>
<listitem><simpara> the new size, in Pango units. There are <link linken