pangofc-font.xml

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

of <link linkend="PangoEngineInfo"><type>PangoEngineInfo</type></link>.</para>
<para>

</para></refsect2>
<refsect2 id="pango-fc-font-lock-face" role="function" condition="since:1.4">
<title>pango_fc_font_lock_face ()</title>
<indexterm zone="pango-fc-font-lock-face" role="1.4"><primary>pango_fc_font_lock_face</primary></indexterm><programlisting><link linkend="FT-Face">FT_Face</link>             pango_fc_font_lock_face             (<link linkend="PangoFcFont">PangoFcFont</link> *font);</programlisting>
<para>
Gets the FreeType <type>FT_Face</type> associated with a font,
This face will be kept around until you call
<link linkend="pango-fc-font-unlock-face"><function>pango_fc_font_unlock_face()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the FreeType <type>FT_Face</type> associated with <parameter>font</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>
<refsect2 id="pango-fc-font-unlock-face" role="function" condition="since:1.4">
<title>pango_fc_font_unlock_face ()</title>
<indexterm zone="pango-fc-font-unlock-face" role="1.4"><primary>pango_fc_font_unlock_face</primary></indexterm><programlisting><link linkend="void">void</link>                pango_fc_font_unlock_face           (<link linkend="PangoFcFont">PangoFcFont</link> *font);</programlisting>
<para>
Releases a font previously obtained with
<link linkend="pango-fc-font-lock-face"><function>pango_fc_font_lock_face()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>
<refsect2 id="pango-fc-font-has-char" role="function" condition="since:1.4">
<title>pango_fc_font_has_char ()</title>
<indexterm zone="pango-fc-font-has-char" role="1.4"><primary>pango_fc_font_has_char</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pango_fc_font_has_char              (<link linkend="PangoFcFont">PangoFcFont</link> *font,
                                                         <link linkend="gunichar">gunichar</link> wc);</programlisting>
<para>
Determines whether <parameter>font</parameter> has a glyph for the codepoint <parameter>wc</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> Unicode codepoint to look up
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>font</parameter> has the requested codepoint.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>
<refsect2 id="pango-fc-font-get-glyph" role="function" condition="since:1.4">
<title>pango_fc_font_get_glyph ()</title>
<indexterm zone="pango-fc-font-get-glyph" role="1.4"><primary>pango_fc_font_get_glyph</primary></indexterm><programlisting><link linkend="guint">guint</link>               pango_fc_font_get_glyph             (<link linkend="PangoFcFont">PangoFcFont</link> *font,
                                                         <link linkend="gunichar">gunichar</link> wc);</programlisting>
<para>
Gets the glyph index for a given Unicode character
for <parameter>font</parameter>. If you only want to determine
whether the font has the glyph, use <link linkend="pango-fc-font-has-char"><function>pango_fc_font_has_char()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> Unicode character to look up
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the glyph index, or 0, if the Unicode
  character doesn't exist in the font.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>
<refsect2 id="pango-fc-font-get-unknown-glyph" role="function" condition="deprecated:|since:1.4">
<title>pango_fc_font_get_unknown_glyph ()</title>
<indexterm zone="pango-fc-font-get-unknown-glyph" role="deprecated"><primary>pango_fc_font_get_unknown_glyph</primary></indexterm><indexterm zone="pango-fc-font-get-unknown-glyph" role="1.4"><primary>pango_fc_font_get_unknown_glyph</primary></indexterm><programlisting><link linkend="PangoGlyph">PangoGlyph</link>          pango_fc_font_get_unknown_glyph     (<link linkend="PangoFcFont">PangoFcFont</link> *font,
                                                         <link linkend="gunichar">gunichar</link> wc);</programlisting>
<warning><para><literal>pango_fc_font_get_unknown_glyph</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Returns the index of a glyph suitable for drawing <parameter>wc</parameter> as an
unknown character.
</para>
<para>
Use <link linkend="PANGO-GET-UNKNOWN-GLYPH:CAPS"><function>PANGO_GET_UNKNOWN_GLYPH()</function></link> instead.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>wc</parameter>&nbsp;:</term>
<listitem><simpara> the Unicode character for which a glyph is needed.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a glyph index into <parameter>font</parameter>.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>
<refsect2 id="pango-fc-font-kern-glyphs" role="function" condition="since:1.4">
<title>pango_fc_font_kern_glyphs ()</title>
<indexterm zone="pango-fc-font-kern-glyphs" role="1.4"><primary>pango_fc_font_kern_glyphs</primary></indexterm><programlisting><link linkend="void">void</link>                pango_fc_font_kern_glyphs           (<link linkend="PangoFcFont">PangoFcFont</link> *font,
                                                         <link linkend="PangoGlyphString">PangoGlyphString</link> *glyphs);</programlisting>
<para>
Adjust each adjacent pair of glyphs in <parameter>glyphs</parameter> according to
kerning information in <parameter>font</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>font</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoFcFont"><type>PangoFcFont</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>glyphs</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="PangoGlyphString"><type>PangoGlyphString</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since  1.4
</para></refsect2>

</refsect1>
<refsect1 id="PangoFcFont.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="PangoFcFont--pattern"><title>The <literal>&quot;pattern&quot;</literal> property</title>
<indexterm zone="PangoFcFont--pattern"><primary>PangoFcFont:pattern</primary></indexterm><programlisting>  &quot;pattern&quot;                  <link linkend="gpointer">gpointer</link>              : Write / Construct Only</programlisting>
<para>The fontconfig pattern for this font.</para></refsect2>

</refsect1>



<refsect1 id="PangoFcFont.see-also">
<title>See Also</title>
<para>
<variablelist>

<varlistentry>
<term><link linkend="PangoFcFontMap"><type>PangoFcFontMap</type></link></term>
<listitem><para>The base class for font maps; creating a new
Fontconfig-based backend involves deriving from both
<link linkend="PangoFcFontMap"><type>PangoFcFontMap</type></link> and <link linkend="PangoFcFont"><type>PangoFcFont</type></link>.
.</para></listitem>
</varlistentry>

</variablelist>
</para>
</refsect1>

</refentry>