📄 pango-vertical-text.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>Vertical Text</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="pango.html" title="Basic Pango Interfaces"><link rel="prev" href="pango-Scripts.html" title="Scripts"><link rel="next" href="rendering.html" title="Rendering with Pango"><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-Scripts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="pango.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="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></nobr></td></tr></table><div class="refentry" lang="en"><a name="pango-Vertical-Text"></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>Vertical Text</span></h2><p>Vertical Text — Laying text out in vertical directions</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><a name="synopsis"></a><h2>Synopsis</h2><pre class="synopsis">enum <a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a>;#define <a href="pango-Vertical-Text.html#PANGO-TYPE-GRAVITY:CAPS">PANGO_TYPE_GRAVITY</a>enum <a href="pango-Vertical-Text.html#PangoGravityHint">PangoGravityHint</a>;#define <a href="pango-Vertical-Text.html#PANGO-TYPE-GRAVITY-HINT:CAPS">PANGO_TYPE_GRAVITY_HINT</a>#define <a href="pango-Vertical-Text.html#PANGO-GRAVITY-IS-VERTICAL:CAPS">PANGO_GRAVITY_IS_VERTICAL</a> (gravity)<a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> <a href="pango-Vertical-Text.html#pango-gravity-get-for-matrix">pango_gravity_get_for_matrix</a> (const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix);<a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> <a href="pango-Vertical-Text.html#pango-gravity-get-for-script">pango_gravity_get_for_script</a> (<a href="pango-Scripts.html#PangoScript">PangoScript</a> script, <a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> base_gravity, <a href="pango-Vertical-Text.html#PangoGravityHint">PangoGravityHint</a> hint);</pre></div><div class="refsect1" lang="en"><a name="desc"></a><h2>Description</h2><p>Since 1.16, Pango is able to correctly lay vertical text out. In fact, it canset layouts of mixed vertical and non-vertical text. This section describesthe types used for setting vertical text parameters.</p></div><div class="refsect1" lang="en"><a name="details"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2869146"></a><h3><a name="PangoGravity"></a>enum PangoGravity</h3><a class="indexterm" name="id2869159"></a><pre class="programlisting">typedef enum { PANGO_GRAVITY_SOUTH, PANGO_GRAVITY_EAST, PANGO_GRAVITY_NORTH, PANGO_GRAVITY_WEST, PANGO_GRAVITY_AUTO} PangoGravity;</pre><p>The <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> type represents the orientation of glyphs in a segmentof text. This is useful when rendering vertical text layouts. Inthose situations, the layout is rotated using a non-identity PangoMatrix,and then glyph orientation is controlled using <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>.Not every value in this enumeration makes sense for every usage of<a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>; for example, <a href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a> only can be passed to<a href="pango-Text-Processing.html#pango-context-set-base-gravity"><code class="function">pango_context_set_base_gravity()</code></a> and can only be returned by<a href="pango-Text-Processing.html#pango-context-get-base-gravity"><code class="function">pango_context_get_base_gravity()</code></a>.</p><p>See also: <a href="pango-Vertical-Text.html#PangoGravityHint"><span class="type">PangoGravityHint</span></a></p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><a name="PANGO-GRAVITY-SOUTH:CAPS"></a><code class="literal">PANGO_GRAVITY_SOUTH</code></span></td><td> Glyphs stand upright (default)</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-EAST:CAPS"></a><code class="literal">PANGO_GRAVITY_EAST</code></span></td><td> Glyphs are rotated 90 degrees clockwise</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-NORTH:CAPS"></a><code class="literal">PANGO_GRAVITY_NORTH</code></span></td><td> Glyphs are upside-down</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-WEST:CAPS"></a><code class="literal">PANGO_GRAVITY_WEST</code></span></td><td> Glyphs are rotated 90 degrees counter-clockwise</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-AUTO:CAPS"></a><code class="literal">PANGO_GRAVITY_AUTO</code></span></td><td> Gravity is resolved from the context matrix</td></tr></tbody></table></div><p>Since 1.16</p></div><hr><div class="refsect2" lang="en"><a name="id2869378"></a><h3><a name="PANGO-TYPE-GRAVITY:CAPS"></a>PANGO_TYPE_GRAVITY</h3><a class="indexterm" name="id2869391"></a><pre class="programlisting">#define PANGO_TYPE_GRAVITY (pango_gravity_get_type())</pre><p>The <ahref="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>.</p></div><hr><div class="refsect2" lang="en"><a name="id2869423"></a><h3><a name="PangoGravityHint"></a>enum PangoGravityHint</h3><a class="indexterm" name="id2869439"></a><pre class="programlisting">typedef enum { PANGO_GRAVITY_HINT_NATURAL, PANGO_GRAVITY_HINT_STRONG, PANGO_GRAVITY_HINT_LINE} PangoGravityHint;</pre><p>The <a href="pango-Vertical-Text.html#PangoGravityHint"><span class="type">PangoGravityHint</span></a> defines how horizontal scripts should behave in avertical context. That is, English excerpt in a vertical paragraph forexample.</p><p>See <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><a name="PANGO-GRAVITY-HINT-NATURAL:CAPS"></a><code class="literal">PANGO_GRAVITY_HINT_NATURAL</code></span></td><td> scripts will take their natural gravity basedon the base gravity and the script. This is the default.</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-HINT-STRONG:CAPS"></a><code class="literal">PANGO_GRAVITY_HINT_STRONG</code></span></td><td> always use the base gravity set, regardless ofthe script.</td></tr><tr><td><span class="term"><a name="PANGO-GRAVITY-HINT-LINE:CAPS"></a><code class="literal">PANGO_GRAVITY_HINT_LINE</code></span></td><td> for scripts not in their natural direction (eg.Latin in East gravity), choose per-script gravity such that every scriptrespects the line progression. This means, Latin and Arabic will takeopposite gravities and both flow top-to-bottom for example.</td></tr></tbody></table></div><p>Since 1.16</p></div><hr><div class="refsect2" lang="en"><a name="id2869566"></a><h3><a name="PANGO-TYPE-GRAVITY-HINT:CAPS"></a>PANGO_TYPE_GRAVITY_HINT</h3><a class="indexterm" name="id2869580"></a><pre class="programlisting">#define PANGO_TYPE_GRAVITY_HINT (pango_gravity_hint_get_type())</pre><p>The <ahref="../gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type for <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a>.</p></div><hr><div class="refsect2" lang="en"><a name="id2869612"></a><h3><a name="PANGO-GRAVITY-IS-VERTICAL:CAPS"></a>PANGO_GRAVITY_IS_VERTICAL()</h3><a class="indexterm" name="id2869628"></a><pre class="programlisting">#define PANGO_GRAVITY_IS_VERTICAL(gravity)</pre><p>Whether a <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> represents vertical writing directions.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>gravity</code></em> :</span></td><td> the <a href="pango-Vertical-Text.html#PangoGravity"><span class="type">PangoGravity</span></a> to check</td></tr></tbody></table></div><p>Since 1.16</p></div><hr><div class="refsect2" lang="en"><a name="id2869687"></a><h3><a name="pango-gravity-get-for-matrix"></a>pango_gravity_get_for_matrix ()</h3><a class="indexterm" name="id2869703"></a><pre class="programlisting"><a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> pango_gravity_get_for_matrix (const <a href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix);</pre><p>Finds the gravity that best matches the rotation componentin a <a href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>matrix</code></em> :</span></td><td> a <a href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> the gravity of <em class="parameter"><code>matrix</code></em>, which will never be<a href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>, or <a href="pango-Vertical-Text.html#PANGO-GRAVITY-SOUTH:CAPS"><code class="literal">PANGO_GRAVITY_SOUTH</code></a> if <em class="parameter"><code>matrix</code></em> is <ahref="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td></tr></tbody></table></div><p>Since 1.16</p></div><hr><div class="refsect2" lang="en"><a name="id2869830"></a><h3><a name="pango-gravity-get-for-script"></a>pango_gravity_get_for_script ()</h3><a class="indexterm" name="id2869845"></a><pre class="programlisting"><a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> pango_gravity_get_for_script (<a href="pango-Scripts.html#PangoScript">PangoScript</a> script, <a href="pango-Vertical-Text.html#PangoGravity">PangoGravity</a> base_gravity, <a href="pango-Vertical-Text.html#PangoGravityHint">PangoGravityHint</a> hint);</pre><p>Based on the script, base gravity, and hint, returns actual gravityto use in laying out a single <a href="pango-Text-Processing.html#PangoItem"><span class="type">PangoItem</span></a>.</p><p>If <em class="parameter"><code>base_gravity</code></em> is <a href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a>, it is first replaced with thepreferred gravity of <em class="parameter"><code>script</code></em>. To get the preferred gravity of a script,pass <a href="pango-Vertical-Text.html#PANGO-GRAVITY-AUTO:CAPS"><code class="literal">PANGO_GRAVITY_AUTO</code></a> and <a href="pango-Vertical-Text.html#PANGO-GRAVITY-HINT-STRONG:CAPS"><code class="literal">PANGO_GRAVITY_HINT_STRONG</code></a> in.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>script</code></em> :</span></td><td> <a href="pango-Scripts.html#PangoScript"><span class="type">PangoScript</span></a> to query</td></tr><tr><td><span class="term"><em class="parameter"><code>base_gravity</code></em> :</span></td><td> base gravity of the paragraph</td></tr><tr><td><span class="term"><em class="parameter"><code>hint</code></em> :</span></td><td> orientation hint</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> resolved gravity suitable to use for a run of text</td></tr></tbody></table></div><p>Since 1.16</p></div></div></div></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -