pango 2.1.0-x86-mingw32 → 2.2.0-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/pango/rbpangocairo.c +7 -1
- data/lib/1.9/pango.so +0 -0
- data/lib/2.0/pango.so +0 -0
- data/lib/2.1/pango.so +0 -0
- data/vendor/local/bin/hb-ot-shape-closure.exe +0 -0
- data/vendor/local/bin/hb-shape.exe +0 -0
- data/vendor/local/bin/hb-view.exe +0 -0
- data/vendor/local/bin/libharfbuzz-0.dll +0 -0
- data/vendor/local/bin/libpango-1.0-0.dll +0 -0
- data/vendor/local/bin/libpangocairo-1.0-0.dll +0 -0
- data/vendor/local/bin/libpangoft2-1.0-0.dll +0 -0
- data/vendor/local/bin/libpangowin32-1.0-0.dll +0 -0
- data/vendor/local/bin/libstdc++-6.dll +0 -0
- data/vendor/local/bin/pango-querymodules.exe +0 -0
- data/vendor/local/bin/pango-view.exe +0 -0
- data/vendor/local/include/harfbuzz/hb-common.h +7 -1
- data/vendor/local/include/harfbuzz/hb-ot-layout.h +0 -5
- data/vendor/local/include/harfbuzz/hb-ot-shape.h +54 -0
- data/vendor/local/include/harfbuzz/hb-ot.h +1 -8
- data/vendor/local/include/harfbuzz/hb-version.h +2 -2
- data/vendor/local/include/pango-1.0/pango/pango-features.h +2 -2
- data/vendor/local/lib/girepository-1.0/PangoFT2-1.0.typelib +0 -0
- data/vendor/local/lib/libharfbuzz.dll.a +0 -0
- data/vendor/local/lib/libharfbuzz.la +2 -2
- data/vendor/local/lib/libpango-1.0.dll.a +0 -0
- data/vendor/local/lib/libpango-1.0.la +1 -1
- data/vendor/local/lib/libpangocairo-1.0.dll.a +0 -0
- data/vendor/local/lib/libpangocairo-1.0.la +1 -1
- data/vendor/local/lib/libpangoft2-1.0.dll.a +0 -0
- data/vendor/local/lib/libpangoft2-1.0.la +1 -1
- data/vendor/local/lib/libpangowin32-1.0.dll.a +0 -0
- data/vendor/local/lib/libpangowin32-1.0.la +1 -1
- data/vendor/local/lib/pango/1.8.0/modules/pango-arabic-lang.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-arabic-lang.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-fc.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-fc.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-win32.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-basic-win32.dll.a +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-indic-lang.dll +0 -0
- data/vendor/local/lib/pango/1.8.0/modules/pango-indic-lang.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/harfbuzz.pc +1 -1
- data/vendor/local/lib/pkgconfig/pango.pc +1 -1
- data/vendor/local/lib/pkgconfig/pangocairo.pc +1 -1
- data/vendor/local/lib/pkgconfig/pangoft2.pc +1 -1
- data/vendor/local/lib/pkgconfig/pangowin32.pc +1 -1
- data/vendor/local/share/gtk-doc/html/harfbuzz/ch01.html +1 -1
- data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-common.html +9 -1
- data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz-hb-version.html +2 -2
- data/vendor/local/share/gtk-doc/html/harfbuzz/harfbuzz.devhelp2 +1 -0
- data/vendor/local/share/gtk-doc/html/harfbuzz/index.html +1 -1
- data/vendor/local/share/gtk-doc/html/harfbuzz/index.sgml +1 -0
- data/vendor/local/share/gtk-doc/html/pango/PangoEngineLang.html +18 -31
- data/vendor/local/share/gtk-doc/html/pango/PangoEngineShape.html +18 -31
- data/vendor/local/share/gtk-doc/html/pango/PangoFcDecoder.html +17 -25
- data/vendor/local/share/gtk-doc/html/pango/PangoFcFont.html +25 -39
- data/vendor/local/share/gtk-doc/html/pango/PangoFcFontMap.html +44 -78
- data/vendor/local/share/gtk-doc/html/pango/PangoMarkupFormat.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/PangoRenderer.html +41 -75
- data/vendor/local/share/gtk-doc/html/pango/annotation-glossary.html +23 -26
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-10.html +19 -22
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-12.html +15 -18
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-14.html +17 -20
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-16.html +33 -36
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-18.html +17 -20
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-2.html +21 -24
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-20.html +19 -22
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-22.html +25 -28
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-24.html +15 -18
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-26.html +13 -16
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-30.html +10 -13
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-31-0.html +10 -13
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-32-4.html +15 -18
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-32.html +13 -16
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-34.html +10 -13
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-4.html +23 -26
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-6.html +23 -26
- data/vendor/local/share/gtk-doc/html/pango/api-index-1-8.html +19 -22
- data/vendor/local/share/gtk-doc/html/pango/api-index-deprecated.html +162 -26
- data/vendor/local/share/gtk-doc/html/pango/api-index-full.html +51 -54
- data/vendor/local/share/gtk-doc/html/pango/home.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/index.html +4 -4
- data/vendor/local/share/gtk-doc/html/pango/left-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/left.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/lowlevel.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/pango-Bidirectional-Text.html +25 -40
- data/vendor/local/share/gtk-doc/html/pango/pango-Cairo-Rendering.html +118 -169
- data/vendor/local/share/gtk-doc/html/pango/pango-CoreText-Fonts.html +15 -21
- data/vendor/local/share/gtk-doc/html/pango/pango-Coverage-Maps.html +24 -39
- data/vendor/local/share/gtk-doc/html/pango/pango-Engines.html +24 -39
- data/vendor/local/share/gtk-doc/html/pango/pango-Fonts.html +125 -240
- data/vendor/local/share/gtk-doc/html/pango/pango-FreeType-Fonts-and-Rendering.html +46 -74
- data/vendor/local/share/gtk-doc/html/pango/pango-Glyph-Storage.html +95 -189
- data/vendor/local/share/gtk-doc/html/pango/pango-Layout-Objects.html +137 -265
- data/vendor/local/share/gtk-doc/html/pango/pango-Miscellaneous-Utilities.html +38 -66
- data/vendor/local/share/gtk-doc/html/pango/pango-Modules.html +20 -31
- data/vendor/local/share/gtk-doc/html/pango/pango-OpenType-Font-Handling.html +207 -143
- data/vendor/local/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html +47 -86
- data/vendor/local/share/gtk-doc/html/pango/pango-Tab-Stops.html +26 -43
- data/vendor/local/share/gtk-doc/html/pango/pango-Text-Attributes.html +106 -203
- data/vendor/local/share/gtk-doc/html/pango/pango-Text-Processing.html +66 -122
- data/vendor/local/share/gtk-doc/html/pango/pango-Version-Checking.html +29 -47
- data/vendor/local/share/gtk-doc/html/pango/pango-Vertical-Text.html +33 -57
- data/vendor/local/share/gtk-doc/html/pango/pango-Win32-Fonts-and-Rendering.html +49 -79
- data/vendor/local/share/gtk-doc/html/pango/pango-Xft-Fonts-and-Rendering.html +53 -90
- data/vendor/local/share/gtk-doc/html/pango/pango-hierarchy.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/pango-querymodules.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/pango.devhelp2 +34 -34
- data/vendor/local/share/gtk-doc/html/pango/pango.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/rendering.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/right-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/right.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/style.css +71 -16
- data/vendor/local/share/gtk-doc/html/pango/tools.html +9 -9
- data/vendor/local/share/gtk-doc/html/pango/up-insensitive.png +0 -0
- data/vendor/local/share/gtk-doc/html/pango/up.png +0 -0
- data/vendor/local/share/man/man1/pango-querymodules.1 +2 -2
- data/vendor/local/share/man/man1/pango-view.1 +1 -1
- metadata +8 -4
@@ -2,32 +2,29 @@
|
|
2
2
|
<html>
|
3
3
|
<head>
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
5
|
-
<title>Layout Objects</title>
|
5
|
+
<title>Pango Reference Manual: Layout Objects</title>
|
6
6
|
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
7
7
|
<link rel="home" href="index.html" title="Pango Reference Manual">
|
8
8
|
<link rel="up" href="pango.html" title="Basic Pango Interfaces">
|
9
9
|
<link rel="prev" href="PangoMarkupFormat.html" title="Text Attribute Markup">
|
10
10
|
<link rel="next" href="pango-Scripts-and-Languages.html" title="Scripts and Languages">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
|
11
|
+
<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
15
|
-
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="
|
16
|
-
<
|
17
|
-
<
|
18
|
-
<td><a accesskey="u" href="pango.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
19
|
-
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
20
|
-
<th width="100%" align="center">Pango Reference Manual</th>
|
21
|
-
<td><a accesskey="n" href="pango-Scripts-and-Languages.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
22
|
-
</tr>
|
23
|
-
<tr><td colspan="5" class="shortcuts">
|
24
|
-
<a href="#pango-Layout-Objects.synopsis" class="shortcut">Top</a>
|
15
|
+
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
|
16
|
+
<td width="100%" align="left">
|
17
|
+
<a href="#" class="shortcut">Top</a>
|
25
18
|
|
|
26
19
|
<a href="#pango-Layout-Objects.description" class="shortcut">Description</a>
|
27
20
|
|
|
28
21
|
<a href="#pango-Layout-Objects.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
29
|
-
</td
|
30
|
-
|
22
|
+
</td>
|
23
|
+
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
24
|
+
<td><a accesskey="u" href="pango.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
25
|
+
<td><a accesskey="p" href="PangoMarkupFormat.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
26
|
+
<td><a accesskey="n" href="pango-Scripts-and-Languages.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
27
|
+
</tr></table>
|
31
28
|
<div class="refentry">
|
32
29
|
<a name="pango-Layout-Objects"></a><div class="titlepage"></div>
|
33
30
|
<div class="refnamediv"><table width="100%"><tr>
|
@@ -256,8 +253,7 @@ using the detailed interfaces for itemization and shaping, using
|
|
256
253
|
that functionality directly involves writing a fairly large amount
|
257
254
|
of code. The objects and functions in this section provide a
|
258
255
|
high-level driver for formatting entire paragraphs of text
|
259
|
-
at once
|
260
|
-
</p>
|
256
|
+
at once.</p>
|
261
257
|
</div>
|
262
258
|
<div class="refsect1">
|
263
259
|
<a name="pango-Layout-Objects.details"></a><h2>Details</h2>
|
@@ -271,26 +267,22 @@ and set of attributes for that string. Once that is done, the
|
|
271
267
|
set of formatted lines can be extracted from the object,
|
272
268
|
the layout can be rendered, and conversion between logical
|
273
269
|
character positions within the layout's text, and the physical
|
274
|
-
position of the resulting glyphs can be made
|
275
|
-
</p>
|
270
|
+
position of the resulting glyphs can be made.</p>
|
276
271
|
<p>
|
277
272
|
There are also a number of parameters to adjust the formatting
|
278
273
|
of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, which are illustrated in <a class="xref" href="pango-Layout-Objects.html#parameters" title="Figure 1. Adjustable parameters for a PangoLayout">Figure 1, “Adjustable parameters for a PangoLayout”</a>.
|
279
274
|
It is possible, as well, to ignore the 2-D setup, and simply
|
280
|
-
treat the results of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> as a list of lines
|
281
|
-
</p>
|
275
|
+
treat the results of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> as a list of lines.</p>
|
282
276
|
<p>
|
283
277
|
</p>
|
284
278
|
<div class="figure">
|
285
279
|
<a name="parameters"></a><p class="title"><b>Figure 1. Adjustable parameters for a PangoLayout</b></p>
|
286
280
|
<div class="figure-contents"><div><img src="layout.gif" alt="Adjustable parameters for a PangoLayout"></div></div>
|
287
281
|
</div>
|
288
|
-
<p><br class="figure-break">
|
289
|
-
</p>
|
282
|
+
<p><br class="figure-break"></p>
|
290
283
|
<p>
|
291
284
|
The <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> structure is opaque, and has no user-visible
|
292
|
-
fields
|
293
|
-
</p>
|
285
|
+
fields.</p>
|
294
286
|
</div>
|
295
287
|
<hr>
|
296
288
|
<div class="refsect2">
|
@@ -298,12 +290,10 @@ fields.
|
|
298
290
|
<pre class="programlisting">typedef struct _PangoLayoutIter PangoLayoutIter;</pre>
|
299
291
|
<p>
|
300
292
|
A <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> structure can be used to
|
301
|
-
iterate over the visual extents of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a
|
302
|
-
</p>
|
293
|
+
iterate over the visual extents of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
|
303
294
|
<p>
|
304
295
|
The <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> structure is opaque, and
|
305
|
-
has no user-visible fields
|
306
|
-
</p>
|
296
|
+
has no user-visible fields.</p>
|
307
297
|
</div>
|
308
298
|
<hr>
|
309
299
|
<div class="refsect2">
|
@@ -311,8 +301,7 @@ has no user-visible fields.
|
|
311
301
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * pango_layout_new (<em class="parameter"><code><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> *context</code></em>);</pre>
|
312
302
|
<p>
|
313
303
|
Create a new <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> object with attributes initialized to
|
314
|
-
default values for a particular <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a
|
315
|
-
</p>
|
304
|
+
default values for a particular <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>.</p>
|
316
305
|
<div class="variablelist"><table border="0" class="variablelist">
|
317
306
|
<colgroup>
|
318
307
|
<col align="left" valign="top">
|
@@ -340,8 +329,7 @@ count of one, which should be freed with
|
|
340
329
|
<p>
|
341
330
|
Does a deep copy-by-value of the <em class="parameter"><code>src</code></em> layout. The attribute list,
|
342
331
|
tab array, and text from the original layout are all copied by
|
343
|
-
value
|
344
|
-
</p>
|
332
|
+
value.</p>
|
345
333
|
<div class="variablelist"><table border="0" class="variablelist">
|
346
334
|
<colgroup>
|
347
335
|
<col align="left" valign="top">
|
@@ -368,8 +356,7 @@ with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk
|
|
368
356
|
<a name="pango-layout-get-context"></a><h3>pango_layout_get_context ()</h3>
|
369
357
|
<pre class="programlisting"><a class="link" href="pango-Text-Processing.html#PangoContext"><span class="returnvalue">PangoContext</span></a> * pango_layout_get_context (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
370
358
|
<p>
|
371
|
-
Retrieves the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> used for this layout
|
372
|
-
</p>
|
359
|
+
Retrieves the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> used for this layout.</p>
|
373
360
|
<div class="variablelist"><table border="0" class="variablelist">
|
374
361
|
<colgroup>
|
375
362
|
<col align="left" valign="top">
|
@@ -399,8 +386,7 @@ keep a copy of this around, you must reference it yourself. <span class="annotat
|
|
399
386
|
Forces recomputation of any state in the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> that
|
400
387
|
might depend on the layout's context. This function should
|
401
388
|
be called if you make changes to the context subsequent
|
402
|
-
to creating the layout
|
403
|
-
</p>
|
389
|
+
to creating the layout.</p>
|
404
390
|
<div class="variablelist"><table border="0" class="variablelist">
|
405
391
|
<colgroup>
|
406
392
|
<col align="left" valign="top">
|
@@ -423,13 +409,11 @@ initialized to an small number larger than zero when a new layout
|
|
423
409
|
is created and is increased whenever the layout is changed using any
|
424
410
|
of the setter functions, or the <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a> it uses has changed.
|
425
411
|
The serial may wrap, but will never have the value 0. Since it
|
426
|
-
can wrap, never compare it with "less than", always use "not equals"
|
427
|
-
</p>
|
412
|
+
can wrap, never compare it with "less than", always use "not equals".</p>
|
428
413
|
<p>
|
429
414
|
This can be used to automatically detect changes to a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, and
|
430
415
|
is useful for example to decide whether a layout needs redrawing.
|
431
|
-
To force the serial to be increased, use <a class="link" href="pango-Layout-Objects.html#pango-layout-context-changed" title="pango_layout_context_changed ()"><code class="function">pango_layout_context_changed()</code></a
|
432
|
-
</p>
|
416
|
+
To force the serial to be increased, use <a class="link" href="pango-Layout-Objects.html#pango-layout-context-changed" title="pango_layout_context_changed ()"><code class="function">pango_layout_context_changed()</code></a>.</p>
|
433
417
|
<div class="variablelist"><table border="0" class="variablelist">
|
434
418
|
<colgroup>
|
435
419
|
<col align="left" valign="top">
|
@@ -456,15 +440,13 @@ To force the serial to be increased, use <a class="link" href="pango-Layout-Obje
|
|
456
440
|
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
|
457
441
|
<em class="parameter"><code><span class="type">int</span> length</code></em>);</pre>
|
458
442
|
<p>
|
459
|
-
Sets the text of the layout
|
460
|
-
</p>
|
443
|
+
Sets the text of the layout.</p>
|
461
444
|
<p>
|
462
445
|
Note that if you have used
|
463
446
|
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-markup" title="pango_layout_set_markup ()"><code class="function">pango_layout_set_markup()</code></a> or <a class="link" href="pango-Layout-Objects.html#pango-layout-set-markup-with-accel" title="pango_layout_set_markup_with_accel ()"><code class="function">pango_layout_set_markup_with_accel()</code></a> on
|
464
447
|
<em class="parameter"><code>layout</code></em> before, you may want to call <a class="link" href="pango-Layout-Objects.html#pango-layout-set-attributes" title="pango_layout_set_attributes ()"><code class="function">pango_layout_set_attributes()</code></a> to clear
|
465
448
|
the attributes set on the layout from the markup as this function does not
|
466
|
-
clear attributes
|
467
|
-
</p>
|
449
|
+
clear attributes.</p>
|
468
450
|
<div class="variablelist"><table border="0" class="variablelist">
|
469
451
|
<colgroup>
|
470
452
|
<col align="left" valign="top">
|
@@ -497,8 +479,7 @@ positive.</td>
|
|
497
479
|
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_layout_get_text (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
498
480
|
<p>
|
499
481
|
Gets the text in the layout. The returned text should not
|
500
|
-
be freed or modified
|
501
|
-
</p>
|
482
|
+
be freed or modified.</p>
|
502
483
|
<div class="variablelist"><table border="0" class="variablelist">
|
503
484
|
<colgroup>
|
504
485
|
<col align="left" valign="top">
|
@@ -523,8 +504,7 @@ be freed or modified.
|
|
523
504
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> pango_layout_get_character_count (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
524
505
|
<p>
|
525
506
|
Returns the number of Unicode characters in the
|
526
|
-
the text of <em class="parameter"><code>layout</code></em
|
527
|
-
</p>
|
507
|
+
the text of <em class="parameter"><code>layout</code></em>.</p>
|
528
508
|
<div class="variablelist"><table border="0" class="variablelist">
|
529
509
|
<colgroup>
|
530
510
|
<col align="left" valign="top">
|
@@ -554,8 +534,7 @@ in the text of <em class="parameter"><code>layout</code></em>
|
|
554
534
|
<em class="parameter"><code><span class="type">int</span> length</code></em>);</pre>
|
555
535
|
<p>
|
556
536
|
Same as <a class="link" href="pango-Layout-Objects.html#pango-layout-set-markup-with-accel" title="pango_layout_set_markup_with_accel ()"><code class="function">pango_layout_set_markup_with_accel()</code></a>, but
|
557
|
-
the markup text isn't scanned for accelerators
|
558
|
-
</p>
|
537
|
+
the markup text isn't scanned for accelerators.</p>
|
559
538
|
<div class="variablelist"><table border="0" class="variablelist">
|
560
539
|
<colgroup>
|
561
540
|
<col align="left" valign="top">
|
@@ -590,8 +569,7 @@ null-terminated</td>
|
|
590
569
|
<p>
|
591
570
|
Sets the layout text and attribute list from marked-up text (see
|
592
571
|
<a href="PangoMarkupFormat.html">markup format</a>). Replaces
|
593
|
-
the current text and attribute list
|
594
|
-
</p>
|
572
|
+
the current text and attribute list.</p>
|
595
573
|
<p>
|
596
574
|
If <em class="parameter"><code>accel_marker</code></em> is nonzero, the given character will mark the
|
597
575
|
character following it as an accelerator. For example, <em class="parameter"><code>accel_marker</code></em>
|
@@ -599,8 +577,7 @@ might be an ampersand or underscore. All characters marked
|
|
599
577
|
as an accelerator will receive a <a class="link" href="pango-Text-Attributes.html#PANGO-UNDERLINE-LOW:CAPS"><code class="literal">PANGO_UNDERLINE_LOW</code></a> attribute,
|
600
578
|
and the first character so marked will be returned in <em class="parameter"><code>accel_char</code></em>.
|
601
579
|
Two <em class="parameter"><code>accel_marker</code></em> characters following each other produce a single
|
602
|
-
literal <em class="parameter"><code>accel_marker</code></em> character
|
603
|
-
</p>
|
580
|
+
literal <em class="parameter"><code>accel_marker</code></em> character.</p>
|
604
581
|
<div class="variablelist"><table border="0" class="variablelist">
|
605
582
|
<colgroup>
|
606
583
|
<col align="left" valign="top">
|
@@ -642,8 +619,7 @@ for first located accelerator, or <a href="/home/kou/work/ruby/ruby-gnome2.win32
|
|
642
619
|
<em class="parameter"><code><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>);</pre>
|
643
620
|
<p>
|
644
621
|
Sets the text attributes for a layout object.
|
645
|
-
References <em class="parameter"><code>attrs</code></em>, so the caller can unref its reference
|
646
|
-
</p>
|
622
|
+
References <em class="parameter"><code>attrs</code></em>, so the caller can unref its reference.</p>
|
647
623
|
<div class="variablelist"><table border="0" class="variablelist">
|
648
624
|
<colgroup>
|
649
625
|
<col align="left" valign="top">
|
@@ -668,8 +644,7 @@ References <em class="parameter"><code>attrs</code></em>, so the caller can unre
|
|
668
644
|
<a name="pango-layout-get-attributes"></a><h3>pango_layout_get_attributes ()</h3>
|
669
645
|
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> * pango_layout_get_attributes (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
670
646
|
<p>
|
671
|
-
Gets the attribute list for the layout, if any
|
672
|
-
</p>
|
647
|
+
Gets the attribute list for the layout, if any.</p>
|
673
648
|
<div class="variablelist"><table border="0" class="variablelist">
|
674
649
|
<colgroup>
|
675
650
|
<col align="left" valign="top">
|
@@ -697,8 +672,7 @@ Gets the attribute list for the layout, if any.
|
|
697
672
|
<p>
|
698
673
|
Sets the default font description for the layout. If no font
|
699
674
|
description is set on the layout, the font description from
|
700
|
-
the layout's context is used
|
701
|
-
</p>
|
675
|
+
the layout's context is used.</p>
|
702
676
|
<div class="variablelist"><table border="0" class="variablelist">
|
703
677
|
<colgroup>
|
704
678
|
<col align="left" valign="top">
|
@@ -725,8 +699,7 @@ current font description. <span class="annotation">[<acronym title="NULL is ok,
|
|
725
699
|
<pre class="programlisting">const <a class="link" href="pango-Fonts.html#PangoFontDescription"><span class="returnvalue">PangoFontDescription</span></a> * pango_layout_get_font_description
|
726
700
|
(<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
727
701
|
<p>
|
728
|
-
Gets the font description for the layout, if any
|
729
|
-
</p>
|
702
|
+
Gets the font description for the layout, if any.</p>
|
730
703
|
<div class="variablelist"><table border="0" class="variablelist">
|
731
704
|
<colgroup>
|
732
705
|
<col align="left" valign="top">
|
@@ -756,8 +729,7 @@ and must not be modified or freed.</td>
|
|
756
729
|
<em class="parameter"><code><span class="type">int</span> width</code></em>);</pre>
|
757
730
|
<p>
|
758
731
|
Sets the width to which the lines of the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> should wrap or
|
759
|
-
ellipsized. The default value is -1: no width set
|
760
|
-
</p>
|
732
|
+
ellipsized. The default value is -1: no width set.</p>
|
761
733
|
<div class="variablelist"><table border="0" class="variablelist">
|
762
734
|
<colgroup>
|
763
735
|
<col align="left" valign="top">
|
@@ -781,8 +753,7 @@ wrapping or ellipsization should be performed.</td>
|
|
781
753
|
<a name="pango-layout-get-width"></a><h3>pango_layout_get_width ()</h3>
|
782
754
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_width (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
783
755
|
<p>
|
784
|
-
Gets the width to which the lines of the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> should wrap
|
785
|
-
</p>
|
756
|
+
Gets the width to which the lines of the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> should wrap.</p>
|
786
757
|
<div class="variablelist"><table border="0" class="variablelist">
|
787
758
|
<colgroup>
|
788
759
|
<col align="left" valign="top">
|
@@ -809,15 +780,13 @@ Gets the width to which the lines of the <a class="link" href="pango-Layout-Obje
|
|
809
780
|
<p>
|
810
781
|
Sets the height to which the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> should be ellipsized at. There
|
811
782
|
are two different behaviors, based on whether <em class="parameter"><code>height</code></em> is positive or
|
812
|
-
negative
|
813
|
-
</p>
|
783
|
+
negative.</p>
|
814
784
|
<p>
|
815
785
|
If <em class="parameter"><code>height</code></em> is positive, it will be the maximum height of the layout. Only
|
816
786
|
lines would be shown that would fit, and if there is any text omitted,
|
817
787
|
an ellipsis added. At least one line is included in each paragraph regardless
|
818
788
|
of how small the height value is. A value of zero will render exactly one
|
819
|
-
line for the entire layout
|
820
|
-
</p>
|
789
|
+
line for the entire layout.</p>
|
821
790
|
<p>
|
822
791
|
If <em class="parameter"><code>height</code></em> is negative, it will be the (negative of) maximum number of lines per
|
823
792
|
paragraph. That is, the total number of lines shown may well be more than
|
@@ -825,15 +794,13 @@ this value if the layout contains multiple paragraphs of text.
|
|
825
794
|
The default value of -1 means that first line of each paragraph is ellipsized.
|
826
795
|
This behvaior may be changed in the future to act per layout instead of per
|
827
796
|
paragraph. File a bug against pango at <a class="ulink" href="http://bugzilla.gnome.org/" target="_top">http://bugzilla.gnome.org/</a> if your
|
828
|
-
code relies on this behavior
|
829
|
-
</p>
|
797
|
+
code relies on this behavior.</p>
|
830
798
|
<p>
|
831
799
|
Height setting only has effect if a positive width is set on
|
832
800
|
<em class="parameter"><code>layout</code></em> and ellipsization mode of <em class="parameter"><code>layout</code></em> is not <a class="link" href="pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a>.
|
833
801
|
The behavior is undefined if a height other than -1 is set and
|
834
802
|
ellipsization mode is set to <a class="link" href="pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a>, and may change in the
|
835
|
-
future
|
836
|
-
</p>
|
803
|
+
future.</p>
|
837
804
|
<div class="variablelist"><table border="0" class="variablelist">
|
838
805
|
<colgroup>
|
839
806
|
<col align="left" valign="top">
|
@@ -859,8 +826,7 @@ or desired number of lines if negative.</td>
|
|
859
826
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_height (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
860
827
|
<p>
|
861
828
|
Gets the height of layout used for ellipsization. See
|
862
|
-
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a> for details
|
863
|
-
</p>
|
829
|
+
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a> for details.</p>
|
864
830
|
<div class="variablelist"><table border="0" class="variablelist">
|
865
831
|
<colgroup>
|
866
832
|
<col align="left" valign="top">
|
@@ -889,8 +855,7 @@ number of lines if negative.</td>
|
|
889
855
|
<p>
|
890
856
|
Sets the wrap mode; the wrap mode only has effect if a width
|
891
857
|
is set on the layout with <a class="link" href="pango-Layout-Objects.html#pango-layout-set-width" title="pango_layout_set_width ()"><code class="function">pango_layout_set_width()</code></a>.
|
892
|
-
To turn off wrapping, set the width to -1
|
893
|
-
</p>
|
858
|
+
To turn off wrapping, set the width to -1.</p>
|
894
859
|
<div class="variablelist"><table border="0" class="variablelist">
|
895
860
|
<colgroup>
|
896
861
|
<col align="left" valign="top">
|
@@ -914,12 +879,10 @@ To turn off wrapping, set the width to -1.
|
|
914
879
|
<a name="pango-layout-get-wrap"></a><h3>pango_layout_get_wrap ()</h3>
|
915
880
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoWrapMode"><span class="returnvalue">PangoWrapMode</span></a> pango_layout_get_wrap (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
916
881
|
<p>
|
917
|
-
Gets the wrap mode for the layout
|
918
|
-
</p>
|
882
|
+
Gets the wrap mode for the layout.</p>
|
919
883
|
<p>
|
920
884
|
Use <a class="link" href="pango-Layout-Objects.html#pango-layout-is-wrapped" title="pango_layout_is_wrapped ()"><code class="function">pango_layout_is_wrapped()</code></a> to query whether any paragraphs
|
921
|
-
were actually wrapped
|
922
|
-
</p>
|
885
|
+
were actually wrapped.</p>
|
923
886
|
<div class="variablelist"><table border="0" class="variablelist">
|
924
887
|
<colgroup>
|
925
888
|
<col align="left" valign="top">
|
@@ -943,14 +906,12 @@ were actually wrapped.
|
|
943
906
|
<a name="pango-layout-is-wrapped"></a><h3>pango_layout_is_wrapped ()</h3>
|
944
907
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_is_wrapped (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
945
908
|
<p>
|
946
|
-
Queries whether the layout had to wrap any paragraphs
|
947
|
-
</p>
|
909
|
+
Queries whether the layout had to wrap any paragraphs.</p>
|
948
910
|
<p>
|
949
911
|
This returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a positive width is set on <em class="parameter"><code>layout</code></em>,
|
950
912
|
ellipsization mode of <em class="parameter"><code>layout</code></em> is set to <a class="link" href="pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a>,
|
951
913
|
and there are paragraphs exceeding the layout width that have
|
952
|
-
to be wrapped
|
953
|
-
</p>
|
914
|
+
to be wrapped.</p>
|
954
915
|
<div class="variablelist"><table border="0" class="variablelist">
|
955
916
|
<colgroup>
|
956
917
|
<col align="left" valign="top">
|
@@ -982,8 +943,7 @@ otherwise.</td>
|
|
982
943
|
} PangoWrapMode;
|
983
944
|
</pre>
|
984
945
|
<p>
|
985
|
-
A <a class="link" href="pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> describes how to wrap the lines of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> to the desired width
|
986
|
-
</p>
|
946
|
+
A <a class="link" href="pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> describes how to wrap the lines of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> to the desired width.</p>
|
987
947
|
<div class="variablelist"><table border="0" class="variablelist">
|
988
948
|
<colgroup>
|
989
949
|
<col align="left" valign="top">
|
@@ -1025,15 +985,13 @@ Sets the type of ellipsization being performed for <em class="parameter"><code>l
|
|
1025
985
|
Depending on the ellipsization mode <em class="parameter"><code>ellipsize</code></em> text is
|
1026
986
|
removed from the start, middle, or end of text so they
|
1027
987
|
fit within the width and height of layout set with
|
1028
|
-
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-width" title="pango_layout_set_width ()"><code class="function">pango_layout_set_width()</code></a> and <a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a
|
1029
|
-
</p>
|
988
|
+
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-width" title="pango_layout_set_width ()"><code class="function">pango_layout_set_width()</code></a> and <a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a>.</p>
|
1030
989
|
<p>
|
1031
990
|
If the layout contains characters such as newlines that
|
1032
991
|
force it to be layed out in multiple paragraphs, then whether
|
1033
992
|
each paragraph is ellipsized separately or the entire layout
|
1034
993
|
is ellipsized as a whole depends on the set height of the layout.
|
1035
|
-
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a> for details
|
1036
|
-
</p>
|
994
|
+
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" title="pango_layout_set_height ()"><code class="function">pango_layout_set_height()</code></a> for details.</p>
|
1037
995
|
<div class="variablelist"><table border="0" class="variablelist">
|
1038
996
|
<colgroup>
|
1039
997
|
<col align="left" valign="top">
|
@@ -1060,8 +1018,7 @@ See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-height" tit
|
|
1060
1018
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoEllipsizeMode"><span class="returnvalue">PangoEllipsizeMode</span></a> pango_layout_get_ellipsize (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1061
1019
|
<p>
|
1062
1020
|
Gets the type of ellipsization being performed for <em class="parameter"><code>layout</code></em>.
|
1063
|
-
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-ellipsize" title="pango_layout_set_ellipsize ()"><code class="function">pango_layout_set_ellipsize()</code></a>
|
1064
|
-
</p>
|
1021
|
+
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-ellipsize" title="pango_layout_set_ellipsize ()"><code class="function">pango_layout_set_ellipsize()</code></a></p>
|
1065
1022
|
<div class="variablelist"><table border="0" class="variablelist">
|
1066
1023
|
<colgroup>
|
1067
1024
|
<col align="left" valign="top">
|
@@ -1088,14 +1045,12 @@ were actually ellipsized.</td>
|
|
1088
1045
|
<a name="pango-layout-is-ellipsized"></a><h3>pango_layout_is_ellipsized ()</h3>
|
1089
1046
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_is_ellipsized (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1090
1047
|
<p>
|
1091
|
-
Queries whether the layout had to ellipsize any paragraphs
|
1092
|
-
</p>
|
1048
|
+
Queries whether the layout had to ellipsize any paragraphs.</p>
|
1093
1049
|
<p>
|
1094
1050
|
This returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the ellipsization mode for <em class="parameter"><code>layout</code></em>
|
1095
1051
|
is not <a class="link" href="pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a>, a positive width is set on <em class="parameter"><code>layout</code></em>,
|
1096
1052
|
and there are paragraphs exceeding that width that have to be
|
1097
|
-
ellipsized
|
1098
|
-
</p>
|
1053
|
+
ellipsized.</p>
|
1099
1054
|
<div class="variablelist"><table border="0" class="variablelist">
|
1100
1055
|
<colgroup>
|
1101
1056
|
<col align="left" valign="top">
|
@@ -1132,8 +1087,7 @@ The <a class="link" href="pango-Layout-Objects.html#PangoEllipsizeMode"><span cl
|
|
1132
1087
|
ellipsization should be applied to a line of text. In
|
1133
1088
|
the ellipsization process characters are removed from the
|
1134
1089
|
text in order to make it fit to a given width and replaced
|
1135
|
-
with an ellipsis
|
1136
|
-
</p>
|
1090
|
+
with an ellipsis.</p>
|
1137
1091
|
<div class="variablelist"><table border="0" class="variablelist">
|
1138
1092
|
<colgroup>
|
1139
1093
|
<col align="left" valign="top">
|
@@ -1178,12 +1132,10 @@ with an ellipsis.
|
|
1178
1132
|
Sets the width in Pango units to indent each paragraph. A negative value
|
1179
1133
|
of <em class="parameter"><code>indent</code></em> will produce a hanging indentation. That is, the first line will
|
1180
1134
|
have the full width, and subsequent lines will be indented by the
|
1181
|
-
absolute value of <em class="parameter"><code>indent</code></em
|
1182
|
-
</p>
|
1135
|
+
absolute value of <em class="parameter"><code>indent</code></em>.</p>
|
1183
1136
|
<p>
|
1184
1137
|
The indent setting is ignored if layout alignment is set to
|
1185
|
-
<a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-CENTER:CAPS"><code class="literal">PANGO_ALIGN_CENTER</code></a
|
1186
|
-
</p>
|
1138
|
+
<a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-CENTER:CAPS"><code class="literal">PANGO_ALIGN_CENTER</code></a>.</p>
|
1187
1139
|
<div class="variablelist"><table border="0" class="variablelist">
|
1188
1140
|
<colgroup>
|
1189
1141
|
<col align="left" valign="top">
|
@@ -1207,8 +1159,7 @@ The indent setting is ignored if layout alignment is set to
|
|
1207
1159
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_indent (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1208
1160
|
<p>
|
1209
1161
|
Gets the paragraph indent width in Pango units. A negative value
|
1210
|
-
indicates a hanging indentation
|
1211
|
-
</p>
|
1162
|
+
indicates a hanging indentation.</p>
|
1212
1163
|
<div class="variablelist"><table border="0" class="variablelist">
|
1213
1164
|
<colgroup>
|
1214
1165
|
<col align="left" valign="top">
|
@@ -1232,8 +1183,7 @@ indicates a hanging indentation.
|
|
1232
1183
|
<a name="pango-layout-get-spacing"></a><h3>pango_layout_get_spacing ()</h3>
|
1233
1184
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_spacing (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1234
1185
|
<p>
|
1235
|
-
Gets the amount of spacing between the lines of the layout
|
1236
|
-
</p>
|
1186
|
+
Gets the amount of spacing between the lines of the layout.</p>
|
1237
1187
|
<div class="variablelist"><table border="0" class="variablelist">
|
1238
1188
|
<colgroup>
|
1239
1189
|
<col align="left" valign="top">
|
@@ -1259,8 +1209,7 @@ Gets the amount of spacing between the lines of the layout.
|
|
1259
1209
|
<em class="parameter"><code><span class="type">int</span> spacing</code></em>);</pre>
|
1260
1210
|
<p>
|
1261
1211
|
Sets the amount of spacing in Pango unit between the lines of the
|
1262
|
-
layout
|
1263
|
-
</p>
|
1212
|
+
layout.</p>
|
1264
1213
|
<div class="variablelist"><table border="0" class="variablelist">
|
1265
1214
|
<colgroup>
|
1266
1215
|
<col align="left" valign="top">
|
@@ -1288,12 +1237,10 @@ Sets whether each complete line should be stretched to
|
|
1288
1237
|
fill the entire width of the layout. This stretching is typically
|
1289
1238
|
done by adding whitespace, but for some scripts (such as Arabic),
|
1290
1239
|
the justification may be done in more complex ways, like extending
|
1291
|
-
the characters
|
1292
|
-
</p>
|
1240
|
+
the characters.</p>
|
1293
1241
|
<p>
|
1294
1242
|
Note that this setting is not implemented and so is ignored in Pango
|
1295
|
-
older than 1.18
|
1296
|
-
</p>
|
1243
|
+
older than 1.18.</p>
|
1297
1244
|
<div class="variablelist"><table border="0" class="variablelist">
|
1298
1245
|
<colgroup>
|
1299
1246
|
<col align="left" valign="top">
|
@@ -1318,8 +1265,7 @@ older than 1.18.
|
|
1318
1265
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_get_justify (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1319
1266
|
<p>
|
1320
1267
|
Gets whether each complete line should be stretched to fill the entire
|
1321
|
-
width of the layout
|
1322
|
-
</p>
|
1268
|
+
width of the layout.</p>
|
1323
1269
|
<div class="variablelist"><table border="0" class="variablelist">
|
1324
1270
|
<colgroup>
|
1325
1271
|
<col align="left" valign="top">
|
@@ -1351,18 +1297,15 @@ when this flag is on (the default), then paragraphs in
|
|
1351
1297
|
(Arabic and Hebrew principally), will have right-to-left
|
1352
1298
|
layout, paragraphs with letters from other scripts will
|
1353
1299
|
have left-to-right layout. Paragraphs with only neutral
|
1354
|
-
characters get their direction from the surrounding paragraphs
|
1355
|
-
</p>
|
1300
|
+
characters get their direction from the surrounding paragraphs.</p>
|
1356
1301
|
<p>
|
1357
1302
|
When <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the choice between left-to-right and
|
1358
1303
|
right-to-left layout is done according to the base direction
|
1359
|
-
of the layout's <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>. (See <a class="link" href="pango-Text-Processing.html#pango-context-set-base-dir" title="pango_context_set_base_dir ()"><code class="function">pango_context_set_base_dir()</code></a>)
|
1360
|
-
</p>
|
1304
|
+
of the layout's <a class="link" href="pango-Text-Processing.html#PangoContext"><span class="type">PangoContext</span></a>. (See <a class="link" href="pango-Text-Processing.html#pango-context-set-base-dir" title="pango_context_set_base_dir ()"><code class="function">pango_context_set_base_dir()</code></a>).</p>
|
1361
1305
|
<p>
|
1362
1306
|
When the auto-computed direction of a paragraph differs from the
|
1363
1307
|
base direction of the context, the interpretation of
|
1364
|
-
<a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-LEFT:CAPS"><code class="literal">PANGO_ALIGN_LEFT</code></a> and <a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-RIGHT:CAPS"><code class="literal">PANGO_ALIGN_RIGHT</code></a> are swapped
|
1365
|
-
</p>
|
1308
|
+
<a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-LEFT:CAPS"><code class="literal">PANGO_ALIGN_LEFT</code></a> and <a class="link" href="pango-Layout-Objects.html#PANGO-ALIGN-RIGHT:CAPS"><code class="literal">PANGO_ALIGN_RIGHT</code></a> are swapped.</p>
|
1366
1309
|
<div class="variablelist"><table border="0" class="variablelist">
|
1367
1310
|
<colgroup>
|
1368
1311
|
<col align="left" valign="top">
|
@@ -1390,8 +1333,7 @@ from the layout's contents.</td>
|
|
1390
1333
|
<p>
|
1391
1334
|
Gets whether to calculate the bidirectional base direction
|
1392
1335
|
for the layout according to the contents of the layout.
|
1393
|
-
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-auto-dir" title="pango_layout_set_auto_dir ()"><code class="function">pango_layout_set_auto_dir()</code></a
|
1394
|
-
</p>
|
1336
|
+
See <a class="link" href="pango-Layout-Objects.html#pango-layout-set-auto-dir" title="pango_layout_set_auto_dir ()"><code class="function">pango_layout_set_auto_dir()</code></a>.</p>
|
1395
1337
|
<div class="variablelist"><table border="0" class="variablelist">
|
1396
1338
|
<colgroup>
|
1397
1339
|
<col align="left" valign="top">
|
@@ -1420,8 +1362,7 @@ is computed from the layout's contents, <a href="/home/kou/work/ruby/ruby-gnome2
|
|
1420
1362
|
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoAlignment"><span class="type">PangoAlignment</span></a> alignment</code></em>);</pre>
|
1421
1363
|
<p>
|
1422
1364
|
Sets the alignment for the layout: how partial lines are
|
1423
|
-
positioned within the horizontal space available
|
1424
|
-
</p>
|
1365
|
+
positioned within the horizontal space available.</p>
|
1425
1366
|
<div class="variablelist"><table border="0" class="variablelist">
|
1426
1367
|
<colgroup>
|
1427
1368
|
<col align="left" valign="top">
|
@@ -1446,8 +1387,7 @@ positioned within the horizontal space available.
|
|
1446
1387
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoAlignment"><span class="returnvalue">PangoAlignment</span></a> pango_layout_get_alignment (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1447
1388
|
<p>
|
1448
1389
|
Gets the alignment for the layout: how partial lines are
|
1449
|
-
positioned within the horizontal space available
|
1450
|
-
</p>
|
1390
|
+
positioned within the horizontal space available.</p>
|
1451
1391
|
<div class="variablelist"><table border="0" class="variablelist">
|
1452
1392
|
<colgroup>
|
1453
1393
|
<col align="left" valign="top">
|
@@ -1475,8 +1415,7 @@ positioned within the horizontal space available.
|
|
1475
1415
|
Sets the tabs to use for <em class="parameter"><code>layout</code></em>, overriding the default tabs
|
1476
1416
|
(by default, tabs are every 8 spaces). If <em class="parameter"><code>tabs</code></em> is <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default
|
1477
1417
|
tabs are reinstated. <em class="parameter"><code>tabs</code></em> is copied into the layout; you must
|
1478
|
-
free your copy of <em class="parameter"><code>tabs</code></em> yourself
|
1479
|
-
</p>
|
1418
|
+
free your copy of <em class="parameter"><code>tabs</code></em> yourself.</p>
|
1480
1419
|
<div class="variablelist"><table border="0" class="variablelist">
|
1481
1420
|
<colgroup>
|
1482
1421
|
<col align="left" valign="top">
|
@@ -1504,8 +1443,7 @@ free your copy of <em class="parameter"><code>tabs</code></em> yourself.
|
|
1504
1443
|
Gets the current <a class="link" href="pango-Tab-Stops.html#PangoTabArray"><span class="type">PangoTabArray</span></a> used by this layout. If no
|
1505
1444
|
<a class="link" href="pango-Tab-Stops.html#PangoTabArray"><span class="type">PangoTabArray</span></a> has been set, then the default tabs are in use
|
1506
1445
|
and <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned. Default tabs are every 8 spaces.
|
1507
|
-
The return value should be freed with <a class="link" href="pango-Tab-Stops.html#pango-tab-array-free" title="pango_tab_array_free ()"><code class="function">pango_tab_array_free()</code></a
|
1508
|
-
</p>
|
1446
|
+
The return value should be freed with <a class="link" href="pango-Tab-Stops.html#pango-tab-array-free" title="pango_tab_array_free ()"><code class="function">pango_tab_array_free()</code></a>.</p>
|
1509
1447
|
<div class="variablelist"><table border="0" class="variablelist">
|
1510
1448
|
<colgroup>
|
1511
1449
|
<col align="left" valign="top">
|
@@ -1534,8 +1472,7 @@ The return value should be freed with <a class="link" href="pango-Tab-Stops.html
|
|
1534
1472
|
If <em class="parameter"><code>setting</code></em> is <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, do not treat newlines and similar characters
|
1535
1473
|
as paragraph separators; instead, keep all text in a single paragraph,
|
1536
1474
|
and display a glyph for paragraph separator characters. Used when
|
1537
|
-
you want to allow editing of newlines on a single text line
|
1538
|
-
</p>
|
1475
|
+
you want to allow editing of newlines on a single text line.</p>
|
1539
1476
|
<div class="variablelist"><table border="0" class="variablelist">
|
1540
1477
|
<colgroup>
|
1541
1478
|
<col align="left" valign="top">
|
@@ -1560,8 +1497,7 @@ you want to allow editing of newlines on a single text line.
|
|
1560
1497
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_get_single_paragraph_mode
|
1561
1498
|
(<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
1562
1499
|
<p>
|
1563
|
-
Obtains the value set by <a class="link" href="pango-Layout-Objects.html#pango-layout-set-single-paragraph-mode" title="pango_layout_set_single_paragraph_mode ()"><code class="function">pango_layout_set_single_paragraph_mode()</code></a
|
1564
|
-
</p>
|
1500
|
+
Obtains the value set by <a class="link" href="pango-Layout-Objects.html#pango-layout-set-single-paragraph-mode" title="pango_layout_set_single_paragraph_mode ()"><code class="function">pango_layout_set_single_paragraph_mode()</code></a>.</p>
|
1565
1501
|
<div class="variablelist"><table border="0" class="variablelist">
|
1566
1502
|
<colgroup>
|
1567
1503
|
<col align="left" valign="top">
|
@@ -1594,8 +1530,7 @@ paragraph separator characters, <a href="/home/kou/work/ruby/ruby-gnome2.win32/g
|
|
1594
1530
|
<p>
|
1595
1531
|
A <a class="link" href="pango-Layout-Objects.html#PangoAlignment"><span class="type">PangoAlignment</span></a> describes how to align the lines of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> within the
|
1596
1532
|
available space. If the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> is set to justify
|
1597
|
-
using <a class="link" href="pango-Layout-Objects.html#pango-layout-set-justify" title="pango_layout_set_justify ()"><code class="function">pango_layout_set_justify()</code></a>, this only has effect for partial lines
|
1598
|
-
</p>
|
1533
|
+
using <a class="link" href="pango-Layout-Objects.html#pango-layout-set-justify" title="pango_layout_set_justify ()"><code class="function">pango_layout_set_justify()</code></a>, this only has effect for partial lines.</p>
|
1599
1534
|
<div class="variablelist"><table border="0" class="variablelist">
|
1600
1535
|
<colgroup>
|
1601
1536
|
<col align="left" valign="top">
|
@@ -1634,14 +1569,12 @@ using <a class="link" href="pango-Layout-Objects.html#pango-layout-set-justify"
|
|
1634
1569
|
<p>
|
1635
1570
|
Counts the number unknown glyphs in <em class="parameter"><code>layout</code></em>. That is, zero if
|
1636
1571
|
glyphs for all characters in the layout text were found, or more
|
1637
|
-
than zero otherwise
|
1638
|
-
</p>
|
1572
|
+
than zero otherwise.</p>
|
1639
1573
|
<p>
|
1640
1574
|
This function can be used to determine if there are any fonts
|
1641
1575
|
available to render all characters in a certain string, or when
|
1642
1576
|
used in combination with <a class="link" href="pango-Text-Attributes.html#PANGO-ATTR-FALLBACK:CAPS"><code class="literal">PANGO_ATTR_FALLBACK</code></a>, to check if a
|
1643
|
-
certain font supports all the characters in the string
|
1644
|
-
</p>
|
1577
|
+
certain font supports all the characters in the string.</p>
|
1645
1578
|
<div class="variablelist"><table border="0" class="variablelist">
|
1646
1579
|
<colgroup>
|
1647
1580
|
<col align="left" valign="top">
|
@@ -1669,8 +1602,7 @@ certain font supports all the characters in the string.
|
|
1669
1602
|
<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_attrs</code></em>);</pre>
|
1670
1603
|
<p>
|
1671
1604
|
Retrieves an array of logical attributes for each character in
|
1672
|
-
the <em class="parameter"><code>layout</code></em
|
1673
|
-
</p>
|
1605
|
+
the <em class="parameter"><code>layout</code></em>.</p>
|
1674
1606
|
<div class="variablelist"><table border="0" class="variablelist">
|
1675
1607
|
<colgroup>
|
1676
1608
|
<col align="left" valign="top">
|
@@ -1708,19 +1640,16 @@ and the position after the last character.). <span class="annotation">[<acronym
|
|
1708
1640
|
<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *n_attrs</code></em>);</pre>
|
1709
1641
|
<p>
|
1710
1642
|
Retrieves an array of logical attributes for each character in
|
1711
|
-
the <em class="parameter"><code>layout</code></em
|
1712
|
-
</p>
|
1643
|
+
the <em class="parameter"><code>layout</code></em>.</p>
|
1713
1644
|
<p>
|
1714
1645
|
This is a faster alternative to <a class="link" href="pango-Layout-Objects.html#pango-layout-get-log-attrs" title="pango_layout_get_log_attrs ()"><code class="function">pango_layout_get_log_attrs()</code></a>.
|
1715
1646
|
The returned array is part of <em class="parameter"><code>layout</code></em> and must not be modified.
|
1716
|
-
Modifying the layout will invalidate the returned array
|
1717
|
-
</p>
|
1647
|
+
Modifying the layout will invalidate the returned array.</p>
|
1718
1648
|
<p>
|
1719
1649
|
The number of attributes returned in <em class="parameter"><code>n_attrs</code></em> will be one more
|
1720
1650
|
than the total number of characters in the layout, since there
|
1721
1651
|
need to be attributes corresponding to both the position before
|
1722
|
-
the first character and the position after the last character
|
1723
|
-
</p>
|
1652
|
+
the first character and the position after the last character.</p>
|
1724
1653
|
<div class="variablelist"><table border="0" class="variablelist">
|
1725
1654
|
<colgroup>
|
1726
1655
|
<col align="left" valign="top">
|
@@ -1759,8 +1688,7 @@ corresponding to the grapheme at that index, which is represented
|
|
1759
1688
|
as rectangle. Note that <code class="literal">pos->x</code> is always the leading
|
1760
1689
|
edge of the grapheme and <code class="literal">pos->x + pos->width</code> the trailing
|
1761
1690
|
edge of the grapheme. If the directionality of the grapheme is right-to-left,
|
1762
|
-
then <code class="literal">pos->width</code> will be negative
|
1763
|
-
</p>
|
1691
|
+
then <code class="literal">pos->width</code> will be negative.</p>
|
1764
1692
|
<div class="variablelist"><table border="0" class="variablelist">
|
1765
1693
|
<colgroup>
|
1766
1694
|
<col align="left" valign="top">
|
@@ -1795,8 +1723,7 @@ then <code class="literal">pos->width</code> will be negative.
|
|
1795
1723
|
<em class="parameter"><code><span class="type">int</span> *x_pos</code></em>);</pre>
|
1796
1724
|
<p>
|
1797
1725
|
Converts from byte <em class="parameter"><code>index_</code></em> within the <em class="parameter"><code>layout</code></em> to line and X position.
|
1798
|
-
(X position is measured from the left edge of the line)
|
1799
|
-
</p>
|
1726
|
+
(X position is measured from the left edge of the line)</p>
|
1800
1727
|
<div class="variablelist"><table border="0" class="variablelist">
|
1801
1728
|
<colgroup>
|
1802
1729
|
<col align="left" valign="top">
|
@@ -1849,8 +1776,7 @@ Y position is not inside the layout, the closest position is chosen
|
|
1849
1776
|
X position is not within the layout, then the start or the
|
1850
1777
|
end of the line is chosen as described for <a class="link" href="pango-Layout-Objects.html#pango-layout-xy-to-index" title="pango_layout_xy_to_index ()"><code class="function">pango_layout_xy_to_index()</code></a>.
|
1851
1778
|
If either the X or Y positions were not inside the layout, then the
|
1852
|
-
function returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>; on an exact hit, it returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a
|
1853
|
-
</p>
|
1779
|
+
function returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>; on an exact hit, it returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.</p>
|
1854
1780
|
<div class="variablelist"><table border="0" class="variablelist">
|
1855
1781
|
<colgroup>
|
1856
1782
|
<col align="left" valign="top">
|
@@ -1908,8 +1834,7 @@ rectangle. The strong cursor location is the location where
|
|
1908
1834
|
characters of the directionality equal to the base direction of the
|
1909
1835
|
layout are inserted. The weak cursor location is the location
|
1910
1836
|
where characters of the directionality opposite to the base
|
1911
|
-
direction of the layout are inserted
|
1912
|
-
</p>
|
1837
|
+
direction of the layout are inserted.</p>
|
1913
1838
|
<div class="variablelist"><table border="0" class="variablelist">
|
1914
1839
|
<colgroup>
|
1915
1840
|
<col align="left" valign="top">
|
@@ -1955,20 +1880,17 @@ a count of positions to move visually. If <em class="parameter"><code>direction<
|
|
1955
1880
|
then the new strong cursor position will be one position
|
1956
1881
|
to the right of the old cursor position. If <em class="parameter"><code>direction</code></em> is negative,
|
1957
1882
|
then the new strong cursor position will be one position
|
1958
|
-
to the left of the old cursor position
|
1959
|
-
</p>
|
1883
|
+
to the left of the old cursor position.</p>
|
1960
1884
|
<p>
|
1961
1885
|
In the presence of bidirectional text, the correspondence
|
1962
1886
|
between logical and visual order will depend on the direction
|
1963
1887
|
of the current run, and there may be jumps when the cursor
|
1964
|
-
is moved off of the end of a run
|
1965
|
-
</p>
|
1888
|
+
is moved off of the end of a run.</p>
|
1966
1889
|
<p>
|
1967
1890
|
Motion here is in cursor positions, not in characters, so a
|
1968
1891
|
single call to <a class="link" href="pango-Layout-Objects.html#pango-layout-move-cursor-visually" title="pango_layout_move_cursor_visually ()"><code class="function">pango_layout_move_cursor_visually()</code></a> may move the
|
1969
1892
|
cursor over multiple characters when multiple characters combine
|
1970
|
-
to form a single grapheme
|
1971
|
-
</p>
|
1893
|
+
to form a single grapheme.</p>
|
1972
1894
|
<div class="variablelist"><table border="0" class="variablelist">
|
1973
1895
|
<colgroup>
|
1974
1896
|
<col align="left" valign="top">
|
@@ -2034,12 +1956,10 @@ are usually what you want for positioning things. Note that both extents
|
|
2034
1956
|
may have non-zero x and y. You may want to use those to offset where you
|
2035
1957
|
render the layout. Not doing that is a very typical bug that shows up as
|
2036
1958
|
right-to-left layouts not being correctly positioned in a layout with
|
2037
|
-
a set width
|
2038
|
-
</p>
|
1959
|
+
a set width.</p>
|
2039
1960
|
<p>
|
2040
1961
|
The extents are given in layout coordinates and in Pango units; layout
|
2041
|
-
coordinates begin at the top left corner of the layout
|
2042
|
-
</p>
|
1962
|
+
coordinates begin at the top left corner of the layout.</p>
|
2043
1963
|
<div class="variablelist"><table border="0" class="variablelist">
|
2044
1964
|
<colgroup>
|
2045
1965
|
<col align="left" valign="top">
|
@@ -2079,8 +1999,7 @@ Computes the logical and ink extents of <em class="parameter"><code>layout</code
|
|
2079
1999
|
This function just calls <a class="link" href="pango-Layout-Objects.html#pango-layout-get-extents" title="pango_layout_get_extents ()"><code class="function">pango_layout_get_extents()</code></a> followed by
|
2080
2000
|
two <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a> calls, rounding <em class="parameter"><code>ink_rect</code></em> and <em class="parameter"><code>logical_rect</code></em>
|
2081
2001
|
such that the rounded rectangles fully contain the unrounded one (that is,
|
2082
|
-
passes them as first argument to <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a>)
|
2083
|
-
</p>
|
2002
|
+
passes them as first argument to <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a>).</p>
|
2084
2003
|
<div class="variablelist"><table border="0" class="variablelist">
|
2085
2004
|
<colgroup>
|
2086
2005
|
<col align="left" valign="top">
|
@@ -2118,8 +2037,7 @@ result is not needed. <span class="annotation">[<acronym title="Parameter for re
|
|
2118
2037
|
<p>
|
2119
2038
|
Determines the logical width and height of a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>
|
2120
2039
|
in Pango units (device units scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>). This
|
2121
|
-
is simply a convenience function around <a class="link" href="pango-Layout-Objects.html#pango-layout-get-extents" title="pango_layout_get_extents ()"><code class="function">pango_layout_get_extents()</code></a
|
2122
|
-
</p>
|
2040
|
+
is simply a convenience function around <a class="link" href="pango-Layout-Objects.html#pango-layout-get-extents" title="pango_layout_get_extents ()"><code class="function">pango_layout_get_extents()</code></a>.</p>
|
2123
2041
|
<div class="variablelist"><table border="0" class="variablelist">
|
2124
2042
|
<colgroup>
|
2125
2043
|
<col align="left" valign="top">
|
@@ -2155,8 +2073,7 @@ Determines the logical width and height of a <a class="link" href="pango-Layout-
|
|
2155
2073
|
in device units. (<a class="link" href="pango-Layout-Objects.html#pango-layout-get-size" title="pango_layout_get_size ()"><code class="function">pango_layout_get_size()</code></a> returns the width
|
2156
2074
|
and height scaled by <a class="link" href="pango-Glyph-Storage.html#PANGO-SCALE:CAPS" title="PANGO_SCALE"><code class="literal">PANGO_SCALE</code></a>.) This
|
2157
2075
|
is simply a convenience function around
|
2158
|
-
<a class="link" href="pango-Layout-Objects.html#pango-layout-get-pixel-extents" title="pango_layout_get_pixel_extents ()"><code class="function">pango_layout_get_pixel_extents()</code></a
|
2159
|
-
</p>
|
2076
|
+
<a class="link" href="pango-Layout-Objects.html#pango-layout-get-pixel-extents" title="pango_layout_get_pixel_extents ()"><code class="function">pango_layout_get_pixel_extents()</code></a>.</p>
|
2160
2077
|
<div class="variablelist"><table border="0" class="variablelist">
|
2161
2078
|
<colgroup>
|
2162
2079
|
<col align="left" valign="top">
|
@@ -2186,8 +2103,7 @@ is simply a convenience function around
|
|
2186
2103
|
<a name="pango-layout-get-baseline"></a><h3>pango_layout_get_baseline ()</h3>
|
2187
2104
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_baseline (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
2188
2105
|
<p>
|
2189
|
-
Gets the Y position of baseline of the first line in <em class="parameter"><code>layout</code></em
|
2190
|
-
</p>
|
2106
|
+
Gets the Y position of baseline of the first line in <em class="parameter"><code>layout</code></em>.</p>
|
2191
2107
|
<div class="variablelist"><table border="0" class="variablelist">
|
2192
2108
|
<colgroup>
|
2193
2109
|
<col align="left" valign="top">
|
@@ -2212,8 +2128,7 @@ Gets the Y position of baseline of the first line in <em class="parameter"><code
|
|
2212
2128
|
<a name="pango-layout-get-line-count"></a><h3>pango_layout_get_line_count ()</h3>
|
2213
2129
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_get_line_count (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
2214
2130
|
<p>
|
2215
|
-
Retrieves the count of lines for the <em class="parameter"><code>layout</code></em
|
2216
|
-
</p>
|
2131
|
+
Retrieves the count of lines for the <em class="parameter"><code>layout</code></em>.</p>
|
2217
2132
|
<div class="variablelist"><table border="0" class="variablelist">
|
2218
2133
|
<colgroup>
|
2219
2134
|
<col align="left" valign="top">
|
@@ -2237,12 +2152,10 @@ Retrieves the count of lines for the <em class="parameter"><code>layout</code></
|
|
2237
2152
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * pango_layout_get_line (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>,
|
2238
2153
|
<em class="parameter"><code><span class="type">int</span> line</code></em>);</pre>
|
2239
2154
|
<p>
|
2240
|
-
Retrieves a particular line from a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a
|
2241
|
-
</p>
|
2155
|
+
Retrieves a particular line from a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
|
2242
2156
|
<p>
|
2243
2157
|
Use the faster <a class="link" href="pango-Layout-Objects.html#pango-layout-get-line-readonly" title="pango_layout_get_line_readonly ()"><code class="function">pango_layout_get_line_readonly()</code></a> if you do not plan
|
2244
|
-
to modify the contents of the line (glyphs, glyph widths, etc.)
|
2245
|
-
</p>
|
2158
|
+
to modify the contents of the line (glyphs, glyph widths, etc.).</p>
|
2246
2159
|
<div class="variablelist"><table border="0" class="variablelist">
|
2247
2160
|
<colgroup>
|
2248
2161
|
<col align="left" valign="top">
|
@@ -2276,13 +2189,11 @@ if changes are made to the <a class="link" href="pango-Layout-Objects.html#Pango
|
|
2276
2189
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * pango_layout_get_line_readonly (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>,
|
2277
2190
|
<em class="parameter"><code><span class="type">int</span> line</code></em>);</pre>
|
2278
2191
|
<p>
|
2279
|
-
Retrieves a particular line from a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a
|
2280
|
-
</p>
|
2192
|
+
Retrieves a particular line from a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.</p>
|
2281
2193
|
<p>
|
2282
2194
|
This is a faster alternative to <a class="link" href="pango-Layout-Objects.html#pango-layout-get-line" title="pango_layout_get_line ()"><code class="function">pango_layout_get_line()</code></a>,
|
2283
2195
|
but the user is not expected
|
2284
|
-
to modify the contents of the line (glyphs, glyph widths, etc.)
|
2285
|
-
</p>
|
2196
|
+
to modify the contents of the line (glyphs, glyph widths, etc.).</p>
|
2286
2197
|
<div class="variablelist"><table border="0" class="variablelist">
|
2287
2198
|
<colgroup>
|
2288
2199
|
<col align="left" valign="top">
|
@@ -2317,12 +2228,10 @@ No changes should be made to the line. <span class="annotation">[<acronym title=
|
|
2317
2228
|
<a name="pango-layout-get-lines"></a><h3>pango_layout_get_lines ()</h3>
|
2318
2229
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * pango_layout_get_lines (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
2319
2230
|
<p>
|
2320
|
-
Returns the lines of the <em class="parameter"><code>layout</code></em> as a list
|
2321
|
-
</p>
|
2231
|
+
Returns the lines of the <em class="parameter"><code>layout</code></em> as a list.</p>
|
2322
2232
|
<p>
|
2323
2233
|
Use the faster <a class="link" href="pango-Layout-Objects.html#pango-layout-get-lines-readonly" title="pango_layout_get_lines_readonly ()"><code class="function">pango_layout_get_lines_readonly()</code></a> if you do not plan
|
2324
|
-
to modify the contents of the lines (glyphs, glyph widths, etc.)
|
2325
|
-
</p>
|
2234
|
+
to modify the contents of the lines (glyphs, glyph widths, etc.).</p>
|
2326
2235
|
<div class="variablelist"><table border="0" class="variablelist">
|
2327
2236
|
<colgroup>
|
2328
2237
|
<col align="left" valign="top">
|
@@ -2350,13 +2259,11 @@ text or properties. <span class="annotation">[<acronym title="Generics and defin
|
|
2350
2259
|
<a name="pango-layout-get-lines-readonly"></a><h3>pango_layout_get_lines_readonly ()</h3>
|
2351
2260
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * pango_layout_get_lines_readonly (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
2352
2261
|
<p>
|
2353
|
-
Returns the lines of the <em class="parameter"><code>layout</code></em> as a list
|
2354
|
-
</p>
|
2262
|
+
Returns the lines of the <em class="parameter"><code>layout</code></em> as a list.</p>
|
2355
2263
|
<p>
|
2356
2264
|
This is a faster alternative to <a class="link" href="pango-Layout-Objects.html#pango-layout-get-lines" title="pango_layout_get_lines ()"><code class="function">pango_layout_get_lines()</code></a>,
|
2357
2265
|
but the user is not expected
|
2358
|
-
to modify the contents of the lines (glyphs, glyph widths, etc.)
|
2359
|
-
</p>
|
2266
|
+
to modify the contents of the lines (glyphs, glyph widths, etc.).</p>
|
2360
2267
|
<div class="variablelist"><table border="0" class="variablelist">
|
2361
2268
|
<colgroup>
|
2362
2269
|
<col align="left" valign="top">
|
@@ -2385,8 +2292,7 @@ text or properties. No changes should be made to the lines. <span class="annota
|
|
2385
2292
|
<a name="pango-layout-get-iter"></a><h3>pango_layout_get_iter ()</h3>
|
2386
2293
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="returnvalue">PangoLayoutIter</span></a> * pango_layout_get_iter (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> *layout</code></em>);</pre>
|
2387
2294
|
<p>
|
2388
|
-
Returns an iterator to iterate over the visual extents of the layout
|
2389
|
-
</p>
|
2295
|
+
Returns an iterator to iterate over the visual extents of the layout.</p>
|
2390
2296
|
<div class="variablelist"><table border="0" class="variablelist">
|
2391
2297
|
<colgroup>
|
2392
2298
|
<col align="left" valign="top">
|
@@ -2411,8 +2317,7 @@ Returns an iterator to iterate over the visual extents of the layout.
|
|
2411
2317
|
<a name="pango-layout-iter-copy"></a><h3>pango_layout_iter_copy ()</h3>
|
2412
2318
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="returnvalue">PangoLayoutIter</span></a> * pango_layout_iter_copy (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2413
2319
|
<p>
|
2414
|
-
Copies a <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a
|
2415
|
-
</p>
|
2320
|
+
Copies a <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a>.</p>
|
2416
2321
|
<div class="variablelist"><table border="0" class="variablelist">
|
2417
2322
|
<colgroup>
|
2418
2323
|
<col align="left" valign="top">
|
@@ -2439,8 +2344,7 @@ be freed with <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-
|
|
2439
2344
|
<a name="pango-layout-iter-free"></a><h3>pango_layout_iter_free ()</h3>
|
2440
2345
|
<pre class="programlisting"><span class="returnvalue">void</span> pango_layout_iter_free (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2441
2346
|
<p>
|
2442
|
-
Frees an iterator that's no longer in use
|
2443
|
-
</p>
|
2347
|
+
Frees an iterator that's no longer in use.</p>
|
2444
2348
|
<div class="variablelist"><table border="0" class="variablelist">
|
2445
2349
|
<colgroup>
|
2446
2350
|
<col align="left" valign="top">
|
@@ -2459,8 +2363,7 @@ Frees an iterator that's no longer in use.
|
|
2459
2363
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_iter_next_run (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2460
2364
|
<p>
|
2461
2365
|
Moves <em class="parameter"><code>iter</code></em> forward to the next run in visual order. If <em class="parameter"><code>iter</code></em> was
|
2462
|
-
already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a
|
2463
|
-
</p>
|
2366
|
+
already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
|
2464
2367
|
<div class="variablelist"><table border="0" class="variablelist">
|
2465
2368
|
<colgroup>
|
2466
2369
|
<col align="left" valign="top">
|
@@ -2485,8 +2388,7 @@ already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnom
|
|
2485
2388
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_iter_next_char (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2486
2389
|
<p>
|
2487
2390
|
Moves <em class="parameter"><code>iter</code></em> forward to the next character in visual order. If <em class="parameter"><code>iter</code></em> was already at
|
2488
|
-
the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a
|
2489
|
-
</p>
|
2391
|
+
the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
|
2490
2392
|
<div class="variablelist"><table border="0" class="variablelist">
|
2491
2393
|
<colgroup>
|
2492
2394
|
<col align="left" valign="top">
|
@@ -2511,8 +2413,7 @@ the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/gl
|
|
2511
2413
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_iter_next_cluster (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2512
2414
|
<p>
|
2513
2415
|
Moves <em class="parameter"><code>iter</code></em> forward to the next cluster in visual order. If <em class="parameter"><code>iter</code></em>
|
2514
|
-
was already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a
|
2515
|
-
</p>
|
2416
|
+
was already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
|
2516
2417
|
<div class="variablelist"><table border="0" class="variablelist">
|
2517
2418
|
<colgroup>
|
2518
2419
|
<col align="left" valign="top">
|
@@ -2537,8 +2438,7 @@ was already at the end of the layout, returns <a href="/home/kou/work/ruby/ruby-
|
|
2537
2438
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_iter_next_line (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2538
2439
|
<p>
|
2539
2440
|
Moves <em class="parameter"><code>iter</code></em> forward to the start of the next line. If <em class="parameter"><code>iter</code></em> is
|
2540
|
-
already on the last line, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a
|
2541
|
-
</p>
|
2441
|
+
already on the last line, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
|
2542
2442
|
<div class="variablelist"><table border="0" class="variablelist">
|
2543
2443
|
<colgroup>
|
2544
2444
|
<col align="left" valign="top">
|
@@ -2562,8 +2462,7 @@ already on the last line, returns <a href="/home/kou/work/ruby/ruby-gnome2.win32
|
|
2562
2462
|
<a name="pango-layout-iter-at-last-line"></a><h3>pango_layout_iter_at_last_line ()</h3>
|
2563
2463
|
<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_layout_iter_at_last_line (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2564
2464
|
<p>
|
2565
|
-
Determines whether <em class="parameter"><code>iter</code></em> is on the last line of the layout
|
2566
|
-
</p>
|
2465
|
+
Determines whether <em class="parameter"><code>iter</code></em> is on the last line of the layout.</p>
|
2567
2466
|
<div class="variablelist"><table border="0" class="variablelist">
|
2568
2467
|
<colgroup>
|
2569
2468
|
<col align="left" valign="top">
|
@@ -2591,8 +2490,7 @@ Determines whether <em class="parameter"><code>iter</code></em> is on the last l
|
|
2591
2490
|
Gets the current byte index. Note that iterating forward by char
|
2592
2491
|
moves in visual order, not logical order, so indexes may not be
|
2593
2492
|
sequential. Also, the index may be equal to the length of the text
|
2594
|
-
in the layout, if on the <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run (see <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-run" title="pango_layout_iter_get_run ()"><code class="function">pango_layout_iter_get_run()</code></a>)
|
2595
|
-
</p>
|
2493
|
+
in the layout, if on the <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run (see <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-run" title="pango_layout_iter_get_run ()"><code class="function">pango_layout_iter_get_run()</code></a>).</p>
|
2596
2494
|
<div class="variablelist"><table border="0" class="variablelist">
|
2597
2495
|
<colgroup>
|
2598
2496
|
<col align="left" valign="top">
|
@@ -2617,8 +2515,7 @@ in the layout, if on the <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/ve
|
|
2617
2515
|
<pre class="programlisting"><span class="returnvalue">int</span> pango_layout_iter_get_baseline (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2618
2516
|
<p>
|
2619
2517
|
Gets the Y position of the current line's baseline, in layout
|
2620
|
-
coordinates (origin at top left of the entire layout)
|
2621
|
-
</p>
|
2518
|
+
coordinates (origin at top left of the entire layout).</p>
|
2622
2519
|
<div class="variablelist"><table border="0" class="variablelist">
|
2623
2520
|
<colgroup>
|
2624
2521
|
<col align="left" valign="top">
|
@@ -2645,12 +2542,10 @@ coordinates (origin at top left of the entire layout).
|
|
2645
2542
|
Gets the current run. When iterating by run, at the end of each
|
2646
2543
|
line, there's a position with a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run, so this function can return
|
2647
2544
|
<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run at the end of each line ensures that all lines have
|
2648
|
-
at least one run, even lines consisting of only a newline
|
2649
|
-
</p>
|
2545
|
+
at least one run, even lines consisting of only a newline.</p>
|
2650
2546
|
<p>
|
2651
2547
|
Use the faster <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-run-readonly" title="pango_layout_iter_get_run_readonly ()"><code class="function">pango_layout_iter_get_run_readonly()</code></a> if you do not plan
|
2652
|
-
to modify the contents of the run (glyphs, glyph widths, etc.)
|
2653
|
-
</p>
|
2548
|
+
to modify the contents of the run (glyphs, glyph widths, etc.).</p>
|
2654
2549
|
<div class="variablelist"><table border="0" class="variablelist">
|
2655
2550
|
<colgroup>
|
2656
2551
|
<col align="left" valign="top">
|
@@ -2678,13 +2573,11 @@ to modify the contents of the run (glyphs, glyph widths, etc.).
|
|
2678
2573
|
Gets the current run. When iterating by run, at the end of each
|
2679
2574
|
line, there's a position with a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run, so this function can return
|
2680
2575
|
<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> run at the end of each line ensures that all lines have
|
2681
|
-
at least one run, even lines consisting of only a newline
|
2682
|
-
</p>
|
2576
|
+
at least one run, even lines consisting of only a newline.</p>
|
2683
2577
|
<p>
|
2684
2578
|
This is a faster alternative to <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-run" title="pango_layout_iter_get_run ()"><code class="function">pango_layout_iter_get_run()</code></a>,
|
2685
2579
|
but the user is not expected
|
2686
|
-
to modify the contents of the run (glyphs, glyph widths, etc.)
|
2687
|
-
</p>
|
2580
|
+
to modify the contents of the run (glyphs, glyph widths, etc.).</p>
|
2688
2581
|
<div class="variablelist"><table border="0" class="variablelist">
|
2689
2582
|
<colgroup>
|
2690
2583
|
<col align="left" valign="top">
|
@@ -2710,12 +2603,10 @@ to modify the contents of the run (glyphs, glyph widths, etc.).
|
|
2710
2603
|
<a name="pango-layout-iter-get-line"></a><h3>pango_layout_iter_get_line ()</h3>
|
2711
2604
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * pango_layout_iter_get_line (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2712
2605
|
<p>
|
2713
|
-
Gets the current line
|
2714
|
-
</p>
|
2606
|
+
Gets the current line.</p>
|
2715
2607
|
<p>
|
2716
2608
|
Use the faster <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-line-readonly" title="pango_layout_iter_get_line_readonly ()"><code class="function">pango_layout_iter_get_line_readonly()</code></a> if you do not plan
|
2717
|
-
to modify the contents of the line (glyphs, glyph widths, etc.)
|
2718
|
-
</p>
|
2609
|
+
to modify the contents of the line (glyphs, glyph widths, etc.).</p>
|
2719
2610
|
<div class="variablelist"><table border="0" class="variablelist">
|
2720
2611
|
<colgroup>
|
2721
2612
|
<col align="left" valign="top">
|
@@ -2739,13 +2630,11 @@ to modify the contents of the line (glyphs, glyph widths, etc.).
|
|
2739
2630
|
<a name="pango-layout-iter-get-line-readonly"></a><h3>pango_layout_iter_get_line_readonly ()</h3>
|
2740
2631
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * pango_layout_iter_get_line_readonly (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2741
2632
|
<p>
|
2742
|
-
Gets the current line for read-only access
|
2743
|
-
</p>
|
2633
|
+
Gets the current line for read-only access.</p>
|
2744
2634
|
<p>
|
2745
2635
|
This is a faster alternative to <a class="link" href="pango-Layout-Objects.html#pango-layout-iter-get-line" title="pango_layout_iter_get_line ()"><code class="function">pango_layout_iter_get_line()</code></a>,
|
2746
2636
|
but the user is not expected
|
2747
|
-
to modify the contents of the line (glyphs, glyph widths, etc.)
|
2748
|
-
</p>
|
2637
|
+
to modify the contents of the line (glyphs, glyph widths, etc.).</p>
|
2749
2638
|
<div class="variablelist"><table border="0" class="variablelist">
|
2750
2639
|
<colgroup>
|
2751
2640
|
<col align="left" valign="top">
|
@@ -2772,8 +2661,7 @@ modified. <span class="annotation">[<acronym title="Don't free data after the co
|
|
2772
2661
|
<a name="pango-layout-iter-get-layout"></a><h3>pango_layout_iter_get_layout ()</h3>
|
2773
2662
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * pango_layout_iter_get_layout (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a> *iter</code></em>);</pre>
|
2774
2663
|
<p>
|
2775
|
-
Gets the layout associated with a <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a
|
2776
|
-
</p>
|
2664
|
+
Gets the layout associated with a <a class="link" href="pango-Layout-Objects.html#PangoLayoutIter"><span class="type">PangoLayoutIter</span></a>.</p>
|
2777
2665
|
<div class="variablelist"><table border="0" class="variablelist">
|
2778
2666
|
<colgroup>
|
2779
2667
|
<col align="left" valign="top">
|
@@ -2803,8 +2691,7 @@ Gets the layout associated with a <a class="link" href="pango-Layout-Objects.htm
|
|
2803
2691
|
Gets the extents of the current character, in layout coordinates
|
2804
2692
|
(origin is the top left of the entire layout). Only logical extents
|
2805
2693
|
can sensibly be obtained for characters; ink extents make sense only
|
2806
|
-
down to the level of clusters
|
2807
|
-
</p>
|
2694
|
+
down to the level of clusters.</p>
|
2808
2695
|
<div class="variablelist"><table border="0" class="variablelist">
|
2809
2696
|
<colgroup>
|
2810
2697
|
<col align="left" valign="top">
|
@@ -2834,8 +2721,7 @@ logical extents. <span class="annotation">[<acronym title="Out parameter, where
|
|
2834
2721
|
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>
|
2835
2722
|
<p>
|
2836
2723
|
Gets the extents of the current cluster, in layout coordinates
|
2837
|
-
(origin is the top left of the entire layout)
|
2838
|
-
</p>
|
2724
|
+
(origin is the top left of the entire layout).</p>
|
2839
2725
|
<div class="variablelist"><table border="0" class="variablelist">
|
2840
2726
|
<colgroup>
|
2841
2727
|
<col align="left" valign="top">
|
@@ -2868,8 +2754,7 @@ Gets the extents of the current cluster, in layout coordinates
|
|
2868
2754
|
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoRectangle" title="struct PangoRectangle"><span class="type">PangoRectangle</span></a> *logical_rect</code></em>);</pre>
|
2869
2755
|
<p>
|
2870
2756
|
Gets the extents of the current run in layout coordinates
|
2871
|
-
(origin is the top left of the entire layout)
|
2872
|
-
</p>
|
2757
|
+
(origin is the top left of the entire layout).</p>
|
2873
2758
|
<div class="variablelist"><table border="0" class="variablelist">
|
2874
2759
|
<colgroup>
|
2875
2760
|
<col align="left" valign="top">
|
@@ -2907,8 +2792,7 @@ the current line. A line's range includes the line's logical
|
|
2907
2792
|
extents, plus half of the spacing above and below the line, if
|
2908
2793
|
<a class="link" href="pango-Layout-Objects.html#pango-layout-set-spacing" title="pango_layout_set_spacing ()"><code class="function">pango_layout_set_spacing()</code></a> has been called to set layout spacing.
|
2909
2794
|
The Y positions are in layout coordinates (origin at top left of the
|
2910
|
-
entire layout)
|
2911
|
-
</p>
|
2795
|
+
entire layout).</p>
|
2912
2796
|
<div class="variablelist"><table border="0" class="variablelist">
|
2913
2797
|
<colgroup>
|
2914
2798
|
<col align="left" valign="top">
|
@@ -2945,8 +2829,7 @@ can be <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/g
|
|
2945
2829
|
coordinates (origin is the top-left corner of the entire
|
2946
2830
|
<a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>). Thus the extents returned by this function will be
|
2947
2831
|
the same width/height but not at the same x/y as the extents
|
2948
|
-
returned from <a class="link" href="pango-Layout-Objects.html#pango-layout-line-get-extents" title="pango_layout_line_get_extents ()"><code class="function">pango_layout_line_get_extents()</code></a
|
2949
|
-
</p>
|
2832
|
+
returned from <a class="link" href="pango-Layout-Objects.html#pango-layout-line-get-extents" title="pango_layout_line_get_extents ()"><code class="function">pango_layout_line_get_extents()</code></a>.</p>
|
2950
2833
|
<div class="variablelist"><table border="0" class="variablelist">
|
2951
2834
|
<colgroup>
|
2952
2835
|
<col align="left" valign="top">
|
@@ -2981,8 +2864,7 @@ returned from <a class="link" href="pango-Layout-Objects.html#pango-layout-line-
|
|
2981
2864
|
<p>
|
2982
2865
|
Obtains the extents of the <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> being iterated
|
2983
2866
|
over. <em class="parameter"><code>ink_rect</code></em> or <em class="parameter"><code>logical_rect</code></em> can be <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if you
|
2984
|
-
aren't interested in them
|
2985
|
-
</p>
|
2867
|
+
aren't interested in them.</p>
|
2986
2868
|
<div class="variablelist"><table border="0" class="variablelist">
|
2987
2869
|
<colgroup>
|
2988
2870
|
<col align="left" valign="top">
|
@@ -3026,12 +2908,10 @@ The <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class
|
|
3026
2908
|
from laying out a paragraph via <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>. <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
|
3027
2909
|
structures are obtained by calling <a class="link" href="pango-Layout-Objects.html#pango-layout-get-line" title="pango_layout_get_line ()"><code class="function">pango_layout_get_line()</code></a> and
|
3028
2910
|
are only valid until the text, attributes, or settings of the
|
3029
|
-
parent <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> are modified
|
3030
|
-
</p>
|
2911
|
+
parent <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> are modified.</p>
|
3031
2912
|
<p>
|
3032
2913
|
Routines for rendering PangoLayout objects are provided in
|
3033
|
-
code specific to each rendering system
|
3034
|
-
</p>
|
2914
|
+
code specific to each rendering system.</p>
|
3035
2915
|
<div class="variablelist"><table border="0" class="variablelist">
|
3036
2916
|
<colgroup>
|
3037
2917
|
<col align="left" valign="top">
|
@@ -3076,16 +2956,14 @@ code specific to each rendering system.
|
|
3076
2956
|
The <a class="link" href="pango-Layout-Objects.html#PangoLayoutRun" title="PangoLayoutRun"><span class="type">PangoLayoutRun</span></a> structure represents a single run within
|
3077
2957
|
a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>; it is simply an alternate name for
|
3078
2958
|
<a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a>.
|
3079
|
-
See the <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> docs for details on the fields
|
3080
|
-
</p>
|
2959
|
+
See the <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> docs for details on the fields.</p>
|
3081
2960
|
</div>
|
3082
2961
|
<hr>
|
3083
2962
|
<div class="refsect2">
|
3084
2963
|
<a name="pango-layout-line-ref"></a><h3>pango_layout_line_ref ()</h3>
|
3085
2964
|
<pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * pango_layout_line_ref (<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>);</pre>
|
3086
2965
|
<p>
|
3087
|
-
Increase the reference count of a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> by one
|
3088
|
-
</p>
|
2966
|
+
Increase the reference count of a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> by one.</p>
|
3089
2967
|
<div class="variablelist"><table border="0" class="variablelist">
|
3090
2968
|
<colgroup>
|
3091
2969
|
<col align="left" valign="top">
|
@@ -3112,8 +2990,7 @@ Increase the reference count of a <a class="link" href="pango-Layout-Objects.htm
|
|
3112
2990
|
<p>
|
3113
2991
|
Decrease the reference count of a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> by one.
|
3114
2992
|
If the result is zero, the line and all associated memory
|
3115
|
-
will be freed
|
3116
|
-
</p>
|
2993
|
+
will be freed.</p>
|
3117
2994
|
<div class="variablelist"><table border="0" class="variablelist">
|
3118
2995
|
<colgroup>
|
3119
2996
|
<col align="left" valign="top">
|
@@ -3135,8 +3012,7 @@ will be freed.
|
|
3135
3012
|
<p>
|
3136
3013
|
Computes the logical and ink extents of a layout line. See
|
3137
3014
|
<a class="link" href="pango-Fonts.html#pango-font-get-glyph-extents" title="pango_font_get_glyph_extents ()"><code class="function">pango_font_get_glyph_extents()</code></a> for details about the interpretation
|
3138
|
-
of the rectangles
|
3139
|
-
</p>
|
3015
|
+
of the rectangles.</p>
|
3140
3016
|
<div class="variablelist"><table border="0" class="variablelist">
|
3141
3017
|
<colgroup>
|
3142
3018
|
<col align="left" valign="top">
|
@@ -3174,8 +3050,7 @@ Computes the logical and ink extents of <em class="parameter"><code>layout_line<
|
|
3174
3050
|
This function just calls <a class="link" href="pango-Layout-Objects.html#pango-layout-line-get-extents" title="pango_layout_line_get_extents ()"><code class="function">pango_layout_line_get_extents()</code></a> followed by
|
3175
3051
|
two <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a> calls, rounding <em class="parameter"><code>ink_rect</code></em> and <em class="parameter"><code>logical_rect</code></em>
|
3176
3052
|
such that the rounded rectangles fully contain the unrounded one (that is,
|
3177
|
-
passes them as first argument to <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a>)
|
3178
|
-
</p>
|
3053
|
+
passes them as first argument to <a class="link" href="pango-Glyph-Storage.html#pango-extents-to-pixels" title="pango_extents_to_pixels ()"><code class="function">pango_extents_to_pixels()</code></a>).</p>
|
3179
3054
|
<div class="variablelist"><table border="0" class="variablelist">
|
3180
3055
|
<colgroup>
|
3181
3056
|
<col align="left" valign="top">
|
@@ -3210,8 +3085,7 @@ extents of the glyph string, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/g
|
|
3210
3085
|
<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> trailing</code></em>,
|
3211
3086
|
<em class="parameter"><code><span class="type">int</span> *x_pos</code></em>);</pre>
|
3212
3087
|
<p>
|
3213
|
-
Converts an index within a line to a X position
|
3214
|
-
</p>
|
3088
|
+
Converts an index within a line to a X position.</p>
|
3215
3089
|
<div class="variablelist"><table border="0" class="variablelist">
|
3216
3090
|
<colgroup>
|
3217
3091
|
<col align="left" valign="top">
|
@@ -3258,8 +3132,7 @@ right-to-left, then an X position to the right of the line (after it)
|
|
3258
3132
|
results in 0 being stored in <em class="parameter"><code>index_</code></em> and <em class="parameter"><code>trailing</code></em>. An X position to the
|
3259
3133
|
left of the line results in <em class="parameter"><code>index_</code></em> pointing to the (logical) last
|
3260
3134
|
grapheme in the line and <em class="parameter"><code>trailing</code></em> being set to the number of characters
|
3261
|
-
in that grapheme. The reverse is true for a left-to-right line
|
3262
|
-
</p>
|
3135
|
+
in that grapheme. The reverse is true for a left-to-right line.</p>
|
3263
3136
|
<div class="variablelist"><table border="0" class="variablelist">
|
3264
3137
|
<colgroup>
|
3265
3138
|
<col align="left" valign="top">
|
@@ -3311,8 +3184,7 @@ Gets a list of visual ranges corresponding to a given logical range.
|
|
3311
3184
|
This list is not necessarily minimal - there may be consecutive
|
3312
3185
|
ranges which are adjacent. The ranges will be sorted from left to
|
3313
3186
|
right. The ranges are with respect to the left edge of the entire
|
3314
|
-
layout, not with respect to the line
|
3315
|
-
</p>
|
3187
|
+
layout, not with respect to the line.</p>
|
3316
3188
|
<div class="variablelist"><table border="0" class="variablelist">
|
3317
3189
|
<colgroup>
|
3318
3190
|
<col align="left" valign="top">
|
@@ -3361,6 +3233,6 @@ to the layout and are in Pango units. <span class="annotation">[<acronym title="
|
|
3361
3233
|
</div>
|
3362
3234
|
<div class="footer">
|
3363
3235
|
<hr>
|
3364
|
-
Generated by GTK-Doc V1.19</div>
|
3236
|
+
Generated by GTK-Doc V1.19.1</div>
|
3365
3237
|
</body>
|
3366
3238
|
</html>
|