~ubuntu-branches/ubuntu/karmic/pango1.0/karmic-security

« back to all changes in this revision

Viewing changes to docs/xml/pangocairo.xml

  • Committer: Bazaar Package Importer
  • Author(s): Loic Minier
  • Date: 2007-12-18 21:11:37 UTC
  • mfrom: (1.2.44 upstream)
  • Revision ID: james.westby@ubuntu.com-20071218211137-0ibmwreimvxf3cp1
Tags: 1.19.2-1ubuntu1
* Sync with Debian; Ubuntu changes are:
  - Add patch 30_anymetrics, turns on FC_ANY_METRICS whenever looking up
    fonts with fontconfig; lets fontconfig's configuration know that we
    don't care about getting a font with exactly the same shape as the
    family we asked for and fixes (eg) a firefox vs. evince font metrics
    ugliness issue.

Show diffs side-by-side

added added

removed removed

Lines of Context:
270
270
<title><anchor id="pango-cairo-font-map-get-default" role="function" condition="since:1.10"/>pango_cairo_font_map_get_default ()</title>
271
271
<indexterm role="1.10"><primary>pango_cairo_font_map_get_default</primary></indexterm><programlisting><link linkend="PangoFontMap">PangoFontMap</link>*       pango_cairo_font_map_get_default    (void);</programlisting>
272
272
<para>
273
 
Gets a default font map to use with Cairo.</para>
 
273
Gets a default <link linkend="PangoCairoFontMap"><type>PangoCairoFontMap</type></link> to use with Cairo.
 
274
</para>
 
275
<para>
 
276
Note that the type of the returned object will depend
 
277
on the particular font backend Cairo was compiled to use;
 
278
You generally should only use the <link linkend="PangoFontMap"><type>PangoFontMap</type></link> and
 
279
<link linkend="PangoCairoFontMap"><type>PangoCairoFontMap</type></link> interfaces on the returned object.</para>
274
280
<para>
275
281
 
276
282
</para><variablelist role="params">
325
331
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the newly allocated <link linkend="PangoFontMap"><type>PangoFontMap</type></link> of suitable type
326
332
              which should be freed with <link linkend="g-object-unref"><function>g_object_unref()</function></link>,
327
333
              or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the requested cairo font backend is
328
 
              not supported.
 
334
              not supported / compiled in.
329
335
 
330
336
</simpara></listitem></varlistentry>
331
337
</variablelist><para role="since">Since  1.18
412
418
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
413
419
<listitem><simpara> a <link linkend="PangoFont"><type>PangoFont</type></link> from a <link linkend="PangoCairoFontMap"><type>PangoCairoFontMap</type></link>
414
420
</simpara></listitem></varlistentry>
415
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="cairo-scaled-font-t"><type>cairo_scaled_font_t</type></link> used by <parameter>font</parameter>
 
421
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="cairo-scaled-font-t"><type>cairo_scaled_font_t</type></link> used by <parameter>font</parameter>,
 
422
              or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if <parameter>font</parameter> is <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
416
423
 
417
424
</simpara></listitem></varlistentry>
418
425
</variablelist><para role="since">Since  1.18