pango 2.1.0-x86-mingw32 → 2.2.0-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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>
|