~ubuntu-branches/ubuntu/karmic/pango1.0/karmic-security

« back to all changes in this revision

Viewing changes to docs/html/PangoRenderer.html

  • Committer: Bazaar Package Importer
  • Author(s): Loic Minier
  • Date: 2007-12-18 21:11:37 UTC
  • mfrom: (1.2.44 upstream)
  • Revision ID: james.westby@ubuntu.com-20071218211137-0ibmwreimvxf3cp1
Tags: 1.19.2-1ubuntu1
* Sync with Debian; Ubuntu changes are:
  - Add patch 30_anymetrics, turns on FC_ANY_METRICS whenever looking up
    fonts with fontconfig; lets fontconfig's configuration know that we
    don't care about getting a font with exactly the same shape as the
    family we asked for and fixes (eg) a firefox vs. evince font metrics
    ugliness issue.

Show diffs side-by-side

added added

removed removed

Lines of Context:
37
37
<th width="100%" align="center">Pango Reference Manual</th>
38
38
<td><a accesskey="n" href="PangoFcFontMap.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
39
39
</tr>
40
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3196914" class="shortcut">Top</a>
41
 
                  &#160;|&#160;
42
 
                  <a href="#id3197638" class="shortcut">Description</a>
43
 
                  &#160;|&#160;
44
 
                  <a href="#id3197606" class="shortcut">Object Hierarchy</a></nobr></td></tr>
 
40
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3213951" class="shortcut">Top</a>
 
41
                  &#160;|&#160;
 
42
                  <a href="#id3214675" class="shortcut">Description</a>
 
43
                  &#160;|&#160;
 
44
                  <a href="#id3214643" class="shortcut">Object Hierarchy</a></nobr></td></tr>
45
45
</table>
46
46
<div class="refentry" lang="en">
47
47
<a name="PangoRenderer"></a><div class="titlepage"></div>
48
48
<div class="refnamediv"><table width="100%"><tr>
49
49
<td valign="top">
50
50
<h2>
51
 
<a name="id3196914"></a><span class="refentrytitle">PangoRenderer</span>
 
51
<a name="id3213951"></a><span class="refentrytitle">PangoRenderer</span>
52
52
</h2>
53
53
<p>PangoRenderer &#8212; Rendering driver base class</p>
54
54
</td>
120
120
</pre>
121
121
</div>
122
122
<div class="refsect1" lang="en">
123
 
<a name="id3197606"></a><h2>Object Hierarchy</h2>
 
123
<a name="id3214643"></a><h2>Object Hierarchy</h2>
124
124
<pre class="synopsis">
125
125
 
126
126
  <a
131
131
</pre>
132
132
</div>
133
133
<div class="refsect1" lang="en">
134
 
<a name="id3197638"></a><h2>Description</h2>
 
134
<a name="id3214675"></a><h2>Description</h2>
135
135
<p>
136
136
<a class="link" href="PangoRenderer.html" title="PangoRenderer"><span class="type">PangoRenderer</span></a> is a base class that contains the necessary logic for
137
137
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
141
141
</p>
142
142
</div>
143
143
<div class="refsect1" lang="en">
144
 
<a name="id3197700"></a><h2>Details</h2>
 
144
<a name="id3214737"></a><h2>Details</h2>
145
145
<div class="refsect2" lang="en">
146
 
<a name="id3197710"></a><h3>
 
146
<a name="id3214748"></a><h3>
147
147
<a name="PangoRenderer-struct"></a>PangoRenderer</h3>
148
 
<a class="indexterm" name="id3197724"></a><pre class="programlisting">typedef struct {
 
148
<a class="indexterm" name="id3214761"></a><pre class="programlisting">typedef struct {
149
149
  PangoMatrix *matrix;          /* May be NULL */
150
150
} PangoRenderer;
151
151
</pre>
172
172
</div>
173
173
<hr>
174
174
<div class="refsect2" lang="en">
175
 
<a name="id3197812"></a><h3>
 
175
<a name="id3214850"></a><h3>
176
176
<a name="PangoRenderPart"></a>enum PangoRenderPart</h3>
177
 
<a class="indexterm" name="id3197827"></a><pre class="programlisting">typedef enum
 
177
<a class="indexterm" name="id3214865"></a><pre class="programlisting">typedef enum
178
178
{
179
179
  PANGO_RENDER_PART_FOREGROUND,
180
180
  PANGO_RENDER_PART_BACKGROUND,
218
218
</div>
219
219
<hr>
220
220
<div class="refsect2" lang="en">
221
 
<a name="id3197962"></a><h3>
 
221
<a name="id3215000"></a><h3>
222
222
<a name="PANGO-TYPE-RENDER-PART:CAPS"></a>PANGO_TYPE_RENDER_PART</h3>
223
 
<a class="indexterm" name="id3197975"></a><pre class="programlisting">#define PANGO_TYPE_RENDER_PART (pango_render_part_get_type())
 
223
<a class="indexterm" name="id3215012"></a><pre class="programlisting">#define PANGO_TYPE_RENDER_PART (pango_render_part_get_type())
224
224
</pre>
225
225
<p>
226
226
The <a
230
230
</div>
231
231
<hr>
232
232
<div class="refsect2" lang="en">
233
 
<a name="id3198007"></a><h3>
 
233
<a name="id3215044"></a><h3>
234
234
<a name="PangoRendererClass"></a>PangoRendererClass</h3>
235
 
<a class="indexterm" name="id3198023"></a><pre class="programlisting">typedef struct {
 
235
<a class="indexterm" name="id3215059"></a><pre class="programlisting">typedef struct {
236
236
  /* All of the following have default implementations
237
237
   * and take as coordinates user coordinates in Pango units
238
238
   */
362
362
</div>
363
363
<hr>
364
364
<div class="refsect2" lang="en">
365
 
<a name="id3198292"></a><h3>
 
365
<a name="id3215329"></a><h3>
366
366
<a name="pango-renderer-draw-layout"></a>pango_renderer_draw_layout ()</h3>
367
 
<a class="indexterm" name="id3198308"></a><pre class="programlisting">void                pango_renderer_draw_layout          (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
367
<a class="indexterm" name="id3215346"></a><pre class="programlisting">void                pango_renderer_draw_layout          (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
368
368
                                                         <a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a> *layout,
369
369
                                                         int x,
370
370
                                                         int y);</pre>
405
405
</div>
406
406
<hr>
407
407
<div class="refsect2" lang="en">
408
 
<a name="id3198460"></a><h3>
 
408
<a name="id3215498"></a><h3>
409
409
<a name="pango-renderer-draw-layout-line"></a>pango_renderer_draw_layout_line ()</h3>
410
 
<a class="indexterm" name="id3198476"></a><pre class="programlisting">void                pango_renderer_draw_layout_line     (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
410
<a class="indexterm" name="id3215514"></a><pre class="programlisting">void                pango_renderer_draw_layout_line     (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
411
411
                                                         <a class="link" href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a> *line,
412
412
                                                         int x,
413
413
                                                         int y);</pre>
448
448
</div>
449
449
<hr>
450
450
<div class="refsect2" lang="en">
451
 
<a name="id3198630"></a><h3>
 
451
<a name="id3215667"></a><h3>
452
452
<a name="pango-renderer-draw-glyphs"></a>pango_renderer_draw_glyphs ()</h3>
453
 
<a class="indexterm" name="id3198645"></a><pre class="programlisting">void                pango_renderer_draw_glyphs          (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
453
<a class="indexterm" name="id3215683"></a><pre class="programlisting">void                pango_renderer_draw_glyphs          (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
454
454
                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
455
455
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyphString">PangoGlyphString</a> *glyphs,
456
456
                                                         int x,
497
497
</div>
498
498
<hr>
499
499
<div class="refsect2" lang="en">
500
 
<a name="id3198828"></a><h3>
 
500
<a name="id3215865"></a><h3>
501
501
<a name="pango-renderer-draw-rectangle"></a>pango_renderer_draw_rectangle ()</h3>
502
 
<a class="indexterm" name="id3198844"></a><pre class="programlisting">void                pango_renderer_draw_rectangle       (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
502
<a class="indexterm" name="id3215881"></a><pre class="programlisting">void                pango_renderer_draw_rectangle       (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
503
503
                                                         <a class="link" href="PangoRenderer.html#PangoRenderPart">PangoRenderPart</a> part,
504
504
                                                         int x,
505
505
                                                         int y,
555
555
</div>
556
556
<hr>
557
557
<div class="refsect2" lang="en">
558
 
<a name="id3199050"></a><h3>
 
558
<a name="id3216087"></a><h3>
559
559
<a name="pango-renderer-draw-error-underline"></a>pango_renderer_draw_error_underline ()</h3>
560
 
<a class="indexterm" name="id3199067"></a><pre class="programlisting">void                pango_renderer_draw_error_underline (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
560
<a class="indexterm" name="id3216104"></a><pre class="programlisting">void                pango_renderer_draw_error_underline (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
561
561
                                                         int x,
562
562
                                                         int y,
563
563
                                                         int width,
610
610
</div>
611
611
<hr>
612
612
<div class="refsect2" lang="en">
613
 
<a name="id3199245"></a><h3>
 
613
<a name="id3216282"></a><h3>
614
614
<a name="pango-renderer-draw-trapezoid"></a>pango_renderer_draw_trapezoid ()</h3>
615
 
<a class="indexterm" name="id3199261"></a><pre class="programlisting">void                pango_renderer_draw_trapezoid       (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
615
<a class="indexterm" name="id3216298"></a><pre class="programlisting">void                pango_renderer_draw_trapezoid       (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
616
616
                                                         <a class="link" href="PangoRenderer.html#PangoRenderPart">PangoRenderPart</a> part,
617
617
                                                         double y1_,
618
618
                                                         double x11,
676
676
</div>
677
677
<hr>
678
678
<div class="refsect2" lang="en">
679
 
<a name="id3199491"></a><h3>
 
679
<a name="id3216529"></a><h3>
680
680
<a name="pango-renderer-draw-glyph"></a>pango_renderer_draw_glyph ()</h3>
681
 
<a class="indexterm" name="id3199508"></a><pre class="programlisting">void                pango_renderer_draw_glyph           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
681
<a class="indexterm" name="id3216545"></a><pre class="programlisting">void                pango_renderer_draw_glyph           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
682
682
                                                         <a class="link" href="pango-Fonts.html#PangoFont">PangoFont</a> *font,
683
683
                                                         <a class="link" href="pango-Glyph-Storage.html#PangoGlyph">PangoGlyph</a> glyph,
684
684
                                                         double x,
723
723
</div>
724
724
<hr>
725
725
<div class="refsect2" lang="en">
726
 
<a name="id3199668"></a><h3>
 
726
<a name="id3216705"></a><h3>
727
727
<a name="pango-renderer-activate"></a>pango_renderer_activate ()</h3>
728
 
<a class="indexterm" name="id3199684"></a><pre class="programlisting">void                pango_renderer_activate             (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
 
728
<a class="indexterm" name="id3216721"></a><pre class="programlisting">void                pango_renderer_activate             (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
729
729
<p>
730
730
Does initial setup before rendering operations on <em class="parameter"><code>renderer</code></em>.
731
731
<a class="link" href="PangoRenderer.html#pango-renderer-deactivate"><code class="function">pango_renderer_deactivate()</code></a> should be called when done drawing.
750
750
</div>
751
751
<hr>
752
752
<div class="refsect2" lang="en">
753
 
<a name="id3199802"></a><h3>
 
753
<a name="id3216840"></a><h3>
754
754
<a name="pango-renderer-deactivate"></a>pango_renderer_deactivate ()</h3>
755
 
<a class="indexterm" name="id3199818"></a><pre class="programlisting">void                pango_renderer_deactivate           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
 
755
<a class="indexterm" name="id3216856"></a><pre class="programlisting">void                pango_renderer_deactivate           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
756
756
<p>
757
757
Cleans up after rendering operations on <em class="parameter"><code>renderer</code></em>. See
758
758
docs for <a class="link" href="PangoRenderer.html#pango-renderer-activate"><code class="function">pango_renderer_activate()</code></a>.</p>
772
772
</div>
773
773
<hr>
774
774
<div class="refsect2" lang="en">
775
 
<a name="id3199900"></a><h3>
 
775
<a name="id3216938"></a><h3>
776
776
<a name="pango-renderer-part-changed"></a>pango_renderer_part_changed ()</h3>
777
 
<a class="indexterm" name="id3199917"></a><pre class="programlisting">void                pango_renderer_part_changed         (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
777
<a class="indexterm" name="id3216954"></a><pre class="programlisting">void                pango_renderer_part_changed         (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
778
778
                                                         <a class="link" href="PangoRenderer.html#PangoRenderPart">PangoRenderPart</a> part);</pre>
779
779
<p>
780
780
Informs Pango that the way that the rendering is done
817
817
</div>
818
818
<hr>
819
819
<div class="refsect2" lang="en">
820
 
<a name="id3200050"></a><h3>
 
820
<a name="id3217087"></a><h3>
821
821
<a name="pango-renderer-set-color"></a>pango_renderer_set_color ()</h3>
822
 
<a class="indexterm" name="id3200066"></a><pre class="programlisting">void                pango_renderer_set_color            (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
822
<a class="indexterm" name="id3217103"></a><pre class="programlisting">void                pango_renderer_set_color            (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
823
823
                                                         <a class="link" href="PangoRenderer.html#PangoRenderPart">PangoRenderPart</a> part,
824
824
                                                         const <a class="link" href="pango-Text-Attributes.html#PangoColor">PangoColor</a> *color);</pre>
825
825
<p>
854
854
</div>
855
855
<hr>
856
856
<div class="refsect2" lang="en">
857
 
<a name="id3200186"></a><h3>
 
857
<a name="id3217224"></a><h3>
858
858
<a name="pango-renderer-get-color"></a>pango_renderer_get_color ()</h3>
859
 
<a class="indexterm" name="id3200202"></a><pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor">PangoColor</a>*         pango_renderer_get_color            (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
859
<a class="indexterm" name="id3217239"></a><pre class="programlisting"><a class="link" href="pango-Text-Attributes.html#PangoColor">PangoColor</a>*         pango_renderer_get_color            (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
860
860
                                                         <a class="link" href="PangoRenderer.html#PangoRenderPart">PangoRenderPart</a> part);</pre>
861
861
<p>
862
862
Gets the current rendering color for the specified part.</p>
893
893
</div>
894
894
<hr>
895
895
<div class="refsect2" lang="en">
896
 
<a name="id3200312"></a><h3>
 
896
<a name="id3217350"></a><h3>
897
897
<a name="pango-renderer-set-matrix"></a>pango_renderer_set_matrix ()</h3>
898
 
<a class="indexterm" name="id3200328"></a><pre class="programlisting">void                pango_renderer_set_matrix           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
 
898
<a class="indexterm" name="id3217366"></a><pre class="programlisting">void                pango_renderer_set_matrix           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer,
899
899
                                                         const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a> *matrix);</pre>
900
900
<p>
901
901
Sets the transformation matrix that will be applied when rendering.</p>
925
925
</div>
926
926
<hr>
927
927
<div class="refsect2" lang="en">
928
 
<a name="id3200435"></a><h3>
 
928
<a name="id3217472"></a><h3>
929
929
<a name="pango-renderer-get-matrix"></a>pango_renderer_get_matrix ()</h3>
930
 
<a class="indexterm" name="id3200451"></a><pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a>*  pango_renderer_get_matrix           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
 
930
<a class="indexterm" name="id3217489"></a><pre class="programlisting">const <a class="link" href="pango-Glyph-Storage.html#PangoMatrix">PangoMatrix</a>*  pango_renderer_get_matrix           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
931
931
<p>
932
932
Gets the transformation matrix that will be applied when
933
933
rendering. See <a class="link" href="PangoRenderer.html#pango-renderer-set-matrix"><code class="function">pango_renderer_set_matrix()</code></a>.</p>
960
960
</div>
961
961
<hr>
962
962
<div class="refsect2" lang="en">
963
 
<a name="id3200552"></a><h3>
 
963
<a name="id3217589"></a><h3>
964
964
<a name="pango-renderer-get-layout"></a>pango_renderer_get_layout ()</h3>
965
 
<a class="indexterm" name="id3200568"></a><pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a>*        pango_renderer_get_layout           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
 
965
<a class="indexterm" name="id3217606"></a><pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayout">PangoLayout</a>*        pango_renderer_get_layout           (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
966
966
<p>
967
967
Gets the layout currently being rendered using <em class="parameter"><code>renderer</code></em>.
968
968
Calling this function only makes sense from inside a subclass's
998
998
</div>
999
999
<hr>
1000
1000
<div class="refsect2" lang="en">
1001
 
<a name="id3200676"></a><h3>
 
1001
<a name="id3217713"></a><h3>
1002
1002
<a name="pango-renderer-get-layout-line"></a>pango_renderer_get_layout_line ()</h3>
1003
 
<a class="indexterm" name="id3200692"></a><pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a>*    pango_renderer_get_layout_line      (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
 
1003
<a class="indexterm" name="id3217729"></a><pre class="programlisting"><a class="link" href="pango-Layout-Objects.html#PangoLayoutLine">PangoLayoutLine</a>*    pango_renderer_get_layout_line      (<a class="link" href="PangoRenderer.html" title="PangoRenderer">PangoRenderer</a> *renderer);</pre>
1004
1004
<p>
1005
1005
Gets the layout line currently being rendered using <em class="parameter"><code>renderer</code></em>.
1006
1006
Calling this function only makes sense from inside a subclass's