glyphs.xml

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

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 1.18


</para></refsect2>
<refsect2 id="pango-units-to-double" role="function" condition="since:1.16">
<title>pango_units_to_double ()</title>
<indexterm zone="pango-units-to-double" role="1.16"><primary>pango_units_to_double</primary></indexterm><programlisting><link linkend="double">double</link>              pango_units_to_double               (<link linkend="int">int</link> i);</programlisting>
<para>
Converts a number in Pango units to floating-point: divides
it by <link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>i</parameter>&nbsp;:</term>
<listitem><simpara> value in Pango units
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the double value.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.16
</para></refsect2>
<refsect2 id="pango-units-from-double" role="function" condition="since:1.16">
<title>pango_units_from_double ()</title>
<indexterm zone="pango-units-from-double" role="1.16"><primary>pango_units_from_double</primary></indexterm><programlisting><link linkend="int">int</link>                 pango_units_from_double             (<link linkend="double">double</link> d);</programlisting>
<para>
Converts a floating-point number to Pango units: multiplies
it by <link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link> and rounds to nearest integer.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>d</parameter>&nbsp;:</term>
<listitem><simpara> double floating-point value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the value in Pango units.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.16
</para></refsect2>
<refsect2 id="PangoRectangle" role="struct">
<title>PangoRectangle</title>
<indexterm zone="PangoRectangle"><primary>PangoRectangle</primary></indexterm><programlisting>typedef struct {
  int x;
  int y;
  int width;
  int height;
} PangoRectangle;
</programlisting>
<para>
The <link linkend="PangoRectangle"><type>PangoRectangle</type></link> structure represents a rectangle. It is frequently
used to represent the logical or ink extents of a single glyph or section
of text. (See, for instance, <link linkend="pango-font-get-glyph-extents"><function>pango_font_get_glyph_extents()</function></link>)
</para><variablelist role="struct">
<varlistentry>
<term><link linkend="int">int</link>&nbsp;<structfield>x</structfield>;</term>
<listitem><simpara>X coordinate of the left side of the rectangle.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="int">int</link>&nbsp;<structfield>y</structfield>;</term>
<listitem><simpara>Y coordinate of the the top side of the rectangle.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="int">int</link>&nbsp;<structfield>width</structfield>;</term>
<listitem><simpara>width of the rectangle.
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="int">int</link>&nbsp;<structfield>height</structfield>;</term>
<listitem><simpara>height of the rectangle.

</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-ASCENT:CAPS" role="macro">
<title>PANGO_ASCENT()</title>
<indexterm zone="PANGO-ASCENT:CAPS"><primary>PANGO_ASCENT</primary></indexterm><programlisting>#define PANGO_ASCENT(rect) (-(rect).y)
</programlisting>
<para>
Extracts the <firstterm>ascent</firstterm> from a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>
representing glyph extents. The ascent is the distance from the
baseline to the highest point of the character. This is positive if the
glyph ascends above the baseline.
</para><variablelist role="params">
<varlistentry><term><parameter>rect</parameter>&nbsp;:</term>
<listitem><simpara>a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-DESCENT:CAPS" role="macro">
<title>PANGO_DESCENT()</title>
<indexterm zone="PANGO-DESCENT:CAPS"><primary>PANGO_DESCENT</primary></indexterm><programlisting>#define PANGO_DESCENT(rect) ((rect).y + (rect).height)
</programlisting>
<para>
Extracts the <firstterm>descent</firstterm> from a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>
representing glyph extents. The descent is the distance from the
baseline to the lowest point of the character. This is positive if the
glyph descends below the baseline.
</para><variablelist role="params">
<varlistentry><term><parameter>rect</parameter>&nbsp;:</term>
<listitem><simpara>a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-LBEARING:CAPS" role="macro">
<title>PANGO_LBEARING()</title>
<indexterm zone="PANGO-LBEARING:CAPS"><primary>PANGO_LBEARING</primary></indexterm><programlisting>#define PANGO_LBEARING(rect) ((rect).x)
</programlisting>
<para>
Extracts the <firstterm>left bearing</firstterm> from a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>
representing glyph extents. The left bearing is the distance from the
horizontal origin to the farthest left point of the character.
This is positive for characters drawn completely to the right of the
glyph origin.
</para><variablelist role="params">
<varlistentry><term><parameter>rect</parameter>&nbsp;:</term>
<listitem><simpara>a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="PANGO-RBEARING:CAPS" role="macro">
<title>PANGO_RBEARING()</title>
<indexterm zone="PANGO-RBEARING:CAPS"><primary>PANGO_RBEARING</primary></indexterm><programlisting>#define PANGO_RBEARING(rect) ((rect).x + (rect).width)
</programlisting>
<para>
Extracts the <firstterm>right bearing</firstterm> from a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>
representing glyph extents. The right bearing is the distance from the
horizontal origin to the farthest right point of the character.
This is positive except for characters drawn completely to the left of the
horizontal origin.
</para><variablelist role="params">
<varlistentry><term><parameter>rect</parameter>&nbsp;:</term>
<listitem><simpara>a <link linkend="PangoRectangle"><type>PangoRectangle</type></link>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pango-extents-to-pixels" role="function" condition="since:1.16">
<title>pango_extents_to_pixels ()</title>
<indexterm zone="pango-extents-to-pixels" role="1.16"><primary>pango_extents_to_pixels</primary></indexterm><programlisting><link linkend="void">void</link>                pango_extents_to_pixels             (<link linkend="PangoRectangle">PangoRectangle</link> *inclusive,
                                                         <link linkend="PangoRectangle">PangoRectangle</link> *nearest);</programlisting>
<para>
Converts extents from Pango units to device units, dividing by the
<link linkend="PANGO-SCALE:CAPS"><literal>PANGO_SCALE</literal></link> factor and performing rounding.
</para>
<para>
The <parameter>inclusive</parameter> rectangle is converted by flooring the x/y coordinates and extending
width/height, such that the final rectangle completely includes the original
rectangle.
</para>
<para>
The <parameter>nearest</parameter> rectangle is converted by rounding the coordinates
of the rectangle to the nearest device unit (pixel).
</para>
<para>
The rule to which argument to use is: if you want the resulting device-space
rectangle to completely contain the original rectangle, pass it in as <parameter>inclusive</parameter>.
If you want two touching-but-not-overlapping rectangles stay
touching-but-not-overlapping after rounding to device units, pass them in
as <parameter>nearest</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>inclusive</parameter>&nbsp;:</term>
<listitem><simpara> rectangle to round to pixels inclusively, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>nearest</parameter>&nbsp;:</term>
<listitem><simpara> rectangle to round to nearest pixels, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.16
</para></refsect2>
<refsect2 id="PangoMatrix" role="struct" condition="since:1.6">
<title>PangoMatrix</title>
<indexterm zone="PangoMatrix" role="1.6"><primary>PangoMatrix</primary></indexterm><programlisting>typedef struct {
  double xx;
  double xy;
  double yx;
  double yy;
  double x0;
  double y0;
} PangoMatrix;
</programlisting>
<para>
A structure specifying a transformation between user-space
coordinates and device coordinates. The transformation
is given by
</para>
<para>
<programlisting>
x_device = x_user * matrix->xx + y_user * matrix->xy + matrix->x0;
y_device = x_user * matrix->yx + y_user * matrix->yy + matrix->y0;
</programlisting></para>
<para>

</para><variablelist role="struct">
<varlistentry>
<term><link linkend="double">double</link>&nbsp;<structfield>xx</structfield>;</term>
<listitem><simpara> 1st component of the transformation matrix
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="double">double</link>&nbsp;<structfield>xy</structfield>;</term>
<listitem><simpara> 2nd component of the transformation matrix
</simpara></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="double">double</link>&nbsp;<structfield>yx</structfield>;</term>
<listitem><simpara> 3rd component of the transformation matrix
</simpara></listitem>
</varlistentry>
<varlistentry>