cairo 1.15.3-x64-mingw32 → 1.15.4-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of cairo might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/NEWS +24 -0
- data/Rakefile +3 -3
- data/ext/cairo/rb_cairo.h +11 -1
- data/ext/cairo/rb_cairo_constants.c +56 -1
- data/ext/cairo/rb_cairo_context.c +100 -1
- data/ext/cairo/rb_cairo_exception.c +45 -0
- data/ext/cairo/rb_cairo_surface.c +126 -1
- data/lib/2.2/cairo.so +0 -0
- data/lib/2.3/cairo.so +0 -0
- data/lib/2.4/cairo.so +0 -0
- data/lib/cairo.rb +2 -0
- data/samples/link.rb +19 -0
- data/test/cairo-test-utils.rb +1 -0
- data/test/test_context.rb +22 -0
- data/test/test_pdf_surface.rb +131 -0
- data/vendor/local/bin/fc-cache.exe +0 -0
- data/vendor/local/bin/fc-cat.exe +0 -0
- data/vendor/local/bin/fc-list.exe +0 -0
- data/vendor/local/bin/fc-match.exe +0 -0
- data/vendor/local/bin/fc-pattern.exe +0 -0
- data/vendor/local/bin/fc-query.exe +0 -0
- data/vendor/local/bin/fc-scan.exe +0 -0
- data/vendor/local/bin/fc-validate.exe +0 -0
- data/vendor/local/bin/libcairo-2.dll +0 -0
- data/vendor/local/bin/libcairo-gobject-2.dll +0 -0
- data/vendor/local/bin/libcairo-script-interpreter-2.dll +0 -0
- data/vendor/local/bin/libfontconfig-1.dll +0 -0
- data/vendor/local/bin/libfreetype-6.dll +0 -0
- data/vendor/local/bin/libpixman-1-0.dll +0 -0
- data/vendor/local/bin/libpng-config +1 -1
- data/vendor/local/bin/libpng16-16.dll +0 -0
- data/vendor/local/bin/libpng16-config +1 -1
- data/vendor/local/bin/libxml2-2.dll +0 -0
- data/vendor/local/bin/png-fix-itxt.exe +0 -0
- data/vendor/local/bin/pngfix.exe +0 -0
- data/vendor/local/bin/xmlcatalog.exe +0 -0
- data/vendor/local/bin/xmllint.exe +0 -0
- data/vendor/local/bin/zlib1.dll +0 -0
- data/vendor/local/include/cairo/cairo-pdf.h +68 -0
- data/vendor/local/include/cairo/cairo-version.h +1 -1
- data/vendor/local/include/cairo/cairo.h +19 -0
- data/vendor/local/include/libpng16/png.h +13 -12
- data/vendor/local/include/libpng16/pngconf.h +1 -1
- data/vendor/local/include/libpng16/pnglibconf.h +1 -1
- data/vendor/local/include/png.h +13 -12
- data/vendor/local/include/pngconf.h +1 -1
- data/vendor/local/include/pnglibconf.h +1 -1
- data/vendor/local/lib/libcairo-gobject.a +0 -0
- data/vendor/local/lib/libcairo-gobject.dll.a +0 -0
- data/vendor/local/lib/libcairo-gobject.la +2 -2
- data/vendor/local/lib/libcairo-script-interpreter.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.dll.a +0 -0
- data/vendor/local/lib/libcairo-script-interpreter.la +2 -2
- data/vendor/local/lib/libcairo.a +0 -0
- data/vendor/local/lib/libcairo.dll.a +0 -0
- data/vendor/local/lib/libcairo.la +2 -2
- data/vendor/local/lib/libfontconfig.dll.a +0 -0
- data/vendor/local/lib/libfreetype.a +0 -0
- data/vendor/local/lib/libfreetype.dll.a +0 -0
- data/vendor/local/lib/libpixman-1.dll.a +0 -0
- data/vendor/local/lib/libpng.a +0 -0
- data/vendor/local/lib/libpng.dll.a +0 -0
- data/vendor/local/lib/libpng.la +2 -2
- data/vendor/local/lib/libpng16.a +0 -0
- data/vendor/local/lib/libpng16.dll.a +0 -0
- data/vendor/local/lib/libpng16.la +2 -2
- data/vendor/local/lib/libxml2.dll.a +0 -0
- data/vendor/local/lib/libz.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/cairo-fc.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ft.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-gobject.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-pdf.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-png.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-ps.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-script.pc +2 -2
- data/vendor/local/lib/pkgconfig/cairo-svg.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32-font.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo-win32.pc +1 -1
- data/vendor/local/lib/pkgconfig/cairo.pc +2 -2
- data/vendor/local/lib/pkgconfig/libpng.pc +1 -1
- data/vendor/local/lib/pkgconfig/libpng16.pc +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Error-handling.html +30 -2
- data/vendor/local/share/gtk-doc/html/cairo/cairo-FreeType-Fonts.html +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Image-Surfaces.html +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PDF-Surfaces.html +343 -4
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PNG-Support.html +8 -4
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Paths.html +3 -3
- data/vendor/local/share/gtk-doc/html/cairo/cairo-PostScript-Surfaces.html +6 -6
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Raster-Sources.html +2 -2
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Recording-Surfaces.html +3 -3
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Regions.html +10 -10
- data/vendor/local/share/gtk-doc/html/cairo/cairo-SVG-Surfaces.html +3 -3
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Tags-and-Links.html +415 -0
- data/vendor/local/share/gtk-doc/html/cairo/cairo-User-Fonts.html +14 -14
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Fonts.html +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-Win32-Surfaces.html +5 -5
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-Surfaces.html +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-XLib-XRender-Backend.html +1 -1
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-device-t.html +5 -5
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-face-t.html +6 -6
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html +2 -2
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-pattern-t.html +35 -35
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-scaled-font-t.html +14 -14
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-surface-t.html +14 -14
- data/vendor/local/share/gtk-doc/html/cairo/cairo-cairo-t.html +10 -10
- data/vendor/local/share/gtk-doc/html/cairo/cairo-drawing.html +3 -0
- data/vendor/local/share/gtk-doc/html/cairo/cairo-fonts.html +2 -2
- data/vendor/local/share/gtk-doc/html/cairo/cairo-text.html +11 -11
- data/vendor/local/share/gtk-doc/html/cairo/cairo.devhelp2 +15 -0
- data/vendor/local/share/gtk-doc/html/cairo/index-all.html +22 -0
- data/vendor/local/share/gtk-doc/html/cairo/index.html +4 -1
- data/vendor/local/share/gtk-doc/html/cairo/index.sgml +22 -0
- data/vendor/local/share/license/libpng/README +1 -1
- data/vendor/local/share/man/man3/libpng.3 +9 -9
- data/vendor/local/share/man/man3/libpngpf.3 +2 -2
- data/vendor/local/share/man/man5/png.5 +1 -1
- metadata +9 -3
@@ -352,7 +352,7 @@ Arabic and Indic.</p>
|
|
352
352
|
argument is preset to the number of glyph entries available
|
353
353
|
in the <em class="parameter"><code>glyphs</code></em>
|
354
354
|
buffer. If the <em class="parameter"><code>glyphs</code></em>
|
355
|
-
buffer is <
|
355
|
+
buffer is <code class="literal">NULL</code>, the value of
|
356
356
|
<em class="parameter"><code>num_glyphs</code></em>
|
357
357
|
will be zero. If the provided glyph array is too short for
|
358
358
|
the conversion (or for convenience), a new glyph array may be allocated
|
@@ -368,13 +368,13 @@ the original value of <em class="parameter"><code>glyphs</code></em>
|
|
368
368
|
The callback should populate the glyph indices and positions (in font space)
|
369
369
|
assuming that the text is to be shown at the origin.</p>
|
370
370
|
<p>If <em class="parameter"><code>clusters</code></em>
|
371
|
-
is not <
|
371
|
+
is not <code class="literal">NULL</code>, <em class="parameter"><code>num_clusters</code></em>
|
372
372
|
and <em class="parameter"><code>cluster_flags</code></em>
|
373
373
|
are also
|
374
|
-
non-<
|
374
|
+
non-<code class="literal">NULL</code>, and cluster mapping should be computed. The semantics of how
|
375
375
|
cluster array allocation works is similar to the glyph array. That is,
|
376
376
|
if <em class="parameter"><code>clusters</code></em>
|
377
|
-
initially points to a non-<
|
377
|
+
initially points to a non-<code class="literal">NULL</code> value, that array may be used
|
378
378
|
as a cluster buffer, and <em class="parameter"><code>num_clusters</code></em>
|
379
379
|
points to the number of cluster
|
380
380
|
entries available there. If the provided cluster array is too short for
|
@@ -437,7 +437,7 @@ in bytes</p></td>
|
|
437
437
|
</tr>
|
438
438
|
<tr>
|
439
439
|
<td class="parameter_name"><p>clusters</p></td>
|
440
|
-
<td class="parameter_description"><p>pointer to array of cluster mapping information to fill, or <
|
440
|
+
<td class="parameter_description"><p>pointer to array of cluster mapping information to fill, or <code class="literal">NULL</code></p></td>
|
441
441
|
<td class="parameter_annotations"> </td>
|
442
442
|
</tr>
|
443
443
|
<tr>
|
@@ -579,7 +579,7 @@ is created from it.</p>
|
|
579
579
|
</tr>
|
580
580
|
<tr>
|
581
581
|
<td class="parameter_name"><p>init_func</p></td>
|
582
|
-
<td class="parameter_description"><p>The init callback, or <
|
582
|
+
<td class="parameter_description"><p>The init callback, or <code class="literal">NULL</code></p></td>
|
583
583
|
<td class="parameter_annotations"> </td>
|
584
584
|
</tr>
|
585
585
|
</tbody>
|
@@ -611,7 +611,7 @@ cairo_user_font_face_get_init_func (<em class="parameter"><code><a class="link"
|
|
611
611
|
<div class="refsect3">
|
612
612
|
<a name="id-1.4.8.7.8.6"></a><h4>Returns</h4>
|
613
613
|
<p> The init callback of <em class="parameter"><code>font_face</code></em>
|
614
|
-
or <
|
614
|
+
or <code class="literal">NULL</code> if none set or an error has occurred.</p>
|
615
615
|
<p></p>
|
616
616
|
</div>
|
617
617
|
<p class="since">Since 1.8</p>
|
@@ -630,7 +630,7 @@ works.</p>
|
|
630
630
|
error will occur. A user font-face is immutable as soon as a scaled-font
|
631
631
|
is created from it.</p>
|
632
632
|
<p>The render_glyph callback is the only mandatory callback of a user-font.
|
633
|
-
If the callback is <
|
633
|
+
If the callback is <code class="literal">NULL</code> and a glyph is tried to be rendered using
|
634
634
|
<em class="parameter"><code>font_face</code></em>
|
635
635
|
, a <a class="link" href="cairo-Error-handling.html#CAIRO-STATUS-USER-FONT-ERROR:CAPS"><code class="literal">CAIRO_STATUS_USER_FONT_ERROR</code></a> will occur.</p>
|
636
636
|
<div class="refsect3">
|
@@ -649,7 +649,7 @@ If the callback is <a href="http://library.gnome.org/devel/glib/unstable/glib-St
|
|
649
649
|
</tr>
|
650
650
|
<tr>
|
651
651
|
<td class="parameter_name"><p>render_glyph_func</p></td>
|
652
|
-
<td class="parameter_description"><p>The render_glyph callback, or <
|
652
|
+
<td class="parameter_description"><p>The render_glyph callback, or <code class="literal">NULL</code></p></td>
|
653
653
|
<td class="parameter_annotations"> </td>
|
654
654
|
</tr>
|
655
655
|
</tbody>
|
@@ -682,7 +682,7 @@ cairo_user_font_face_get_render_glyph_func
|
|
682
682
|
<div class="refsect3">
|
683
683
|
<a name="id-1.4.8.7.10.6"></a><h4>Returns</h4>
|
684
684
|
<p> The render_glyph callback of <em class="parameter"><code>font_face</code></em>
|
685
|
-
or <
|
685
|
+
or <code class="literal">NULL</code> if none set or an error has occurred.</p>
|
686
686
|
<p></p>
|
687
687
|
</div>
|
688
688
|
<p class="since">Since 1.8</p>
|
@@ -716,7 +716,7 @@ is created from it.</p>
|
|
716
716
|
</tr>
|
717
717
|
<tr>
|
718
718
|
<td class="parameter_name"><p>unicode_to_glyph_func</p></td>
|
719
|
-
<td class="parameter_description"><p>The unicode_to_glyph callback, or <
|
719
|
+
<td class="parameter_description"><p>The unicode_to_glyph callback, or <code class="literal">NULL</code></p></td>
|
720
720
|
<td class="parameter_annotations"> </td>
|
721
721
|
</tr>
|
722
722
|
</tbody>
|
@@ -749,7 +749,7 @@ cairo_user_font_face_get_unicode_to_glyph_func
|
|
749
749
|
<div class="refsect3">
|
750
750
|
<a name="id-1.4.8.7.12.6"></a><h4>Returns</h4>
|
751
751
|
<p> The unicode_to_glyph callback of <em class="parameter"><code>font_face</code></em>
|
752
|
-
or <
|
752
|
+
or <code class="literal">NULL</code> if none set or an error occurred.</p>
|
753
753
|
<p></p>
|
754
754
|
</div>
|
755
755
|
<p class="since">Since 1.8</p>
|
@@ -783,7 +783,7 @@ is created from it.</p>
|
|
783
783
|
</tr>
|
784
784
|
<tr>
|
785
785
|
<td class="parameter_name"><p>text_to_glyphs_func</p></td>
|
786
|
-
<td class="parameter_description"><p>The text_to_glyphs callback, or <
|
786
|
+
<td class="parameter_description"><p>The text_to_glyphs callback, or <code class="literal">NULL</code></p></td>
|
787
787
|
<td class="parameter_annotations"> </td>
|
788
788
|
</tr>
|
789
789
|
</tbody>
|
@@ -816,7 +816,7 @@ cairo_user_font_face_get_text_to_glyphs_func
|
|
816
816
|
<div class="refsect3">
|
817
817
|
<a name="id-1.4.8.7.14.6"></a><h4>Returns</h4>
|
818
818
|
<p> The text_to_glyphs callback of <em class="parameter"><code>font_face</code></em>
|
819
|
-
or <
|
819
|
+
or <code class="literal">NULL</code> if none set or an error occurred.</p>
|
820
820
|
<p></p>
|
821
821
|
</div>
|
822
822
|
<p class="since">Since 1.8</p>
|
@@ -229,7 +229,7 @@ and can be used with functions such as <a class="link" href="cairo-Win32-Fonts.h
|
|
229
229
|
<td class="parameter_name"><p>logfont</p></td>
|
230
230
|
<td class="parameter_description"><p>A <span class="type">LOGFONTW</span> structure specifying the font to use.
|
231
231
|
If <em class="parameter"><code>font</code></em>
|
232
|
-
is <
|
232
|
+
is <code class="literal">NULL</code> then the lfHeight, lfWidth, lfOrientation and lfEscapement
|
233
233
|
fields of this structure are ignored. Otherwise lfWidth, lfOrientation and
|
234
234
|
lfEscapement must be zero.</p></td>
|
235
235
|
<td class="parameter_annotations"> </td>
|
@@ -288,8 +288,8 @@ associated methods must be used for correct output.</p>
|
|
288
288
|
<a name="cairo-win32-surface-get-dc"></a><h3>cairo_win32_surface_get_dc ()</h3>
|
289
289
|
<pre class="programlisting"><span class="returnvalue">HDC</span>
|
290
290
|
cairo_win32_surface_get_dc (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
|
291
|
-
<p>Returns the HDC associated with this surface, or <
|
292
|
-
Also returns <
|
291
|
+
<p>Returns the HDC associated with this surface, or <code class="literal">NULL</code> if none.
|
292
|
+
Also returns <code class="literal">NULL</code> if the surface is not a win32 surface.</p>
|
293
293
|
<p>A call to <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-flush" title="cairo_surface_flush ()"><code class="function">cairo_surface_flush()</code></a> is required before using the HDC to
|
294
294
|
ensure that all pending drawing operations are finished and to
|
295
295
|
restore any temporary modification cairo has made to its state. A
|
@@ -312,7 +312,7 @@ the content of the HDC has been modified.</p>
|
|
312
312
|
</div>
|
313
313
|
<div class="refsect3">
|
314
314
|
<a name="id-1.5.9.7.6.7"></a><h4>Returns</h4>
|
315
|
-
<p> HDC or <
|
315
|
+
<p> HDC or <code class="literal">NULL</code> if no HDC available.</p>
|
316
316
|
<p></p>
|
317
317
|
</div>
|
318
318
|
<p class="since">Since 1.2</p>
|
@@ -324,7 +324,7 @@ the content of the HDC has been modified.</p>
|
|
324
324
|
cairo_win32_surface_get_image (<em class="parameter"><code><a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> *surface</code></em>);</pre>
|
325
325
|
<p>Returns a <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> image surface that refers to the same bits
|
326
326
|
as the DIB of the Win32 surface. If the passed-in win32 surface
|
327
|
-
is not a DIB surface, <
|
327
|
+
is not a DIB surface, <code class="literal">NULL</code> is returned.</p>
|
328
328
|
<div class="refsect3">
|
329
329
|
<a name="id-1.5.9.7.7.5"></a><h4>Parameters</h4>
|
330
330
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -343,7 +343,7 @@ is not a DIB surface, <a href="http://library.gnome.org/devel/glib/unstable/glib
|
|
343
343
|
<div class="refsect3">
|
344
344
|
<a name="id-1.5.9.7.7.6"></a><h4>Returns</h4>
|
345
345
|
<p> a <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a> (owned by the win32 <a class="link" href="cairo-cairo-surface-t.html#cairo-surface-t" title="cairo_surface_t"><span class="type">cairo_surface_t</span></a>),
|
346
|
-
or <
|
346
|
+
or <code class="literal">NULL</code> if the win32 surface is not a DIB.</p>
|
347
347
|
<p></p>
|
348
348
|
</div>
|
349
349
|
<p class="since">Since 1.4</p>
|
@@ -513,7 +513,7 @@ constructor.</p>
|
|
513
513
|
</div>
|
514
514
|
<div class="refsect3">
|
515
515
|
<a name="id-1.5.13.7.9.6"></a><h4>Returns</h4>
|
516
|
-
<p> the Visual or <
|
516
|
+
<p> the Visual or <code class="literal">NULL</code> if there is no appropriate Visual for
|
517
517
|
<em class="parameter"><code>surface</code></em>
|
518
518
|
.</p>
|
519
519
|
<p></p>
|
@@ -187,7 +187,7 @@ value is the format passed to that constructor.</p>
|
|
187
187
|
<a name="id-1.5.14.7.3.6"></a><h4>Returns</h4>
|
188
188
|
<p> the XRenderPictFormat* associated with <em class="parameter"><code>surface</code></em>
|
189
189
|
,
|
190
|
-
or <
|
190
|
+
or <code class="literal">NULL</code> if the surface is not an xlib surface
|
191
191
|
or if the X Render extension is not available.</p>
|
192
192
|
<p></p>
|
193
193
|
</div>
|
@@ -268,8 +268,8 @@ cairo_device_reference (<em class="parameter"><code><a class="link" href="cairo-
|
|
268
268
|
<em class="parameter"><code>device</code></em>
|
269
269
|
from being destroyed until a matching call to
|
270
270
|
<a class="link" href="cairo-cairo-device-t.html#cairo-device-destroy" title="cairo_device_destroy ()"><code class="function">cairo_device_destroy()</code></a> is made.</p>
|
271
|
-
<p>
|
272
|
-
<a class="link" href="cairo-cairo-device-t.html#cairo-device-
|
271
|
+
<p>Use <a class="link" href="cairo-cairo-device-t.html#cairo-device-get-reference-count" title="cairo_device_get_reference_count ()"><code class="function">cairo_device_get_reference_count()</code></a> to get the number of references
|
272
|
+
to a <a class="link" href="cairo-cairo-device-t.html#cairo-device-t" title="cairo_device_t"><span class="type">cairo_device_t</span></a>.</p>
|
273
273
|
<div class="refsect3">
|
274
274
|
<a name="id-1.5.2.7.2.6"></a><h4>Parameters</h4>
|
275
275
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -485,7 +485,7 @@ cairo_device_set_user_data (<em class="parameter"><code><a class="link" href="ca
|
|
485
485
|
<em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
|
486
486
|
<p>Attach user data to <em class="parameter"><code>device</code></em>
|
487
487
|
. To remove user data from a surface,
|
488
|
-
call this function with the key that was used to set it and <
|
488
|
+
call this function with the key that was used to set it and <code class="literal">NULL</code>
|
489
489
|
for <em class="parameter"><code>data</code></em>
|
490
490
|
.</p>
|
491
491
|
<div class="refsect3">
|
@@ -539,7 +539,7 @@ cairo_device_get_user_data (<em class="parameter"><code><a class="link" href="ca
|
|
539
539
|
<p>Return user data previously attached to <em class="parameter"><code>device</code></em>
|
540
540
|
using the
|
541
541
|
specified key. If no user data has been attached with the given
|
542
|
-
key this function returns <
|
542
|
+
key this function returns <code class="literal">NULL</code>.</p>
|
543
543
|
<div class="refsect3">
|
544
544
|
<a name="id-1.5.2.7.10.5"></a><h4>Parameters</h4>
|
545
545
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -565,7 +565,7 @@ attached to</p></td>
|
|
565
565
|
</div>
|
566
566
|
<div class="refsect3">
|
567
567
|
<a name="id-1.5.2.7.10.6"></a><h4>Returns</h4>
|
568
|
-
<p> the user data previously attached or <
|
568
|
+
<p> the user data previously attached or <code class="literal">NULL</code>.</p>
|
569
569
|
<p></p>
|
570
570
|
</div>
|
571
571
|
<p class="since">Since 1.10</p>
|
@@ -144,8 +144,8 @@ cairo_font_face_reference (<em class="parameter"><code><a class="link" href="cai
|
|
144
144
|
<em class="parameter"><code>font_face</code></em>
|
145
145
|
from being destroyed until a matching call to
|
146
146
|
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-destroy" title="cairo_font_face_destroy ()"><code class="function">cairo_font_face_destroy()</code></a> is made.</p>
|
147
|
-
<p>
|
148
|
-
<a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-
|
147
|
+
<p>Use <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-get-reference-count" title="cairo_font_face_get_reference_count ()"><code class="function">cairo_font_face_get_reference_count()</code></a> to get the number of
|
148
|
+
references to a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>.</p>
|
149
149
|
<div class="refsect3">
|
150
150
|
<a name="id-1.4.2.7.2.6"></a><h4>Parameters</h4>
|
151
151
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -156,7 +156,7 @@ cairo_font_face_reference (<em class="parameter"><code><a class="link" href="cai
|
|
156
156
|
</colgroup>
|
157
157
|
<tbody><tr>
|
158
158
|
<td class="parameter_name"><p>font_face</p></td>
|
159
|
-
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>, (may be <
|
159
|
+
<td class="parameter_description"><p>a <a class="link" href="cairo-cairo-font-face-t.html#cairo-font-face-t" title="cairo_font_face_t"><span class="type">cairo_font_face_t</span></a>, (may be <code class="literal">NULL</code> in which case this
|
160
160
|
function does nothing).</p></td>
|
161
161
|
<td class="parameter_annotations"> </td>
|
162
162
|
</tr></tbody>
|
@@ -297,7 +297,7 @@ cairo_font_face_set_user_data (<em class="parameter"><code><a class="link" href=
|
|
297
297
|
<em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
|
298
298
|
<p>Attach user data to <em class="parameter"><code>font_face</code></em>
|
299
299
|
. To remove user data from a font face,
|
300
|
-
call this function with the key that was used to set it and <
|
300
|
+
call this function with the key that was used to set it and <code class="literal">NULL</code>
|
301
301
|
for <em class="parameter"><code>data</code></em>
|
302
302
|
.</p>
|
303
303
|
<div class="refsect3">
|
@@ -351,7 +351,7 @@ cairo_font_face_get_user_data (<em class="parameter"><code><a class="link" href=
|
|
351
351
|
<p>Return user data previously attached to <em class="parameter"><code>font_face</code></em>
|
352
352
|
using the specified
|
353
353
|
key. If no user data has been attached with the given key this
|
354
|
-
function returns <
|
354
|
+
function returns <code class="literal">NULL</code>.</p>
|
355
355
|
<div class="refsect3">
|
356
356
|
<a name="id-1.4.2.7.8.5"></a><h4>Parameters</h4>
|
357
357
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -377,7 +377,7 @@ attached to</p></td>
|
|
377
377
|
</div>
|
378
378
|
<div class="refsect3">
|
379
379
|
<a name="id-1.4.2.7.8.6"></a><h4>Returns</h4>
|
380
|
-
<p> the user data previously attached or <
|
380
|
+
<p> the user data previously attached or <code class="literal">NULL</code>.</p>
|
381
381
|
<p></p>
|
382
382
|
</div>
|
383
383
|
<p class="since">Since 1.0</p>
|
@@ -408,8 +408,8 @@ cairo_font_options_equal (<em class="parameter"><code>const <a class="link" href
|
|
408
408
|
</div>
|
409
409
|
<div class="refsect3">
|
410
410
|
<a name="id-1.4.4.7.8.6"></a><h4>Returns</h4>
|
411
|
-
<p> <
|
412
|
-
Note that this function will return <
|
411
|
+
<p> <code class="literal">TRUE</code> if all fields of the two font options objects match.
|
412
|
+
Note that this function will return <code class="literal">FALSE</code> if either object is in
|
413
413
|
error.</p>
|
414
414
|
<p></p>
|
415
415
|
</div>
|
@@ -554,7 +554,7 @@ pattern.</p>
|
|
554
554
|
</tr>
|
555
555
|
<tr>
|
556
556
|
<td class="parameter_name"><p>count</p></td>
|
557
|
-
<td class="parameter_description"><p>return value for the number of color stops, or <
|
557
|
+
<td class="parameter_description"><p>return value for the number of color stops, or <code class="literal">NULL</code></p></td>
|
558
558
|
<td class="parameter_annotations"> </td>
|
559
559
|
</tr>
|
560
560
|
</tbody>
|
@@ -608,27 +608,27 @@ by <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-get-color-stop
|
|
608
608
|
</tr>
|
609
609
|
<tr>
|
610
610
|
<td class="parameter_name"><p>offset</p></td>
|
611
|
-
<td class="parameter_description"><p>return value for the offset of the stop, or <
|
611
|
+
<td class="parameter_description"><p>return value for the offset of the stop, or <code class="literal">NULL</code></p></td>
|
612
612
|
<td class="parameter_annotations"> </td>
|
613
613
|
</tr>
|
614
614
|
<tr>
|
615
615
|
<td class="parameter_name"><p>red</p></td>
|
616
|
-
<td class="parameter_description"><p>return value for red component of color, or <
|
616
|
+
<td class="parameter_description"><p>return value for red component of color, or <code class="literal">NULL</code></p></td>
|
617
617
|
<td class="parameter_annotations"> </td>
|
618
618
|
</tr>
|
619
619
|
<tr>
|
620
620
|
<td class="parameter_name"><p>green</p></td>
|
621
|
-
<td class="parameter_description"><p>return value for green component of color, or <
|
621
|
+
<td class="parameter_description"><p>return value for green component of color, or <code class="literal">NULL</code></p></td>
|
622
622
|
<td class="parameter_annotations"> </td>
|
623
623
|
</tr>
|
624
624
|
<tr>
|
625
625
|
<td class="parameter_name"><p>blue</p></td>
|
626
|
-
<td class="parameter_description"><p>return value for blue component of color, or <
|
626
|
+
<td class="parameter_description"><p>return value for blue component of color, or <code class="literal">NULL</code></p></td>
|
627
627
|
<td class="parameter_annotations"> </td>
|
628
628
|
</tr>
|
629
629
|
<tr>
|
630
630
|
<td class="parameter_name"><p>alpha</p></td>
|
631
|
-
<td class="parameter_description"><p>return value for alpha component of color, or <
|
631
|
+
<td class="parameter_description"><p>return value for alpha component of color, or <code class="literal">NULL</code></p></td>
|
632
632
|
<td class="parameter_annotations"> </td>
|
633
633
|
</tr>
|
634
634
|
</tbody>
|
@@ -779,22 +779,22 @@ cairo_pattern_get_rgba (<em class="parameter"><code><a class="link" href="cairo-
|
|
779
779
|
</tr>
|
780
780
|
<tr>
|
781
781
|
<td class="parameter_name"><p>red</p></td>
|
782
|
-
<td class="parameter_description"><p>return value for red component of color, or <
|
782
|
+
<td class="parameter_description"><p>return value for red component of color, or <code class="literal">NULL</code></p></td>
|
783
783
|
<td class="parameter_annotations"> </td>
|
784
784
|
</tr>
|
785
785
|
<tr>
|
786
786
|
<td class="parameter_name"><p>green</p></td>
|
787
|
-
<td class="parameter_description"><p>return value for green component of color, or <
|
787
|
+
<td class="parameter_description"><p>return value for green component of color, or <code class="literal">NULL</code></p></td>
|
788
788
|
<td class="parameter_annotations"> </td>
|
789
789
|
</tr>
|
790
790
|
<tr>
|
791
791
|
<td class="parameter_name"><p>blue</p></td>
|
792
|
-
<td class="parameter_description"><p>return value for blue component of color, or <
|
792
|
+
<td class="parameter_description"><p>return value for blue component of color, or <code class="literal">NULL</code></p></td>
|
793
793
|
<td class="parameter_annotations"> </td>
|
794
794
|
</tr>
|
795
795
|
<tr>
|
796
796
|
<td class="parameter_name"><p>alpha</p></td>
|
797
|
-
<td class="parameter_description"><p>return value for alpha component of color, or <
|
797
|
+
<td class="parameter_description"><p>return value for alpha component of color, or <code class="literal">NULL</code></p></td>
|
798
798
|
<td class="parameter_annotations"> </td>
|
799
799
|
</tr>
|
800
800
|
</tbody>
|
@@ -869,7 +869,7 @@ cairo_pattern_get_surface (<em class="parameter"><code><a class="link" href="cai
|
|
869
869
|
</tr>
|
870
870
|
<tr>
|
871
871
|
<td class="parameter_name"><p>surface</p></td>
|
872
|
-
<td class="parameter_description"><p>return value for surface of pattern, or <
|
872
|
+
<td class="parameter_description"><p>return value for surface of pattern, or <code class="literal">NULL</code></p></td>
|
873
873
|
<td class="parameter_annotations"> </td>
|
874
874
|
</tr>
|
875
875
|
</tbody>
|
@@ -971,22 +971,22 @@ cairo_pattern_get_linear_points (<em class="parameter"><code><a class="link" hre
|
|
971
971
|
</tr>
|
972
972
|
<tr>
|
973
973
|
<td class="parameter_name"><p>x0</p></td>
|
974
|
-
<td class="parameter_description"><p>return value for the x coordinate of the first point, or <
|
974
|
+
<td class="parameter_description"><p>return value for the x coordinate of the first point, or <code class="literal">NULL</code></p></td>
|
975
975
|
<td class="parameter_annotations"> </td>
|
976
976
|
</tr>
|
977
977
|
<tr>
|
978
978
|
<td class="parameter_name"><p>y0</p></td>
|
979
|
-
<td class="parameter_description"><p>return value for the y coordinate of the first point, or <
|
979
|
+
<td class="parameter_description"><p>return value for the y coordinate of the first point, or <code class="literal">NULL</code></p></td>
|
980
980
|
<td class="parameter_annotations"> </td>
|
981
981
|
</tr>
|
982
982
|
<tr>
|
983
983
|
<td class="parameter_name"><p>x1</p></td>
|
984
|
-
<td class="parameter_description"><p>return value for the x coordinate of the second point, or <
|
984
|
+
<td class="parameter_description"><p>return value for the x coordinate of the second point, or <code class="literal">NULL</code></p></td>
|
985
985
|
<td class="parameter_annotations"> </td>
|
986
986
|
</tr>
|
987
987
|
<tr>
|
988
988
|
<td class="parameter_name"><p>y1</p></td>
|
989
|
-
<td class="parameter_description"><p>return value for the y coordinate of the second point, or <
|
989
|
+
<td class="parameter_description"><p>return value for the y coordinate of the second point, or <code class="literal">NULL</code></p></td>
|
990
990
|
<td class="parameter_annotations"> </td>
|
991
991
|
</tr>
|
992
992
|
</tbody>
|
@@ -1104,32 +1104,32 @@ specified as a center coordinate and a radius.</p>
|
|
1104
1104
|
</tr>
|
1105
1105
|
<tr>
|
1106
1106
|
<td class="parameter_name"><p>x0</p></td>
|
1107
|
-
<td class="parameter_description"><p>return value for the x coordinate of the center of the first circle, or <
|
1107
|
+
<td class="parameter_description"><p>return value for the x coordinate of the center of the first circle, or <code class="literal">NULL</code></p></td>
|
1108
1108
|
<td class="parameter_annotations"> </td>
|
1109
1109
|
</tr>
|
1110
1110
|
<tr>
|
1111
1111
|
<td class="parameter_name"><p>y0</p></td>
|
1112
|
-
<td class="parameter_description"><p>return value for the y coordinate of the center of the first circle, or <
|
1112
|
+
<td class="parameter_description"><p>return value for the y coordinate of the center of the first circle, or <code class="literal">NULL</code></p></td>
|
1113
1113
|
<td class="parameter_annotations"> </td>
|
1114
1114
|
</tr>
|
1115
1115
|
<tr>
|
1116
1116
|
<td class="parameter_name"><p>r0</p></td>
|
1117
|
-
<td class="parameter_description"><p>return value for the radius of the first circle, or <
|
1117
|
+
<td class="parameter_description"><p>return value for the radius of the first circle, or <code class="literal">NULL</code></p></td>
|
1118
1118
|
<td class="parameter_annotations"> </td>
|
1119
1119
|
</tr>
|
1120
1120
|
<tr>
|
1121
1121
|
<td class="parameter_name"><p>x1</p></td>
|
1122
|
-
<td class="parameter_description"><p>return value for the x coordinate of the center of the second circle, or <
|
1122
|
+
<td class="parameter_description"><p>return value for the x coordinate of the center of the second circle, or <code class="literal">NULL</code></p></td>
|
1123
1123
|
<td class="parameter_annotations"> </td>
|
1124
1124
|
</tr>
|
1125
1125
|
<tr>
|
1126
1126
|
<td class="parameter_name"><p>y1</p></td>
|
1127
|
-
<td class="parameter_description"><p>return value for the y coordinate of the center of the second circle, or <
|
1127
|
+
<td class="parameter_description"><p>return value for the y coordinate of the center of the second circle, or <code class="literal">NULL</code></p></td>
|
1128
1128
|
<td class="parameter_annotations"> </td>
|
1129
1129
|
</tr>
|
1130
1130
|
<tr>
|
1131
1131
|
<td class="parameter_name"><p>r1</p></td>
|
1132
|
-
<td class="parameter_description"><p>return value for the radius of the second circle, or <
|
1132
|
+
<td class="parameter_description"><p>return value for the radius of the second circle, or <code class="literal">NULL</code></p></td>
|
1133
1133
|
<td class="parameter_annotations"> </td>
|
1134
1134
|
</tr>
|
1135
1135
|
</tbody>
|
@@ -1774,7 +1774,7 @@ during the definition of the first patch.</p>
|
|
1774
1774
|
</tr>
|
1775
1775
|
<tr>
|
1776
1776
|
<td class="parameter_name"><p>count</p></td>
|
1777
|
-
<td class="parameter_description"><p>return value for the number patches, or <
|
1777
|
+
<td class="parameter_description"><p>return value for the number patches, or <code class="literal">NULL</code></p></td>
|
1778
1778
|
<td class="parameter_annotations"> </td>
|
1779
1779
|
</tr>
|
1780
1780
|
</tbody>
|
@@ -1883,12 +1883,12 @@ control points as explained in <a class="link" href="cairo-cairo-pattern-t.html#
|
|
1883
1883
|
</tr>
|
1884
1884
|
<tr>
|
1885
1885
|
<td class="parameter_name"><p>x</p></td>
|
1886
|
-
<td class="parameter_description"><p>return value for the x coordinate of the control point, or <
|
1886
|
+
<td class="parameter_description"><p>return value for the x coordinate of the control point, or <code class="literal">NULL</code></p></td>
|
1887
1887
|
<td class="parameter_annotations"> </td>
|
1888
1888
|
</tr>
|
1889
1889
|
<tr>
|
1890
1890
|
<td class="parameter_name"><p>y</p></td>
|
1891
|
-
<td class="parameter_description"><p>return value for the y coordinate of the control point, or <
|
1891
|
+
<td class="parameter_description"><p>return value for the y coordinate of the control point, or <code class="literal">NULL</code></p></td>
|
1892
1892
|
<td class="parameter_annotations"> </td>
|
1893
1893
|
</tr>
|
1894
1894
|
</tbody>
|
@@ -1955,22 +1955,22 @@ corners as explained in <a class="link" href="cairo-cairo-pattern-t.html#cairo-p
|
|
1955
1955
|
</tr>
|
1956
1956
|
<tr>
|
1957
1957
|
<td class="parameter_name"><p>red</p></td>
|
1958
|
-
<td class="parameter_description"><p>return value for red component of color, or <
|
1958
|
+
<td class="parameter_description"><p>return value for red component of color, or <code class="literal">NULL</code></p></td>
|
1959
1959
|
<td class="parameter_annotations"> </td>
|
1960
1960
|
</tr>
|
1961
1961
|
<tr>
|
1962
1962
|
<td class="parameter_name"><p>green</p></td>
|
1963
|
-
<td class="parameter_description"><p>return value for green component of color, or <
|
1963
|
+
<td class="parameter_description"><p>return value for green component of color, or <code class="literal">NULL</code></p></td>
|
1964
1964
|
<td class="parameter_annotations"> </td>
|
1965
1965
|
</tr>
|
1966
1966
|
<tr>
|
1967
1967
|
<td class="parameter_name"><p>blue</p></td>
|
1968
|
-
<td class="parameter_description"><p>return value for blue component of color, or <
|
1968
|
+
<td class="parameter_description"><p>return value for blue component of color, or <code class="literal">NULL</code></p></td>
|
1969
1969
|
<td class="parameter_annotations"> </td>
|
1970
1970
|
</tr>
|
1971
1971
|
<tr>
|
1972
1972
|
<td class="parameter_name"><p>alpha</p></td>
|
1973
|
-
<td class="parameter_description"><p>return value for alpha component of color, or <
|
1973
|
+
<td class="parameter_description"><p>return value for alpha component of color, or <code class="literal">NULL</code></p></td>
|
1974
1974
|
<td class="parameter_annotations"> </td>
|
1975
1975
|
</tr>
|
1976
1976
|
</tbody>
|
@@ -2000,8 +2000,8 @@ cairo_pattern_reference (<em class="parameter"><code><a class="link" href="cairo
|
|
2000
2000
|
<em class="parameter"><code>pattern</code></em>
|
2001
2001
|
from being destroyed until a matching call to
|
2002
2002
|
<a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-destroy" title="cairo_pattern_destroy ()"><code class="function">cairo_pattern_destroy()</code></a> is made.</p>
|
2003
|
-
<p>
|
2004
|
-
<a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-
|
2003
|
+
<p>Use <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-get-reference-count" title="cairo_pattern_get_reference_count ()"><code class="function">cairo_pattern_get_reference_count()</code></a> to get the number of
|
2004
|
+
references to a <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a>.</p>
|
2005
2005
|
<div class="refsect3">
|
2006
2006
|
<a name="id-1.3.4.7.28.6"></a><h4>Parameters</h4>
|
2007
2007
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -2307,8 +2307,8 @@ cairo_pattern_get_matrix (<em class="parameter"><code><a class="link" href="cair
|
|
2307
2307
|
<a name="cairo-pattern-get-type"></a><h3>cairo_pattern_get_type ()</h3>
|
2308
2308
|
<pre class="programlisting"><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t"><span class="returnvalue">cairo_pattern_type_t</span></a>
|
2309
2309
|
cairo_pattern_get_type (<em class="parameter"><code><a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-t" title="cairo_pattern_t"><span class="type">cairo_pattern_t</span></a> *pattern</code></em>);</pre>
|
2310
|
-
<p>
|
2311
|
-
|
2310
|
+
<p>Get the pattern's type. See <a class="link" href="cairo-cairo-pattern-t.html#cairo-pattern-type-t" title="enum cairo_pattern_type_t"><span class="type">cairo_pattern_type_t</span></a> for available
|
2311
|
+
types.</p>
|
2312
2312
|
<div class="refsect3">
|
2313
2313
|
<a name="id-1.3.4.7.37.5"></a><h4>Parameters</h4>
|
2314
2314
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -2373,7 +2373,7 @@ cairo_pattern_set_user_data (<em class="parameter"><code><a class="link" href="c
|
|
2373
2373
|
<em class="parameter"><code><a class="link" href="cairo-Types.html#cairo-destroy-func-t" title="cairo_destroy_func_t ()"><span class="type">cairo_destroy_func_t</span></a> destroy</code></em>);</pre>
|
2374
2374
|
<p>Attach user data to <em class="parameter"><code>pattern</code></em>
|
2375
2375
|
. To remove user data from a surface,
|
2376
|
-
call this function with the key that was used to set it and <
|
2376
|
+
call this function with the key that was used to set it and <code class="literal">NULL</code>
|
2377
2377
|
for <em class="parameter"><code>data</code></em>
|
2378
2378
|
.</p>
|
2379
2379
|
<div class="refsect3">
|
@@ -2427,7 +2427,7 @@ cairo_pattern_get_user_data (<em class="parameter"><code><a class="link" href="c
|
|
2427
2427
|
<p>Return user data previously attached to <em class="parameter"><code>pattern</code></em>
|
2428
2428
|
using the
|
2429
2429
|
specified key. If no user data has been attached with the given
|
2430
|
-
key this function returns <
|
2430
|
+
key this function returns <code class="literal">NULL</code>.</p>
|
2431
2431
|
<div class="refsect3">
|
2432
2432
|
<a name="id-1.3.4.7.40.5"></a><h4>Parameters</h4>
|
2433
2433
|
<div class="informaltable"><table width="100%" border="0">
|
@@ -2453,7 +2453,7 @@ attached to</p></td>
|
|
2453
2453
|
</div>
|
2454
2454
|
<div class="refsect3">
|
2455
2455
|
<a name="id-1.3.4.7.40.6"></a><h4>Returns</h4>
|
2456
|
-
<p> the user data previously attached or <
|
2456
|
+
<p> the user data previously attached or <code class="literal">NULL</code>.</p>
|
2457
2457
|
<p></p>
|
2458
2458
|
</div>
|
2459
2459
|
<p class="since">Since 1.4</p>
|