📄 pango-freetype-fonts-and-rendering.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>FreeType Fonts and Rendering</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><link rel="start" href="index.html" title="Pango Reference Manual"><link rel="up" href="rendering.html" title="Rendering with Pango"><link rel="prev" href="pango-Win32-Fonts-and-Rendering.html" title="Win32 Fonts and Rendering"><link rel="next" href="pango-Xft-Fonts-and-Rendering.html" title="Xft Fonts and Rendering"><meta name="generator" content="GTK-Doc V1.6 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="pango.html" title="Basic Pango Interfaces"><link rel="chapter" href="rendering.html" title="Rendering with Pango"><link rel="chapter" href="lowlevel.html" title="Low Level Functionality"><link rel="chapter" href="tools.html" title="Pango Tools"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 1.2"><link rel="index" href="ix04.html" title="Index of new symbols in 1.4"><link rel="index" href="ix05.html" title="Index of new symbols in 1.6"><link rel="index" href="ix06.html" title="Index of new symbols in 1.8"><link rel="index" href="ix07.html" title="Index of new symbols in 1.10"><link rel="index" href="ix08.html" title="Index of new symbols in 1.12"><link rel="index" href="ix09.html" title="Index of new symbols in 1.14"><link rel="index" href="ix10.html" title="Index of new symbols in 1.16"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="pango-Win32-Fonts-and-Rendering.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="rendering.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Pango Reference Manual</th><td><a accesskey="n" href="pango-Xft-Fonts-and-Rendering.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>  |  <a href="#desc" class="shortcut">Description</a>  |  <a href="#object_hierarchy" class="shortcut">Object Hierarchy</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="pango-FreeType-Fonts-and-Rendering"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle"><a name="top_of_page"></a>FreeType Fonts and Rendering</span></h2><p>FreeType Fonts and Rendering — Functions for shape engines to manipulate FreeType fonts</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><a name="synopsis"></a><h2>Synopsis</h2><a name="PangoFT2FontMap"></a><pre class="synopsis"> <a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap-struct">PangoFT2FontMap</a>;#define <a href="pango-FreeType-Fonts-and-Rendering.html#PANGO-RENDER-TYPE-FT2:CAPS">PANGO_RENDER_TYPE_FT2</a><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-new">pango_ft2_font_map_new</a> (void);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-set-resolution">pango_ft2_font_map_set_resolution</a> (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap, double dpi_x, double dpi_y);<a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-create-context">pango_ft2_font_map_create_context</a> (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap);void (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2SubstituteFunc">*PangoFT2SubstituteFunc</a>) (FcPattern *pattern, <ahref="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-set-default-substitute">pango_ft2_font_map_set_default_substitute</a> (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap, <a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2SubstituteFunc">PangoFT2SubstituteFunc</a> func, <ahref="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data, <ahref="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-substitute-changed">pango_ft2_font_map_substitute_changed</a> (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap);<a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-get-context">pango_ft2_get_context</a> (double dpi_x, double dpi_y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render">pango_ft2_render</a> (FT_Bitmap *bitmap, <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font, <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs, <ahref="../glib/glib-Basic-Types.html#gint">gint</a> x, <ahref="../glib/glib-Basic-Types.html#gint">gint</a> y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render-transformed">pango_ft2_render_transformed</a> (FT_Bitmap *bitmap, const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix, <a href="pango-Fonts.html#PangoFont">PangoFont</a> *font, <a href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs, int x, int y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render-layout-line">pango_ft2_render_layout_line</a> (FT_Bitmap *bitmap, <a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line, int x, int y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render-layout-line-subpixel">pango_ft2_render_layout_line_subpixel</a> (FT_Bitmap *bitmap, <a href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line, int x, int y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render-layout">pango_ft2_render_layout</a> (FT_Bitmap *bitmap, <a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout, int x, int y);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-render-layout-subpixel">pango_ft2_render_layout_subpixel</a> (FT_Bitmap *bitmap, <a href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout, int x, int y);<a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-get-unknown-glyph">pango_ft2_get_unknown_glyph</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);int <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-get-kerning">pango_ft2_font_get_kerning</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font, <a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> left, <a href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> right);FT_Face <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-get-face">pango_ft2_font_get_face</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font);<a href="pango-Coverage-Maps.html#PangoCoverage">PangoCoverage</a>* <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-get-coverage">pango_ft2_font_get_coverage</a> (<a href="pango-Fonts.html#PangoFont">PangoFont</a> *font, <a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-for-display">pango_ft2_font_map_for_display</a> (void);void <a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-shutdown-display">pango_ft2_shutdown_display</a> (void);</pre></div><div class="refsect1" lang="en"><a name="object_hierarchy"></a><h2>Object Hierarchy</h2><pre class="synopsis"> <ahref="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> +----<a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a> +----<a href="PangoFcFontMap.html" title="PangoFcFontMap">PangoFcFontMap</a> +----PangoFT2FontMap</pre></div><div class="refsect1" lang="en"><a name="desc"></a><h2>Description</h2><p>The macros and functions in this section are used to access fonts and rendertext to bitmaps using the FreeType 2 library.</p></div><div class="refsect1" lang="en"><a name="details"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2877944"></a><h3><a name="PangoFT2FontMap-struct"></a>PangoFT2FontMap</h3><a class="indexterm" name="id2877954"></a><pre class="programlisting">typedef struct _PangoFT2FontMap PangoFT2FontMap;</pre><p>The <a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap"><span class="type">PangoFT2FontMap</span></a> is the <a href="pango-Fonts.html#PangoFontMap"><span class="type">PangoFontMap</span></a> implementation for FreeType fonts.</p></div><hr><div class="refsect2" lang="en"><a name="id2877987"></a><h3><a name="PANGO-RENDER-TYPE-FT2:CAPS"></a>PANGO_RENDER_TYPE_FT2</h3><a class="indexterm" name="id2878002"></a><pre class="programlisting">#define PANGO_RENDER_TYPE_FT2 "PangoRenderFT2"</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><code class="literal">PANGO_RENDER_TYPE_FT2</code> is deprecated and should not be used in newly-written code.</p></div><p>A string constant that was used to identify shape engines that workwith the FreeType backend. See <a href="PangoFcFont.html#PANGO-RENDER-TYPE-FC:CAPS"><code class="literal">PANGO_RENDER_TYPE_FC</code></a> for the replacement.</p></div><hr><div class="refsect2" lang="en"><a name="id2878045"></a><h3><a name="pango-ft2-font-map-new"></a>pango_ft2_font_map_new ()</h3><a class="indexterm" name="id2878061"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontMap">PangoFontMap</a>* pango_ft2_font_map_new (void);</pre><p>Create a new <a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap"><span class="type">PangoFT2FontMap</span></a> object; a fontmap is usedto cache information about available fonts, and holdscertain global parameters such as the resolution andthe default substitute function (see<a href="pango-FreeType-Fonts-and-Rendering.html#pango-ft2-font-map-set-default-substitute"><code class="function">pango_ft2_font_map_set_default_substitute()</code></a>).</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> the newly created fontmap object. Unrefwith <ahref="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when you are finished with it.</td></tr></tbody></table></div><p>Since 1.2</p></div><hr><div class="refsect2" lang="en"><a name="id2878140"></a><h3><a name="pango-ft2-font-map-set-resolution"></a>pango_ft2_font_map_set_resolution ()</h3><a class="indexterm" name="id2878156"></a><pre class="programlisting">void pango_ft2_font_map_set_resolution (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap, double dpi_x, double dpi_y);</pre><p>Sets the horizontal and vertical resolutions for the fontmap.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td><td> a <span class="type">PangoFT2Fontmap</span></td></tr><tr><td><span class="term"><em class="parameter"><code>dpi_x</code></em> :</span></td><td> dots per inch in the X direction</td></tr><tr><td><span class="term"><em class="parameter"><code>dpi_y</code></em> :</span></td><td> dots per inch in the Y direction</td></tr></tbody></table></div><p>Since 1.2</p></div><hr><div class="refsect2" lang="en"><a name="id2878265"></a><h3><a name="pango-ft2-font-map-create-context"></a>pango_ft2_font_map_create_context ()</h3><a class="indexterm" name="id2878282"></a><pre class="programlisting"><a href="pango-Text-Processing.html#PangoContext">PangoContext</a>* pango_ft2_font_map_create_context (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap);</pre><p>Create a <a href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> for the given fontmap.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>fontmap</code></em> :</span></td><td> a <span class="type">PangoFT2Fontmap</span></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> the newly created context; free with <ahref="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td></tr></tbody></table></div><p>Since 1.2</p></div><hr><div class="refsect2" lang="en"><a name="id2878375"></a><h3><a name="PangoFT2SubstituteFunc"></a>PangoFT2SubstituteFunc ()</h3><a class="indexterm" name="id2878388"></a><pre class="programlisting">void (*PangoFT2SubstituteFunc) (FcPattern *pattern, <ahref="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data);</pre><p>Function type for doing final config tweaking on prepared FcPatterns.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>pattern</code></em> :</span></td><td>the <span class="type">FcPattern</span> to tweak.</td></tr><tr><td><span class="term"><em class="parameter"><code>data</code></em> :</span></td><td>user data.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2878461"></a><h3><a name="pango-ft2-font-map-set-default-substitute"></a>pango_ft2_font_map_set_default_substitute ()</h3><a class="indexterm" name="id2878478"></a><pre class="programlisting">void pango_ft2_font_map_set_default_substitute (<a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2FontMap">PangoFT2FontMap</a> *fontmap, <a href="pango-FreeType-Fonts-and-Rendering.html#PangoFT2SubstituteFunc">PangoFT2SubstituteFunc</a> func, <ahref="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data, <a⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -