4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>PangoRenderer</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="Pango Reference Manual">
8
8
<link rel="up" href="lowlevel.html" title="Low Level Functionality">
9
9
<link rel="prev" href="lowlevel.html" title="Low Level Functionality">
10
10
<link rel="next" href="PangoFcFontMap.html" title="PangoFcFontMap">
11
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
39
39
</tr></table></div>
40
40
<div class="refsynopsisdiv">
41
41
<a name="pango-pango-renderer.synopsis"></a><h2>Synopsis</h2>
42
<a name="PangoRenderer"></a><pre class="synopsis">struct <a class="link" href="pango-pango-renderer.html#PangoRenderer-struct" title="struct PangoRenderer">PangoRenderer</a>;
43
enum <a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart">PangoRenderPart</a>;
42
<a name="PangoRenderer"></a><a name="PangoRenderPart"></a><pre class="synopsis">struct <a class="link" href="pango-pango-renderer.html#PangoRenderer-struct" title="struct PangoRenderer">PangoRenderer</a>;
43
enum <a class="link" href="pango-pango-renderer.html#PangoRenderPart-enum" title="enum PangoRenderPart">PangoRenderPart</a>;
44
44
#define <a class="link" href="pango-pango-renderer.html#PANGO-TYPE-RENDER-PART:CAPS" title="PANGO_TYPE_RENDER_PART">PANGO_TYPE_RENDER_PART</a>
45
45
struct <a class="link" href="pango-pango-renderer.html#PangoRendererClass" title="struct PangoRendererClass">PangoRendererClass</a>;
46
46
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-layout" title="pango_renderer_draw_layout ()">pango_renderer_draw_layout</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
48
48
<em class="parameter"><code><span class="type">int</span> x</code></em>,
49
49
<em class="parameter"><code><span class="type">int</span> y</code></em>);
50
50
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-layout-line" title="pango_renderer_draw_layout_line ()">pango_renderer_draw_layout_line</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
51
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="struct PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
51
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
52
52
<em class="parameter"><code><span class="type">int</span> x</code></em>,
53
53
<em class="parameter"><code><span class="type">int</span> y</code></em>);
54
54
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-glyphs" title="pango_renderer_draw_glyphs ()">pango_renderer_draw_glyphs</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
55
55
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
56
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="struct PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
56
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
57
57
<em class="parameter"><code><span class="type">int</span> x</code></em>,
58
58
<em class="parameter"><code><span class="type">int</span> y</code></em>);
59
59
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-glyph-item" title="pango_renderer_draw_glyph_item ()">pango_renderer_draw_glyph_item</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
60
60
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
61
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem" title="struct PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> *glyph_item</code></em>,
61
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> *glyph_item</code></em>,
62
62
<em class="parameter"><code><span class="type">int</span> x</code></em>,
63
63
<em class="parameter"><code><span class="type">int</span> y</code></em>);
64
64
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-rectangle" title="pango_renderer_draw_rectangle ()">pango_renderer_draw_rectangle</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
65
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
65
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
66
66
<em class="parameter"><code><span class="type">int</span> x</code></em>,
67
67
<em class="parameter"><code><span class="type">int</span> y</code></em>,
68
68
<em class="parameter"><code><span class="type">int</span> width</code></em>,
73
73
<em class="parameter"><code><span class="type">int</span> width</code></em>,
74
74
<em class="parameter"><code><span class="type">int</span> height</code></em>);
75
75
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-draw-trapezoid" title="pango_renderer_draw_trapezoid ()">pango_renderer_draw_trapezoid</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
76
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
76
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
77
77
<em class="parameter"><code><span class="type">double</span> y1_</code></em>,
78
78
<em class="parameter"><code><span class="type">double</span> x11</code></em>,
79
79
<em class="parameter"><code><span class="type">double</span> x21</code></em>,
88
88
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-activate" title="pango_renderer_activate ()">pango_renderer_activate</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
89
89
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-deactivate" title="pango_renderer_deactivate ()">pango_renderer_deactivate</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
90
90
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-part-changed" title="pango_renderer_part_changed ()">pango_renderer_part_changed</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
91
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);
91
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);
92
92
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-set-color" title="pango_renderer_set_color ()">pango_renderer_set_color</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
93
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
94
<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor" title="struct PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);
95
<a class="link" href="pango-Text-Attributes.html#PangoColor" title="struct PangoColor"><span class="returnvalue">PangoColor</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-color" title="pango_renderer_get_color ()">pango_renderer_get_color</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
96
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);
93
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
94
<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);
95
<a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-color" title="pango_renderer_get_color ()">pango_renderer_get_color</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
96
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);
97
97
<span class="returnvalue">void</span> <a class="link" href="pango-pango-renderer.html#pango-renderer-set-matrix" title="pango_renderer_set_matrix ()">pango_renderer_set_matrix</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
98
<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="struct PangoMatrix"><span class="type">PangoMatrix</span></a> *matrix</code></em>);
99
const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="struct PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-matrix" title="pango_renderer_get_matrix ()">pango_renderer_get_matrix</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
98
<em class="parameter"><code>const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a> *matrix</code></em>);
99
const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="returnvalue">PangoMatrix</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-matrix" title="pango_renderer_get_matrix ()">pango_renderer_get_matrix</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
100
100
<a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-layout" title="pango_renderer_get_layout ()">pango_renderer_get_layout</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
101
<a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="struct PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-layout-line" title="pango_renderer_get_layout_line ()">pango_renderer_get_layout_line</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
101
<a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="returnvalue">PangoLayoutLine</span></a> * <a class="link" href="pango-pango-renderer.html#pango-renderer-get-layout-line" title="pango_renderer_get_layout_line ()">pango_renderer_get_layout_line</a> (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>);
104
104
<div class="refsect1">
105
105
<a name="pango-pango-renderer.object-hierarchy"></a><h2>Object Hierarchy</h2>
106
106
<pre class="synopsis">
107
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
108
108
+----PangoRenderer
109
109
+----<a class="link" href="pango-Xft-Fonts-and-Rendering.html#PangoXftRenderer">PangoXftRenderer</a>
111
<pre class="synopsis">
112
116
<div class="refsect1">
113
117
<a name="pango-pango-renderer.description"></a><h2>Description</h2>
115
119
<a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> is a base class that contains the necessary logic for
116
rendering a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> or <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="struct PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>. By subclassing
120
rendering a <a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> or <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>. By subclassing
117
121
<a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> and overriding operations such as <em class="parameter"><code>draw_glyphs</code></em> and
118
122
<em class="parameter"><code>draw_rectangle</code></em>, renderers for particular font backends and
119
123
destinations can be created.
131
135
<a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> is a base class for objects that are used to
132
render Pango objects such as <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="struct PangoGlyphString"><span class="type">PangoGlyphString</span></a> and
136
render Pango objects such as <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> and
133
137
<a class="link" href="pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>.
135
139
<div class="variablelist"><table border="0">
136
140
<col align="left" valign="top">
138
<td><p><span class="term"><a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="struct PangoMatrix"><span class="type">PangoMatrix</span></a> *<em class="structfield"><code><a name="PangoRenderer-struct.matrix"></a>matrix</code></em>;</span></p></td>
142
<td><p><span class="term"><a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a> *<em class="structfield"><code><a name="PangoRenderer-struct.matrix"></a>matrix</code></em>;</span></p></td>
139
143
<td>the current transformation matrix for the Renderer; may
140
be <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, which should be treated the same as the identity matrix.
144
be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, which should be treated the same as the identity matrix.</td>
144
147
<p class="since">Since 1.8</p>
147
150
<div class="refsect2">
148
<a name="PangoRenderPart"></a><h3>enum PangoRenderPart</h3>
149
<pre class="programlisting">typedef enum
151
<a name="PangoRenderPart-enum"></a><h3>enum PangoRenderPart</h3>
152
<pre class="programlisting">typedef enum {
151
153
PANGO_RENDER_PART_FOREGROUND,
152
154
PANGO_RENDER_PART_BACKGROUND,
153
155
PANGO_RENDER_PART_UNDERLINE,
276
278
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-glyphs"></a>draw_glyphs</code></em> ()</span></p></td>
277
<td>draws a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="struct PangoGlyphString"><span class="type">PangoGlyphString</span></a>
279
<td>draws a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>
281
283
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-rectangle"></a>draw_rectangle</code></em> ()</span></p></td>
282
<td>draws a rectangle
284
<td>draws a rectangle</td>
286
287
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-error-underline"></a>draw_error_underline</code></em> ()</span></p></td>
287
288
<td>draws a squiggly line that approximately
288
289
covers the given rectangle in the style of an underline used to
289
indicate a spelling error.
290
indicate a spelling error.</td>
293
293
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-shape"></a>draw_shape</code></em> ()</span></p></td>
294
294
<td>draw content for a glyph shaped with <a class="link" href="pango-Text-Attributes.html#PangoAttrShape" title="struct PangoAttrShape"><span class="type">PangoAttrShape</span></a>.
295
<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em> are the coordinates of the left edge of the baseline,
295
<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em> are the coordinates of the left edge of the baseline,
296
in user coordinates.</td>
300
299
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-trapezoid"></a>draw_trapezoid</code></em> ()</span></p></td>
301
<td>draws a trapezoidal filled area
300
<td>draws a trapezoidal filled area</td>
305
303
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-glyph"></a>draw_glyph</code></em> ()</span></p></td>
306
<td>draws a single glyph
304
<td>draws a single glyph</td>
310
307
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.part-changed"></a>part_changed</code></em> ()</span></p></td>
311
308
<td>do renderer specific processing when rendering
309
attributes change</td>
316
312
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.begin"></a>begin</code></em> ()</span></p></td>
317
<td>Do renderer-specific initialization before drawing
313
<td>Do renderer-specific initialization before drawing</td>
321
316
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.end"></a>end</code></em> ()</span></p></td>
322
<td>Do renderer-specific cleanup after drawing
317
<td>Do renderer-specific cleanup after drawing</td>
326
320
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.prepare-run"></a>prepare_run</code></em> ()</span></p></td>
327
<td>updates the renderer for a new run
321
<td>updates the renderer for a new run</td>
331
324
<td><p><span class="term"><em class="structfield"><code><a name="PangoRendererClass.draw-glyph-item"></a>draw_glyph_item</code></em> ()</span></p></td>
332
<td>draws a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem" title="struct PangoGlyphItem"><span class="type">PangoGlyphItem</span></a>
325
<td>draws a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a>
379
370
<div class="refsect2">
380
371
<a name="pango-renderer-draw-layout-line"></a><h3>pango_renderer_draw_layout_line ()</h3>
381
372
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_draw_layout_line (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
382
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="struct PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
373
<em class="parameter"><code><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a> *line</code></em>,
383
374
<em class="parameter"><code><span class="type">int</span> x</code></em>,
384
375
<em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
397
388
<td><p><span class="term"><em class="parameter"><code>line</code></em> :</span></p></td>
398
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine" title="struct PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
389
<td>a <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine"><span class="type">PangoLayoutLine</span></a>
402
393
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
403
394
<td>X position of left edge of baseline, in user space coordinates
408
398
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
409
399
<td>Y position of left edge of baseline, in user space coordinates
419
408
<a name="pango-renderer-draw-glyphs"></a><h3>pango_renderer_draw_glyphs ()</h3>
420
409
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_draw_glyphs (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
421
410
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoFont"><span class="type">PangoFont</span></a> *font</code></em>,
422
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="struct PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
411
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a> *glyphs</code></em>,
423
412
<em class="parameter"><code><span class="type">int</span> x</code></em>,
424
413
<em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
442
431
<td><p><span class="term"><em class="parameter"><code>glyphs</code></em> :</span></p></td>
443
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString" title="struct PangoGlyphString"><span class="type">PangoGlyphString</span></a>
432
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString"><span class="type">PangoGlyphString</span></a>
447
436
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
448
437
<td>X position of left edge of baseline, in user space coordinates
453
441
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
454
442
<td>Y position of left edge of baseline, in user space coordinates
464
451
<a name="pango-renderer-draw-glyph-item"></a><h3>pango_renderer_draw_glyph_item ()</h3>
465
452
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_draw_glyph_item (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
466
453
<em class="parameter"><code>const <span class="type">char</span> *text</code></em>,
467
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem" title="struct PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> *glyph_item</code></em>,
454
<em class="parameter"><code><a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a> *glyph_item</code></em>,
468
455
<em class="parameter"><code><span class="type">int</span> x</code></em>,
469
456
<em class="parameter"><code><span class="type">int</span> y</code></em>);</pre>
495
482
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
496
<td>the UTF-8 text that <em class="parameter"><code>glyph_item</code></em> refers to, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
483
<td>the UTF-8 text that <em class="parameter"><code>glyph_item</code></em> refers to, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
500
487
<td><p><span class="term"><em class="parameter"><code>glyph_item</code></em> :</span></p></td>
501
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem" title="struct PangoGlyphItem"><span class="type">PangoGlyphItem</span></a>
488
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoGlyphItem"><span class="type">PangoGlyphItem</span></a>
505
492
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
506
493
<td>X position of left edge of baseline, in user space coordinates
511
497
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
512
498
<td>Y position of left edge of baseline, in user space coordinates
521
506
<div class="refsect2">
522
507
<a name="pango-renderer-draw-rectangle"></a><h3>pango_renderer_draw_rectangle ()</h3>
523
508
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_draw_rectangle (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
524
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
509
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
525
510
<em class="parameter"><code><span class="type">int</span> x</code></em>,
526
511
<em class="parameter"><code><span class="type">int</span> y</code></em>,
527
512
<em class="parameter"><code><span class="type">int</span> width</code></em>,
546
531
<td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
547
<td>type of object this rectangle is part of
532
<td>type of object this rectangle is part of</td>
551
535
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
552
<td>X position at which to draw rectangle, in user space coordinates in Pango units
536
<td>X position at which to draw rectangle, in user space coordinates in Pango units</td>
556
539
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
557
<td>Y position at which to draw rectangle, in user space coordinates in Pango units
540
<td>Y position at which to draw rectangle, in user space coordinates in Pango units</td>
561
543
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
562
<td>width of rectangle in Pango units in user space coordinates
544
<td>width of rectangle in Pango units in user space coordinates</td>
566
547
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
567
<td>height of rectangle in Pango units in user space coordinates
548
<td>height of rectangle in Pango units in user space coordinates</td>
602
582
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
603
<td>X coordinate of underline, in Pango units in user coordinate system
583
<td>X coordinate of underline, in Pango units in user coordinate system</td>
607
586
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
608
<td>Y coordinate of underline, in Pango units in user coordinate system
587
<td>Y coordinate of underline, in Pango units in user coordinate system</td>
612
590
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
613
<td>width of underline, in Pango units in user coordinate system
591
<td>width of underline, in Pango units in user coordinate system</td>
617
594
<td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
618
<td>height of underline, in Pango units in user coordinate system
595
<td>height of underline, in Pango units in user coordinate system</td>
626
602
<div class="refsect2">
627
603
<a name="pango-renderer-draw-trapezoid"></a><h3>pango_renderer_draw_trapezoid ()</h3>
628
604
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_draw_trapezoid (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
629
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
605
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
630
606
<em class="parameter"><code><span class="type">double</span> y1_</code></em>,
631
607
<em class="parameter"><code><span class="type">double</span> x11</code></em>,
632
608
<em class="parameter"><code><span class="type">double</span> x21</code></em>,
649
625
<td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
650
<td>type of object this trapezoid is part of
626
<td>type of object this trapezoid is part of</td>
654
629
<td><p><span class="term"><em class="parameter"><code>y1_</code></em> :</span></p></td>
655
<td>Y coordinate of top of trapezoid
630
<td>Y coordinate of top of trapezoid</td>
659
633
<td><p><span class="term"><em class="parameter"><code>x11</code></em> :</span></p></td>
660
<td>X coordinate of left end of top of trapezoid
634
<td>X coordinate of left end of top of trapezoid</td>
664
637
<td><p><span class="term"><em class="parameter"><code>x21</code></em> :</span></p></td>
665
<td>X coordinate of right end of top of trapezoid
638
<td>X coordinate of right end of top of trapezoid</td>
669
641
<td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
670
<td>Y coordinate of bottom of trapezoid
642
<td>Y coordinate of bottom of trapezoid</td>
674
645
<td><p><span class="term"><em class="parameter"><code>x12</code></em> :</span></p></td>
675
<td>X coordinate of left end of bottom of trapezoid
646
<td>X coordinate of left end of bottom of trapezoid</td>
679
649
<td><p><span class="term"><em class="parameter"><code>x22</code></em> :</span></p></td>
680
<td>X coordinate of right end of bottom of trapezoid
650
<td>X coordinate of right end of bottom of trapezoid</td>
712
681
<td><p><span class="term"><em class="parameter"><code>glyph</code></em> :</span></p></td>
713
<td>the glyph index of a single glyph
682
<td>the glyph index of a single glyph</td>
717
685
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
718
<td>X coordinate of left edge of baseline of glyph
686
<td>X coordinate of left edge of baseline of glyph</td>
722
689
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
723
<td>Y coordinate of left edge of baseline of glyph
690
<td>Y coordinate of left edge of baseline of glyph</td>
772
738
<div class="refsect2">
773
739
<a name="pango-renderer-part-changed"></a><h3>pango_renderer_part_changed ()</h3>
774
740
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_part_changed (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
775
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);</pre>
741
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);</pre>
777
743
Informs Pango that the way that the rendering is done
778
744
for <em class="parameter"><code>part</code></em> has changed in a way that would prevent multiple
821
786
<div class="refsect2">
822
787
<a name="pango-renderer-set-color"></a><h3>pango_renderer_set_color ()</h3>
823
788
<pre class="programlisting"><span class="returnvalue">void</span> pango_renderer_set_color (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
824
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
825
<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor" title="struct PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
789
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>,
790
<em class="parameter"><code>const <a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="type">PangoColor</span></a> *color</code></em>);</pre>
827
792
Sets the color for part of the rendering.
838
803
<td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
839
<td>the part to change the color of
804
<td>the part to change the color of</td>
843
807
<td><p><span class="term"><em class="parameter"><code>color</code></em> :</span></p></td>
844
<td>the new color or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to unset the current color
808
<td>the new color or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset the current color. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
852
816
<div class="refsect2">
853
817
<a name="pango-renderer-get-color"></a><h3>pango_renderer_get_color ()</h3>
854
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor" title="struct PangoColor"><span class="returnvalue">PangoColor</span></a> * pango_renderer_get_color (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
855
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart" title="enum PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);</pre>
818
<pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor"><span class="returnvalue">PangoColor</span></a> * pango_renderer_get_color (<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderer"><span class="type">PangoRenderer</span></a> *renderer</code></em>,
819
<em class="parameter"><code><a class="link" href="pango-pango-renderer.html#PangoRenderPart"><span class="type">PangoRenderPart</span></a> part</code></em>);</pre>
857
821
Gets the current rendering color for the specified part.
868
832
<td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
869
<td>the part to get the color for
833
<td>the part to get the color for</td>
873
836
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
874
<td> the color for the specified part, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
875
if it hasn't been set and should be inherited from the
837
<td>the color for the specified part, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
838
if it hasn't been set and should be inherited from the
901
862
<td><p><span class="term"><em class="parameter"><code>matrix</code></em> :</span></p></td>
902
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix" title="struct PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to unset any existing matrix.
903
(No matrix set is the same as setting the identity matrix.)
863
<td>a <a class="link" href="pango-Glyph-Storage.html#PangoMatrix"><span class="type">PangoMatrix</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset any existing matrix.
864
(No matrix set is the same as setting the identity matrix.). <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
927
888
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
928
<td> the matrix, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no matrix has been set
929
(which is the same as the identity matrix). The returned
930
matrix is owned by Pango and must not be modified or
889
<td>the matrix, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no matrix has been set
890
(which is the same as the identity matrix). The returned
891
matrix is owned by Pango and must not be modified or