gdk_pixbuf2 3.2.1-x64-mingw32 → 3.2.2-x64-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +5 -5
- data/dependency-check/Rakefile +1 -2
- data/lib/gdk_pixbuf2/pixbuf.rb +19 -3
- data/test/test-pixbuf.rb +22 -5
- data/vendor/local/bin/gdk-pixbuf-csource.exe +0 -0
- data/vendor/local/bin/gdk-pixbuf-pixdata.exe +0 -0
- data/vendor/local/bin/gdk-pixbuf-query-loaders.exe +0 -0
- data/vendor/local/bin/gdk-pixbuf-thumbnailer.exe +0 -0
- data/vendor/local/bin/libgdk_pixbuf-2.0-0.dll +0 -0
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-enum-types.h +1 -1
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-marshal.h +20 -18
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache +47 -47
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.a +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll.a +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.la +2 -2
- data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
- data/vendor/local/lib/libgdk_pixbuf-2.0.la +2 -2
- data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +1 -1
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +59 -59
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +64 -64
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +89 -89
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +103 -103
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +22 -22
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +36 -36
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +51 -51
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +10 -10
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Scaling.html +10 -10
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +59 -59
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Utilities.html +11 -11
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html +3 -3
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-XlibRGB.html +4 -4
- data/vendor/local/share/thumbnailers/gdk-pixbuf-thumbnailer.thumbnailer +2 -2
- metadata +7 -7
@@ -123,7 +123,7 @@
|
|
123
123
|
</tr>
|
124
124
|
<tr>
|
125
125
|
<td class="function_type">
|
126
|
-
<a href="
|
126
|
+
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
127
127
|
</td>
|
128
128
|
<td class="function_name">
|
129
129
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-is-static-image" title="gdk_pixbuf_animation_is_static_image ()">gdk_pixbuf_animation_is_static_image</a> <span class="c_punctuation">()</span>
|
@@ -139,7 +139,7 @@
|
|
139
139
|
</tr>
|
140
140
|
<tr>
|
141
141
|
<td class="function_type">
|
142
|
-
<a href="
|
142
|
+
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
143
143
|
</td>
|
144
144
|
<td class="function_name">
|
145
145
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()">gdk_pixbuf_animation_iter_advance</a> <span class="c_punctuation">()</span>
|
@@ -155,7 +155,7 @@
|
|
155
155
|
</tr>
|
156
156
|
<tr>
|
157
157
|
<td class="function_type">
|
158
|
-
<a href="
|
158
|
+
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
159
159
|
</td>
|
160
160
|
<td class="function_name">
|
161
161
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame" title="gdk_pixbuf_animation_iter_on_currently_loading_frame ()">gdk_pixbuf_animation_iter_on_currently_loading_frame</a> <span class="c_punctuation">()</span>
|
@@ -195,7 +195,7 @@
|
|
195
195
|
</tr>
|
196
196
|
<tr>
|
197
197
|
<td class="function_type">
|
198
|
-
<a href="
|
198
|
+
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
199
199
|
</td>
|
200
200
|
<td class="function_name">
|
201
201
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-simple-anim-get-loop" title="gdk_pixbuf_simple_anim_get_loop ()">gdk_pixbuf_simple_anim_get_loop</a> <span class="c_punctuation">()</span>
|
@@ -213,7 +213,7 @@
|
|
213
213
|
<col width="200px" class="properties_flags">
|
214
214
|
</colgroup>
|
215
215
|
<tbody><tr>
|
216
|
-
<td class="property_type"><a href="
|
216
|
+
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
|
217
217
|
<td class="property_name"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim--loop" title="The “loop” property">loop</a></td>
|
218
218
|
<td class="property_flags">Read / Write</td>
|
219
219
|
</tr></tbody>
|
@@ -244,7 +244,7 @@
|
|
244
244
|
</div>
|
245
245
|
<div class="refsect1">
|
246
246
|
<a name="gdk-pixbuf-Animations.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
247
|
-
<pre class="screen"> <a href="
|
247
|
+
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
|
248
248
|
<span class="lineart">├──</span> GdkPixbufAnimation
|
249
249
|
<span class="lineart">│</span> <span class="lineart">╰──</span> GdkPixbufSimpleAnim
|
250
250
|
<span class="lineart">╰──</span> GdkPixbufAnimationIter
|
@@ -272,11 +272,11 @@ be displayed at a given point in time.</p>
|
|
272
272
|
<a name="gdk-pixbuf-animation-new-from-file"></a><h3>gdk_pixbuf_animation_new_from_file ()</h3>
|
273
273
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> *
|
274
274
|
gdk_pixbuf_animation_new_from_file (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
275
|
-
<em class="parameter"><code><a href="
|
275
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
276
276
|
<p>Creates a new animation by loading it from a file. The file format is
|
277
277
|
detected automatically. If the file's format does not support multi-frame
|
278
278
|
images, then an animation with a single frame will be created. Possible errors
|
279
|
-
are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
279
|
+
are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../glib/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.</p>
|
280
280
|
<div class="refsect3">
|
281
281
|
<a name="gdk-pixbuf-animation-new-from-file.parameters"></a><h4>Parameters</h4>
|
282
282
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -301,7 +301,7 @@ are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIX
|
|
301
301
|
</div>
|
302
302
|
<div class="refsect3">
|
303
303
|
<a name="gdk-pixbuf-animation-new-from-file.returns"></a><h4>Returns</h4>
|
304
|
-
<p> A newly-created animation with a reference count of 1, or <a href="
|
304
|
+
<p> A newly-created animation with a reference count of 1, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
|
305
305
|
if any of several error conditions ocurred: the file could not be opened,
|
306
306
|
there was no loader for the file's format, there was not enough memory to
|
307
307
|
allocate the image buffer, or the image file contained invalid data.</p>
|
@@ -313,9 +313,9 @@ allocate the image buffer, or the image file contained invalid data.</p>
|
|
313
313
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> *
|
314
314
|
gdk_pixbuf_animation_new_from_resource
|
315
315
|
(<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>,
|
316
|
-
<em class="parameter"><code><a href="
|
316
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
317
317
|
<p>Creates a new pixbuf animation by loading an image from an resource.</p>
|
318
|
-
<p>The file format is detected automatically. If <a href="
|
318
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
319
319
|
<em class="parameter"><code>error</code></em>
|
320
320
|
will be set.</p>
|
321
321
|
<div class="refsect3">
|
@@ -342,7 +342,7 @@ gdk_pixbuf_animation_new_from_resource
|
|
342
342
|
</div>
|
343
343
|
<div class="refsect3">
|
344
344
|
<a name="gdk-pixbuf-animation-new-from-resource.returns"></a><h4>Returns</h4>
|
345
|
-
<p> A newly-created animation, or <a href="
|
345
|
+
<p> A newly-created animation, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
346
346
|
conditions occurred: the file could not be opened, the image format is
|
347
347
|
not supported, there was not enough memory to allocate the image buffer,
|
348
348
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -353,17 +353,17 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
353
353
|
<div class="refsect2">
|
354
354
|
<a name="gdk-pixbuf-animation-new-from-stream"></a><h3>gdk_pixbuf_animation_new_from_stream ()</h3>
|
355
355
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> *
|
356
|
-
gdk_pixbuf_animation_new_from_stream (<em class="parameter"><code><a href="
|
357
|
-
<em class="parameter"><code><a href="
|
358
|
-
<em class="parameter"><code><a href="
|
356
|
+
gdk_pixbuf_animation_new_from_stream (<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
357
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
358
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
359
359
|
<p>Creates a new animation by loading it from an input stream.</p>
|
360
|
-
<p>The file format is detected automatically. If <a href="
|
360
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
361
361
|
<em class="parameter"><code>error</code></em>
|
362
362
|
will be set. The <em class="parameter"><code>cancellable</code></em>
|
363
363
|
can be used to abort the operation
|
364
364
|
from another thread. If the operation was cancelled, the error
|
365
|
-
<a href="
|
366
|
-
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
365
|
+
<a href="../gio/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. Other possible errors are in
|
366
|
+
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../gio/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains.</p>
|
367
367
|
<p>The stream is not closed.</p>
|
368
368
|
<div class="refsect3">
|
369
369
|
<a name="gdk-pixbuf-animation-new-from-stream.parameters"></a><h4>Parameters</h4>
|
@@ -376,12 +376,12 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
376
376
|
<tbody>
|
377
377
|
<tr>
|
378
378
|
<td class="parameter_name"><p>stream</p></td>
|
379
|
-
<td class="parameter_description"><p>a <a href="
|
379
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> to load the pixbuf from</p></td>
|
380
380
|
<td class="parameter_annotations"> </td>
|
381
381
|
</tr>
|
382
382
|
<tr>
|
383
383
|
<td class="parameter_name"><p>cancellable</p></td>
|
384
|
-
<td class="parameter_description"><p> optional <a href="
|
384
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
385
385
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
386
386
|
</tr>
|
387
387
|
<tr>
|
@@ -394,7 +394,7 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
394
394
|
</div>
|
395
395
|
<div class="refsect3">
|
396
396
|
<a name="gdk-pixbuf-animation-new-from-stream.returns"></a><h4>Returns</h4>
|
397
|
-
<p> A newly-created pixbuf, or <a href="
|
397
|
+
<p> A newly-created pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
398
398
|
conditions occurred: the file could not be opened, the image format is
|
399
399
|
not supported, there was not enough memory to allocate the image buffer,
|
400
400
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -406,10 +406,10 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
406
406
|
<a name="gdk-pixbuf-animation-new-from-stream-async"></a><h3>gdk_pixbuf_animation_new_from_stream_async ()</h3>
|
407
407
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
408
408
|
gdk_pixbuf_animation_new_from_stream_async
|
409
|
-
(<em class="parameter"><code><a href="
|
410
|
-
<em class="parameter"><code><a href="
|
411
|
-
<em class="parameter"><code><a href="
|
412
|
-
<em class="parameter"><code><a href="
|
409
|
+
(<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
410
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
411
|
+
<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
412
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
413
413
|
<p>Creates a new animation by asynchronously loading an image from an input stream.</p>
|
414
414
|
<p>For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()"><code class="function">gdk_pixbuf_new_from_stream()</code></a>, which is the synchronous
|
415
415
|
version of this function.</p>
|
@@ -428,17 +428,17 @@ result of the operation.</p>
|
|
428
428
|
<tbody>
|
429
429
|
<tr>
|
430
430
|
<td class="parameter_name"><p>stream</p></td>
|
431
|
-
<td class="parameter_description"><p>a <a href="
|
431
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> from which to load the animation</p></td>
|
432
432
|
<td class="parameter_annotations"> </td>
|
433
433
|
</tr>
|
434
434
|
<tr>
|
435
435
|
<td class="parameter_name"><p>cancellable</p></td>
|
436
|
-
<td class="parameter_description"><p> optional <a href="
|
436
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
437
437
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
438
438
|
</tr>
|
439
439
|
<tr>
|
440
440
|
<td class="parameter_name"><p>callback</p></td>
|
441
|
-
<td class="parameter_description"><p>a <a href="
|
441
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the pixbuf is loaded</p></td>
|
442
442
|
<td class="parameter_annotations"> </td>
|
443
443
|
</tr>
|
444
444
|
<tr>
|
@@ -456,8 +456,8 @@ result of the operation.</p>
|
|
456
456
|
<a name="gdk-pixbuf-animation-new-from-stream-finish"></a><h3>gdk_pixbuf_animation_new_from_stream_finish ()</h3>
|
457
457
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="returnvalue">GdkPixbufAnimation</span></a> *
|
458
458
|
gdk_pixbuf_animation_new_from_stream_finish
|
459
|
-
(<em class="parameter"><code><a href="
|
460
|
-
<em class="parameter"><code><a href="
|
459
|
+
(<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *async_result</code></em>,
|
460
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
461
461
|
<p>Finishes an asynchronous pixbuf animation creation operation started with
|
462
462
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-stream-async" title="gdk_pixbuf_animation_new_from_stream_async ()"><code class="function">gdk_pixbuf_animation_new_from_stream_async()</code></a>.</p>
|
463
463
|
<div class="refsect3">
|
@@ -471,12 +471,12 @@ gdk_pixbuf_animation_new_from_stream_finish
|
|
471
471
|
<tbody>
|
472
472
|
<tr>
|
473
473
|
<td class="parameter_name"><p>async_result</p></td>
|
474
|
-
<td class="parameter_description"><p>a <a href="
|
474
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a></p></td>
|
475
475
|
<td class="parameter_annotations"> </td>
|
476
476
|
</tr>
|
477
477
|
<tr>
|
478
478
|
<td class="parameter_name"><p>error</p></td>
|
479
|
-
<td class="parameter_description"><p>a <a href="
|
479
|
+
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
480
480
|
<td class="parameter_annotations"> </td>
|
481
481
|
</tr>
|
482
482
|
</tbody>
|
@@ -484,8 +484,8 @@ gdk_pixbuf_animation_new_from_stream_finish
|
|
484
484
|
</div>
|
485
485
|
<div class="refsect3">
|
486
486
|
<a name="gdk-pixbuf-animation-new-from-stream-finish.returns"></a><h4>Returns</h4>
|
487
|
-
<p> a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> or <a href="
|
488
|
-
object with <a href="
|
487
|
+
<p> a <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned
|
488
|
+
object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
489
489
|
</div>
|
490
490
|
<p class="since">Since: <a class="link" href="api-index-2-28.html#api-index-2.28">2.28</a></p>
|
491
491
|
</div>
|
@@ -496,7 +496,7 @@ object with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gt
|
|
496
496
|
gdk_pixbuf_animation_ref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre>
|
497
497
|
<div class="warning">
|
498
498
|
<p><code class="literal">gdk_pixbuf_animation_ref</code> has been deprecated since version 2.0 and should not be used in newly-written code.</p>
|
499
|
-
<p>Use <a href="
|
499
|
+
<p>Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.</p>
|
500
500
|
</div>
|
501
501
|
<p>Adds a reference to an animation.</p>
|
502
502
|
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
@@ -528,7 +528,7 @@ argument.</p>
|
|
528
528
|
gdk_pixbuf_animation_unref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre>
|
529
529
|
<div class="warning">
|
530
530
|
<p><code class="literal">gdk_pixbuf_animation_unref</code> has been deprecated since version 2.0 and should not be used in newly-written code.</p>
|
531
|
-
<p>Use <a href="
|
531
|
+
<p>Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
532
532
|
</div>
|
533
533
|
<p>Removes a reference from an animation.</p>
|
534
534
|
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
@@ -605,23 +605,23 @@ gdk_pixbuf_animation_get_height (<em class="parameter"><code><a class="link" hre
|
|
605
605
|
<a name="gdk-pixbuf-animation-get-iter"></a><h3>gdk_pixbuf_animation_get_iter ()</h3>
|
606
606
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="returnvalue">GdkPixbufAnimationIter</span></a> *
|
607
607
|
gdk_pixbuf_animation_get_iter (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>,
|
608
|
-
<em class="parameter"><code>const <a href="
|
608
|
+
<em class="parameter"><code>const <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *start_time</code></em>);</pre>
|
609
609
|
<p>Get an iterator for displaying an animation. The iterator provides
|
610
610
|
the frames that should be displayed at a given time. It should be
|
611
|
-
freed after use with <a href="
|
611
|
+
freed after use with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
612
612
|
<p><em class="parameter"><code>start_time</code></em>
|
613
|
-
would normally come from <a href="
|
613
|
+
would normally come from <a href="../glib/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>, and marks
|
614
614
|
the beginning of animation playback. After creating an iterator, you
|
615
615
|
should immediately display the pixbuf returned by
|
616
616
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a>. Then, you should install
|
617
|
-
a timeout (with <a href="
|
617
|
+
a timeout (with <a href="../glib/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a>) or by some other mechanism ensure
|
618
618
|
that you'll update the image after
|
619
619
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-delay-time" title="gdk_pixbuf_animation_iter_get_delay_time ()"><code class="function">gdk_pixbuf_animation_iter_get_delay_time()</code></a> milliseconds. Each time
|
620
620
|
the image is updated, you should reinstall the timeout with the new,
|
621
621
|
possibly-changed delay time.</p>
|
622
622
|
<p>As a shortcut, if <em class="parameter"><code>start_time</code></em>
|
623
|
-
is <a href="
|
624
|
-
<a href="
|
623
|
+
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the result of
|
624
|
+
<a href="../glib/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a> will be used automatically.</p>
|
625
625
|
<p>To update the image (i.e. possibly change the result of
|
626
626
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a> to a new frame of the animation),
|
627
627
|
call <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-advance" title="gdk_pixbuf_animation_iter_advance ()"><code class="function">gdk_pixbuf_animation_iter_advance()</code></a>.</p>
|
@@ -629,7 +629,7 @@ call <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-
|
|
629
629
|
after the delay time, you should also update it whenever you
|
630
630
|
receive the area_updated signal and
|
631
631
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-on-currently-loading-frame" title="gdk_pixbuf_animation_iter_on_currently_loading_frame ()"><code class="function">gdk_pixbuf_animation_iter_on_currently_loading_frame()</code></a> returns
|
632
|
-
<a href="
|
632
|
+
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. In this case, the frame currently being fed into the loader
|
633
633
|
has received new data, so needs to be refreshed. The delay time for
|
634
634
|
a frame may also be modified after an area_updated signal, for
|
635
635
|
example if the delay time for a frame is encoded in the data after
|
@@ -667,11 +667,11 @@ area_updated signal.</p>
|
|
667
667
|
<hr>
|
668
668
|
<div class="refsect2">
|
669
669
|
<a name="gdk-pixbuf-animation-is-static-image"></a><h3>gdk_pixbuf_animation_is_static_image ()</h3>
|
670
|
-
<pre class="programlisting"><a href="
|
670
|
+
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
671
671
|
gdk_pixbuf_animation_is_static_image (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *animation</code></em>);</pre>
|
672
672
|
<p>If you load a file with <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-new-from-file" title="gdk_pixbuf_animation_new_from_file ()"><code class="function">gdk_pixbuf_animation_new_from_file()</code></a> and it
|
673
673
|
turns out to be a plain, unanimated image, then this function will
|
674
|
-
return <a href="
|
674
|
+
return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Use <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-static-image" title="gdk_pixbuf_animation_get_static_image ()"><code class="function">gdk_pixbuf_animation_get_static_image()</code></a> to retrieve
|
675
675
|
the image.</p>
|
676
676
|
<div class="refsect3">
|
677
677
|
<a name="gdk-pixbuf-animation-is-static-image.parameters"></a><h4>Parameters</h4>
|
@@ -690,7 +690,7 @@ the image.</p>
|
|
690
690
|
</div>
|
691
691
|
<div class="refsect3">
|
692
692
|
<a name="gdk-pixbuf-animation-is-static-image.returns"></a><h4>Returns</h4>
|
693
|
-
<p> <a href="
|
693
|
+
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the "animation" was really just an image</p>
|
694
694
|
</div>
|
695
695
|
</div>
|
696
696
|
<hr>
|
@@ -703,7 +703,7 @@ this function returns that image. If the animation is an animation,
|
|
703
703
|
this function returns a reasonable thing to display as a static
|
704
704
|
unanimated image, which might be the first frame, or something more
|
705
705
|
sophisticated. If an animation hasn't loaded any frames yet, this
|
706
|
-
function will return <a href="
|
706
|
+
function will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
|
707
707
|
<div class="refsect3">
|
708
708
|
<a name="gdk-pixbuf-animation-get-static-image.parameters"></a><h4>Parameters</h4>
|
709
709
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -728,26 +728,26 @@ function will return <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local
|
|
728
728
|
<hr>
|
729
729
|
<div class="refsect2">
|
730
730
|
<a name="gdk-pixbuf-animation-iter-advance"></a><h3>gdk_pixbuf_animation_iter_advance ()</h3>
|
731
|
-
<pre class="programlisting"><a href="
|
731
|
+
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
732
732
|
gdk_pixbuf_animation_iter_advance (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>,
|
733
|
-
<em class="parameter"><code>const <a href="
|
733
|
+
<em class="parameter"><code>const <a href="../glib/glib-Date-and-Time-Functions.html#GTimeVal"><span class="type">GTimeVal</span></a> *current_time</code></em>);</pre>
|
734
734
|
<p>Possibly advances an animation to a new frame. Chooses the frame based
|
735
735
|
on the start time passed to <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()"><code class="function">gdk_pixbuf_animation_get_iter()</code></a>.</p>
|
736
736
|
<p><em class="parameter"><code>current_time</code></em>
|
737
|
-
would normally come from <a href="
|
737
|
+
would normally come from <a href="../glib/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>, and
|
738
738
|
must be greater than or equal to the time passed to
|
739
739
|
<a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-get-iter" title="gdk_pixbuf_animation_get_iter ()"><code class="function">gdk_pixbuf_animation_get_iter()</code></a>, and must increase or remain
|
740
740
|
unchanged each time <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a> is
|
741
741
|
called. That is, you can't go backward in time; animations only
|
742
742
|
play forward.</p>
|
743
|
-
<p>As a shortcut, pass <a href="
|
743
|
+
<p>As a shortcut, pass <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the current time and <a href="../glib/glib-Date-and-Time-Functions.html#g-get-current-time"><code class="function">g_get_current_time()</code></a>
|
744
744
|
will be invoked on your behalf. So you only need to explicitly pass
|
745
745
|
<em class="parameter"><code>current_time</code></em>
|
746
746
|
if you're doing something odd like playing the animation
|
747
747
|
at double speed.</p>
|
748
|
-
<p>If this function returns <a href="
|
748
|
+
<p>If this function returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, there's no need to update the animation
|
749
749
|
display, assuming the display had been rendered prior to advancing;
|
750
|
-
if <a href="
|
750
|
+
if <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, you need to call <a class="link" href="gdk-pixbuf-Animations.html#gdk-pixbuf-animation-iter-get-pixbuf" title="gdk_pixbuf_animation_iter_get_pixbuf ()"><code class="function">gdk_pixbuf_animation_iter_get_pixbuf()</code></a>
|
751
751
|
and update the display with the new pixbuf.</p>
|
752
752
|
<div class="refsect3">
|
753
753
|
<a name="gdk-pixbuf-animation-iter-advance.parameters"></a><h4>Parameters</h4>
|
@@ -773,7 +773,7 @@ and update the display with the new pixbuf.</p>
|
|
773
773
|
</div>
|
774
774
|
<div class="refsect3">
|
775
775
|
<a name="gdk-pixbuf-animation-iter-advance.returns"></a><h4>Returns</h4>
|
776
|
-
<p> <a href="
|
776
|
+
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the image may need updating</p>
|
777
777
|
</div>
|
778
778
|
</div>
|
779
779
|
<hr>
|
@@ -783,7 +783,7 @@ and update the display with the new pixbuf.</p>
|
|
783
783
|
gdk_pixbuf_animation_iter_get_delay_time
|
784
784
|
(<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>);</pre>
|
785
785
|
<p>Gets the number of milliseconds the current pixbuf should be displayed,
|
786
|
-
or -1 if the current pixbuf should be displayed forever. <a href="
|
786
|
+
or -1 if the current pixbuf should be displayed forever. <a href="../glib/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a>
|
787
787
|
conveniently takes a timeout in milliseconds, so you can use a timeout
|
788
788
|
to schedule the next update.</p>
|
789
789
|
<p>Note that some formats, like GIF, might clamp the timeout values in the
|
@@ -812,7 +812,7 @@ for GIF images is currently 20 milliseconds.</p>
|
|
812
812
|
<hr>
|
813
813
|
<div class="refsect2">
|
814
814
|
<a name="gdk-pixbuf-animation-iter-on-currently-loading-frame"></a><h3>gdk_pixbuf_animation_iter_on_currently_loading_frame ()</h3>
|
815
|
-
<pre class="programlisting"><a href="
|
815
|
+
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
816
816
|
gdk_pixbuf_animation_iter_on_currently_loading_frame
|
817
817
|
(<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a> *iter</code></em>);</pre>
|
818
818
|
<p>Used to determine how to respond to the area_updated signal on
|
@@ -837,7 +837,7 @@ the updated area.</p>
|
|
837
837
|
</div>
|
838
838
|
<div class="refsect3">
|
839
839
|
<a name="gdk-pixbuf-animation-iter-on-currently-loading-frame.returns"></a><h4>Returns</h4>
|
840
|
-
<p> <a href="
|
840
|
+
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the frame we're on is partially loaded, or the last frame</p>
|
841
841
|
</div>
|
842
842
|
</div>
|
843
843
|
<hr>
|
@@ -881,9 +881,9 @@ the iterator.</p>
|
|
881
881
|
<div class="refsect2">
|
882
882
|
<a name="gdk-pixbuf-simple-anim-new"></a><h3>gdk_pixbuf_simple_anim_new ()</h3>
|
883
883
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="returnvalue">GdkPixbufSimpleAnim</span></a> *
|
884
|
-
gdk_pixbuf_simple_anim_new (<em class="parameter"><code><a href="
|
885
|
-
<em class="parameter"><code><a href="
|
886
|
-
<em class="parameter"><code><a href="
|
884
|
+
gdk_pixbuf_simple_anim_new (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
|
885
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
|
886
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> rate</code></em>);</pre>
|
887
887
|
<p>Creates a new, empty animation.</p>
|
888
888
|
<div class="refsect3">
|
889
889
|
<a name="gdk-pixbuf-simple-anim-new.parameters"></a><h4>Parameters</h4>
|
@@ -958,7 +958,7 @@ was constructed.</p>
|
|
958
958
|
<a name="gdk-pixbuf-simple-anim-set-loop"></a><h3>gdk_pixbuf_simple_anim_set_loop ()</h3>
|
959
959
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
960
960
|
gdk_pixbuf_simple_anim_set_loop (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>,
|
961
|
-
<em class="parameter"><code><a href="
|
961
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> loop</code></em>);</pre>
|
962
962
|
<p>Sets whether <em class="parameter"><code>animation</code></em>
|
963
963
|
should loop indefinitely when it reaches the end.</p>
|
964
964
|
<div class="refsect3">
|
@@ -988,7 +988,7 @@ gdk_pixbuf_simple_anim_set_loop (<em class="parameter"><code><a class="link" hre
|
|
988
988
|
<hr>
|
989
989
|
<div class="refsect2">
|
990
990
|
<a name="gdk-pixbuf-simple-anim-get-loop"></a><h3>gdk_pixbuf_simple_anim_get_loop ()</h3>
|
991
|
-
<pre class="programlisting"><a href="
|
991
|
+
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
992
992
|
gdk_pixbuf_simple_anim_get_loop (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufSimpleAnim"><span class="type">GdkPixbufSimpleAnim</span></a> *animation</code></em>);</pre>
|
993
993
|
<p>Gets whether <em class="parameter"><code>animation</code></em>
|
994
994
|
should loop indefinitely when it reaches the end.</p>
|
@@ -1009,7 +1009,7 @@ gdk_pixbuf_simple_anim_get_loop (<em class="parameter"><code><a class="link" hre
|
|
1009
1009
|
</div>
|
1010
1010
|
<div class="refsect3">
|
1011
1011
|
<a name="gdk-pixbuf-simple-anim-get-loop.returns"></a><h4>Returns</h4>
|
1012
|
-
<p> <a href="
|
1012
|
+
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the animation loops forever, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
|
1013
1013
|
</div>
|
1014
1014
|
<p class="since">Since: 2.18</p>
|
1015
1015
|
</div>
|
@@ -1039,7 +1039,7 @@ certain position in an animation.</p>
|
|
1039
1039
|
<a name="gdk-pixbuf-Animations.property-details"></a><h2>Property Details</h2>
|
1040
1040
|
<div class="refsect2">
|
1041
1041
|
<a name="GdkPixbufSimpleAnim--loop"></a><h3>The <code class="literal">“loop”</code> property</h3>
|
1042
|
-
<pre class="programlisting"> “loop” <a href="
|
1042
|
+
<pre class="programlisting"> “loop” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
1043
1043
|
<p>Whether the animation should loop when it reaches the end.</p>
|
1044
1044
|
<p>Flags: Read / Write</p>
|
1045
1045
|
<p>Default value: FALSE</p>
|
@@ -169,11 +169,11 @@ loading can use the <a class="link" href="GdkPixbufLoader.html" title="GdkPixbuf
|
|
169
169
|
<a name="gdk-pixbuf-new-from-file"></a><h3>gdk_pixbuf_new_from_file ()</h3>
|
170
170
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
171
171
|
gdk_pixbuf_new_from_file (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
172
|
-
<em class="parameter"><code><a href="
|
172
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
173
173
|
<p>Creates a new pixbuf by loading an image from a file. The file format is
|
174
|
-
detected automatically. If <a href="
|
174
|
+
detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em>
|
175
175
|
will be set.
|
176
|
-
Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
176
|
+
Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../glib/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.</p>
|
177
177
|
<div class="refsect3">
|
178
178
|
<a name="gdk-pixbuf-new-from-file.parameters"></a><h4>Parameters</h4>
|
179
179
|
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
@@ -198,7 +198,7 @@ Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Struct
|
|
198
198
|
</div>
|
199
199
|
<div class="refsect3">
|
200
200
|
<a name="gdk-pixbuf-new-from-file.returns"></a><h4>Returns</h4>
|
201
|
-
<p> A newly-created pixbuf with a reference count of 1, or <a href="
|
201
|
+
<p> A newly-created pixbuf with a reference count of 1, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
|
202
202
|
any of several error conditions occurred: the file could not be opened,
|
203
203
|
there was no loader for the file's format, there was not enough memory to
|
204
204
|
allocate the image buffer, or the image file contained invalid data.</p>
|
@@ -211,12 +211,12 @@ allocate the image buffer, or the image file contained invalid data.</p>
|
|
211
211
|
gdk_pixbuf_new_from_file_at_size (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
212
212
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
213
213
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
214
|
-
<em class="parameter"><code><a href="
|
214
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
215
215
|
<p>Creates a new pixbuf by loading an image from a file.
|
216
|
-
The file format is detected automatically. If <a href="
|
216
|
+
The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
217
217
|
<em class="parameter"><code>error</code></em>
|
218
218
|
will be set. Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and
|
219
|
-
<a href="
|
219
|
+
<a href="../glib/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.</p>
|
220
220
|
<p>The image will be scaled to fit in the requested size, preserving
|
221
221
|
the image's aspect ratio. Note that the returned pixbuf may be smaller
|
222
222
|
than <em class="parameter"><code>width</code></em>
|
@@ -259,7 +259,7 @@ and image at the requested size, regardless of aspect ratio, use
|
|
259
259
|
<div class="refsect3">
|
260
260
|
<a name="gdk-pixbuf-new-from-file-at-size.returns"></a><h4>Returns</h4>
|
261
261
|
<p> A newly-created pixbuf with a reference count of 1, or
|
262
|
-
<a href="
|
262
|
+
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error conditions occurred: the file could not
|
263
263
|
be opened, there was no loader for the file's format, there was not
|
264
264
|
enough memory to allocate the image buffer, or the image file contained
|
265
265
|
invalid data.</p>
|
@@ -273,12 +273,12 @@ invalid data.</p>
|
|
273
273
|
gdk_pixbuf_new_from_file_at_scale (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
274
274
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
275
275
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
276
|
-
<em class="parameter"><code><a href="
|
277
|
-
<em class="parameter"><code><a href="
|
276
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
|
277
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
278
278
|
<p>Creates a new pixbuf by loading an image from a file. The file format is
|
279
|
-
detected automatically. If <a href="
|
279
|
+
detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em>
|
280
280
|
will be set.
|
281
|
-
Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
281
|
+
Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../glib/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.
|
282
282
|
The image will be scaled to fit in the requested size, optionally preserving
|
283
283
|
the image's aspect ratio. </p>
|
284
284
|
<p>When preserving the aspect ratio, a <em class="parameter"><code>width</code></em>
|
@@ -319,7 +319,7 @@ allowed since 2.8.</p>
|
|
319
319
|
</tr>
|
320
320
|
<tr>
|
321
321
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
322
|
-
<td class="parameter_description"><p><a href="
|
322
|
+
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</p></td>
|
323
323
|
<td class="parameter_annotations"> </td>
|
324
324
|
</tr>
|
325
325
|
<tr>
|
@@ -332,7 +332,7 @@ allowed since 2.8.</p>
|
|
332
332
|
</div>
|
333
333
|
<div class="refsect3">
|
334
334
|
<a name="gdk-pixbuf-new-from-file-at-scale.returns"></a><h4>Returns</h4>
|
335
|
-
<p> A newly-created pixbuf with a reference count of 1, or <a href="
|
335
|
+
<p> A newly-created pixbuf with a reference count of 1, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
|
336
336
|
if any of several error conditions occurred: the file could not be opened,
|
337
337
|
there was no loader for the file's format, there was not enough memory to
|
338
338
|
allocate the image buffer, or the image file contained invalid data.</p>
|
@@ -343,9 +343,9 @@ allocate the image buffer, or the image file contained invalid data.</p>
|
|
343
343
|
<div class="refsect2">
|
344
344
|
<a name="gdk-pixbuf-get-file-info"></a><h3>gdk_pixbuf_get_file_info ()</h3>
|
345
345
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> *
|
346
|
-
gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="
|
347
|
-
<em class="parameter"><code><a href="
|
348
|
-
<em class="parameter"><code><a href="
|
346
|
+
gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
|
347
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>,
|
348
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>);</pre>
|
349
349
|
<p>Parses an image file far enough to determine its format and size.</p>
|
350
350
|
<div class="refsect3">
|
351
351
|
<a name="gdk-pixbuf-get-file-info.parameters"></a><h4>Parameters</h4>
|
@@ -364,13 +364,13 @@ gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="/home/vagra
|
|
364
364
|
<tr>
|
365
365
|
<td class="parameter_name"><p>width</p></td>
|
366
366
|
<td class="parameter_description"><p> Return location for the width of the
|
367
|
-
image, or <a href="
|
367
|
+
image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
368
368
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
369
369
|
</tr>
|
370
370
|
<tr>
|
371
371
|
<td class="parameter_name"><p>height</p></td>
|
372
372
|
<td class="parameter_description"><p> Return location for the height of the
|
373
|
-
image, or <a href="
|
373
|
+
image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
374
374
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed instead of a pointer to a location."><span class="acronym">optional</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
375
375
|
</tr>
|
376
376
|
</tbody>
|
@@ -379,7 +379,7 @@ image, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-
|
|
379
379
|
<div class="refsect3">
|
380
380
|
<a name="gdk-pixbuf-get-file-info.returns"></a><h4>Returns</h4>
|
381
381
|
<p> A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing
|
382
|
-
the image format of the file or <a href="
|
382
|
+
the image format of the file or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image format wasn't
|
383
383
|
recognized. The return value is owned by <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> and should
|
384
384
|
not be freed. </p>
|
385
385
|
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
@@ -390,10 +390,10 @@ not be freed. </p>
|
|
390
390
|
<div class="refsect2">
|
391
391
|
<a name="gdk-pixbuf-get-file-info-async"></a><h3>gdk_pixbuf_get_file_info_async ()</h3>
|
392
392
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
393
|
-
gdk_pixbuf_get_file_info_async (<em class="parameter"><code>const <a href="
|
394
|
-
<em class="parameter"><code><a href="
|
395
|
-
<em class="parameter"><code><a href="
|
396
|
-
<em class="parameter"><code><a href="
|
393
|
+
gdk_pixbuf_get_file_info_async (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
|
394
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
395
|
+
<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
396
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
397
397
|
<p>Asynchronously parses an image file far enough to determine its
|
398
398
|
format and size.</p>
|
399
399
|
<p>For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()"><code class="function">gdk_pixbuf_get_file_info()</code></a>, which is the synchronous
|
@@ -418,12 +418,12 @@ get the result of the operation.</p>
|
|
418
418
|
</tr>
|
419
419
|
<tr>
|
420
420
|
<td class="parameter_name"><p>cancellable</p></td>
|
421
|
-
<td class="parameter_description"><p> optional <a href="
|
421
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
422
422
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
423
423
|
</tr>
|
424
424
|
<tr>
|
425
425
|
<td class="parameter_name"><p>callback</p></td>
|
426
|
-
<td class="parameter_description"><p>a <a href="
|
426
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the file info is available</p></td>
|
427
427
|
<td class="parameter_annotations"> </td>
|
428
428
|
</tr>
|
429
429
|
<tr>
|
@@ -440,10 +440,10 @@ get the result of the operation.</p>
|
|
440
440
|
<div class="refsect2">
|
441
441
|
<a name="gdk-pixbuf-get-file-info-finish"></a><h3>gdk_pixbuf_get_file_info_finish ()</h3>
|
442
442
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> *
|
443
|
-
gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="
|
444
|
-
<em class="parameter"><code><a href="
|
445
|
-
<em class="parameter"><code><a href="
|
446
|
-
<em class="parameter"><code><a href="
|
443
|
+
gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *async_result</code></em>,
|
444
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>,
|
445
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>,
|
446
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
447
447
|
<p>Finishes an asynchronous pixbuf parsing operation started with
|
448
448
|
<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info-async" title="gdk_pixbuf_get_file_info_async ()"><code class="function">gdk_pixbuf_get_file_info_async()</code></a>.</p>
|
449
449
|
<div class="refsect3">
|
@@ -457,22 +457,22 @@ gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="/home/vagr
|
|
457
457
|
<tbody>
|
458
458
|
<tr>
|
459
459
|
<td class="parameter_name"><p>async_result</p></td>
|
460
|
-
<td class="parameter_description"><p>a <a href="
|
460
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a></p></td>
|
461
461
|
<td class="parameter_annotations"> </td>
|
462
462
|
</tr>
|
463
463
|
<tr>
|
464
464
|
<td class="parameter_name"><p>width</p></td>
|
465
|
-
<td class="parameter_description"><p> Return location for the width of the image, or <a href="
|
465
|
+
<td class="parameter_description"><p> Return location for the width of the image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
466
466
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
467
467
|
</tr>
|
468
468
|
<tr>
|
469
469
|
<td class="parameter_name"><p>height</p></td>
|
470
|
-
<td class="parameter_description"><p> Return location for the height of the image, or <a href="
|
470
|
+
<td class="parameter_description"><p> Return location for the height of the image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
471
471
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
472
472
|
</tr>
|
473
473
|
<tr>
|
474
474
|
<td class="parameter_name"><p>error</p></td>
|
475
|
-
<td class="parameter_description"><p>a <a href="
|
475
|
+
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
476
476
|
<td class="parameter_annotations"> </td>
|
477
477
|
</tr>
|
478
478
|
</tbody>
|
@@ -481,7 +481,7 @@ gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="/home/vagr
|
|
481
481
|
<div class="refsect3">
|
482
482
|
<a name="gdk-pixbuf-get-file-info-finish.returns"></a><h4>Returns</h4>
|
483
483
|
<p> A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing the image
|
484
|
-
format of the file or <a href="
|
484
|
+
format of the file or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image format wasn't
|
485
485
|
recognized. The return value is owned by GdkPixbuf and should
|
486
486
|
not be freed. </p>
|
487
487
|
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
@@ -493,9 +493,9 @@ not be freed. </p>
|
|
493
493
|
<a name="gdk-pixbuf-new-from-resource"></a><h3>gdk_pixbuf_new_from_resource ()</h3>
|
494
494
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
495
495
|
gdk_pixbuf_new_from_resource (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>,
|
496
|
-
<em class="parameter"><code><a href="
|
496
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
497
497
|
<p>Creates a new pixbuf by loading an image from an resource.</p>
|
498
|
-
<p>The file format is detected automatically. If <a href="
|
498
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
499
499
|
<em class="parameter"><code>error</code></em>
|
500
500
|
will be set.</p>
|
501
501
|
<div class="refsect3">
|
@@ -522,7 +522,7 @@ gdk_pixbuf_new_from_resource (<em class="parameter"><code>const <span class="typ
|
|
522
522
|
</div>
|
523
523
|
<div class="refsect3">
|
524
524
|
<a name="gdk-pixbuf-new-from-resource.returns"></a><h4>Returns</h4>
|
525
|
-
<p> A newly-created pixbuf, or <a href="
|
525
|
+
<p> A newly-created pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
526
526
|
conditions occurred: the file could not be opened, the image format is
|
527
527
|
not supported, there was not enough memory to allocate the image buffer,
|
528
528
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -536,10 +536,10 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
536
536
|
gdk_pixbuf_new_from_resource_at_scale (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>,
|
537
537
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
538
538
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
539
|
-
<em class="parameter"><code><a href="
|
540
|
-
<em class="parameter"><code><a href="
|
539
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
|
540
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
541
541
|
<p>Creates a new pixbuf by loading an image from an resource.</p>
|
542
|
-
<p>The file format is detected automatically. If <a href="
|
542
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
543
543
|
<em class="parameter"><code>error</code></em>
|
544
544
|
will be set.</p>
|
545
545
|
<p>The image will be scaled to fit in the requested size, optionally
|
@@ -579,7 +579,7 @@ exact given width. When not preserving aspect ratio, a <em class="parameter"><co
|
|
579
579
|
</tr>
|
580
580
|
<tr>
|
581
581
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
582
|
-
<td class="parameter_description"><p><a href="
|
582
|
+
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</p></td>
|
583
583
|
<td class="parameter_annotations"> </td>
|
584
584
|
</tr>
|
585
585
|
<tr>
|
@@ -592,7 +592,7 @@ exact given width. When not preserving aspect ratio, a <em class="parameter"><co
|
|
592
592
|
</div>
|
593
593
|
<div class="refsect3">
|
594
594
|
<a name="gdk-pixbuf-new-from-resource-at-scale.returns"></a><h4>Returns</h4>
|
595
|
-
<p> A newly-created pixbuf, or <a href="
|
595
|
+
<p> A newly-created pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
596
596
|
conditions occurred: the file could not be opened, the image format is
|
597
597
|
not supported, there was not enough memory to allocate the image buffer,
|
598
598
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -603,17 +603,17 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
603
603
|
<div class="refsect2">
|
604
604
|
<a name="gdk-pixbuf-new-from-stream"></a><h3>gdk_pixbuf_new_from_stream ()</h3>
|
605
605
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
606
|
-
gdk_pixbuf_new_from_stream (<em class="parameter"><code><a href="
|
607
|
-
<em class="parameter"><code><a href="
|
608
|
-
<em class="parameter"><code><a href="
|
606
|
+
gdk_pixbuf_new_from_stream (<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
607
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
608
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
609
609
|
<p>Creates a new pixbuf by loading an image from an input stream. </p>
|
610
|
-
<p>The file format is detected automatically. If <a href="
|
610
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
611
611
|
<em class="parameter"><code>error</code></em>
|
612
612
|
will be set. The <em class="parameter"><code>cancellable</code></em>
|
613
613
|
can be used to abort the operation
|
614
614
|
from another thread. If the operation was cancelled, the error
|
615
|
-
<a href="
|
616
|
-
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
615
|
+
<a href="../gio/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. Other possible errors are in
|
616
|
+
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../gio/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains. </p>
|
617
617
|
<p>The stream is not closed.</p>
|
618
618
|
<div class="refsect3">
|
619
619
|
<a name="gdk-pixbuf-new-from-stream.parameters"></a><h4>Parameters</h4>
|
@@ -626,12 +626,12 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
626
626
|
<tbody>
|
627
627
|
<tr>
|
628
628
|
<td class="parameter_name"><p>stream</p></td>
|
629
|
-
<td class="parameter_description"><p>a <a href="
|
629
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> to load the pixbuf from</p></td>
|
630
630
|
<td class="parameter_annotations"> </td>
|
631
631
|
</tr>
|
632
632
|
<tr>
|
633
633
|
<td class="parameter_name"><p>cancellable</p></td>
|
634
|
-
<td class="parameter_description"><p> optional <a href="
|
634
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
635
635
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
636
636
|
</tr>
|
637
637
|
<tr>
|
@@ -644,7 +644,7 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
644
644
|
</div>
|
645
645
|
<div class="refsect3">
|
646
646
|
<a name="gdk-pixbuf-new-from-stream.returns"></a><h4>Returns</h4>
|
647
|
-
<p> A newly-created pixbuf, or <a href="
|
647
|
+
<p> A newly-created pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
648
648
|
conditions occurred: the file could not be opened, the image format is
|
649
649
|
not supported, there was not enough memory to allocate the image buffer,
|
650
650
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -655,10 +655,10 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
655
655
|
<div class="refsect2">
|
656
656
|
<a name="gdk-pixbuf-new-from-stream-async"></a><h3>gdk_pixbuf_new_from_stream_async ()</h3>
|
657
657
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
658
|
-
gdk_pixbuf_new_from_stream_async (<em class="parameter"><code><a href="
|
659
|
-
<em class="parameter"><code><a href="
|
660
|
-
<em class="parameter"><code><a href="
|
661
|
-
<em class="parameter"><code><a href="
|
658
|
+
gdk_pixbuf_new_from_stream_async (<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
659
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
660
|
+
<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
661
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
662
662
|
<p>Creates a new pixbuf by asynchronously loading an image from an input stream.</p>
|
663
663
|
<p>For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()"><code class="function">gdk_pixbuf_new_from_stream()</code></a>, which is the synchronous
|
664
664
|
version of this function.</p>
|
@@ -676,17 +676,17 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
676
676
|
<tbody>
|
677
677
|
<tr>
|
678
678
|
<td class="parameter_name"><p>stream</p></td>
|
679
|
-
<td class="parameter_description"><p>a <a href="
|
679
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> from which to load the pixbuf</p></td>
|
680
680
|
<td class="parameter_annotations"> </td>
|
681
681
|
</tr>
|
682
682
|
<tr>
|
683
683
|
<td class="parameter_name"><p>cancellable</p></td>
|
684
|
-
<td class="parameter_description"><p> optional <a href="
|
684
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
685
685
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
686
686
|
</tr>
|
687
687
|
<tr>
|
688
688
|
<td class="parameter_name"><p>callback</p></td>
|
689
|
-
<td class="parameter_description"><p>a <a href="
|
689
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the pixbuf is loaded</p></td>
|
690
690
|
<td class="parameter_annotations"> </td>
|
691
691
|
</tr>
|
692
692
|
<tr>
|
@@ -703,8 +703,8 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
703
703
|
<div class="refsect2">
|
704
704
|
<a name="gdk-pixbuf-new-from-stream-finish"></a><h3>gdk_pixbuf_new_from_stream_finish ()</h3>
|
705
705
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
706
|
-
gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="
|
707
|
-
<em class="parameter"><code><a href="
|
706
|
+
gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a> *async_result</code></em>,
|
707
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
708
708
|
<p>Finishes an asynchronous pixbuf creation operation started with
|
709
709
|
<a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-async" title="gdk_pixbuf_new_from_stream_async ()"><code class="function">gdk_pixbuf_new_from_stream_async()</code></a>.</p>
|
710
710
|
<div class="refsect3">
|
@@ -718,12 +718,12 @@ gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="/home/va
|
|
718
718
|
<tbody>
|
719
719
|
<tr>
|
720
720
|
<td class="parameter_name"><p>async_result</p></td>
|
721
|
-
<td class="parameter_description"><p>a <a href="
|
721
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncResult-struct"><span class="type">GAsyncResult</span></a></p></td>
|
722
722
|
<td class="parameter_annotations"> </td>
|
723
723
|
</tr>
|
724
724
|
<tr>
|
725
725
|
<td class="parameter_name"><p>error</p></td>
|
726
|
-
<td class="parameter_description"><p>a <a href="
|
726
|
+
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
|
727
727
|
<td class="parameter_annotations"> </td>
|
728
728
|
</tr>
|
729
729
|
</tbody>
|
@@ -731,8 +731,8 @@ gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="/home/va
|
|
731
731
|
</div>
|
732
732
|
<div class="refsect3">
|
733
733
|
<a name="gdk-pixbuf-new-from-stream-finish.returns"></a><h4>Returns</h4>
|
734
|
-
<p> a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> or <a href="
|
735
|
-
object with <a href="
|
734
|
+
<p> a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned
|
735
|
+
object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
|
736
736
|
</div>
|
737
737
|
<p class="since">Since: 2.24</p>
|
738
738
|
</div>
|
@@ -740,20 +740,20 @@ object with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gt
|
|
740
740
|
<div class="refsect2">
|
741
741
|
<a name="gdk-pixbuf-new-from-stream-at-scale"></a><h3>gdk_pixbuf_new_from_stream_at_scale ()</h3>
|
742
742
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
743
|
-
gdk_pixbuf_new_from_stream_at_scale (<em class="parameter"><code><a href="
|
744
|
-
<em class="parameter"><code><a href="
|
745
|
-
<em class="parameter"><code><a href="
|
746
|
-
<em class="parameter"><code><a href="
|
747
|
-
<em class="parameter"><code><a href="
|
748
|
-
<em class="parameter"><code><a href="
|
743
|
+
gdk_pixbuf_new_from_stream_at_scale (<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
744
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
|
745
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
|
746
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
|
747
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
748
|
+
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
749
749
|
<p>Creates a new pixbuf by loading an image from an input stream. </p>
|
750
|
-
<p>The file format is detected automatically. If <a href="
|
750
|
+
<p>The file format is detected automatically. If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
|
751
751
|
<em class="parameter"><code>error</code></em>
|
752
752
|
will be set. The <em class="parameter"><code>cancellable</code></em>
|
753
753
|
can be used to abort the operation
|
754
754
|
from another thread. If the operation was cancelled, the error
|
755
|
-
<a href="
|
756
|
-
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="
|
755
|
+
<a href="../gio/gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned. Other possible errors are in
|
756
|
+
the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="../gio/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains. </p>
|
757
757
|
<p>The image will be scaled to fit in the requested size, optionally
|
758
758
|
preserving the image's aspect ratio.</p>
|
759
759
|
<p>When preserving the aspect ratio, a <em class="parameter"><code>width</code></em>
|
@@ -781,7 +781,7 @@ scale the image at all in that dimension.</p>
|
|
781
781
|
<tbody>
|
782
782
|
<tr>
|
783
783
|
<td class="parameter_name"><p>stream</p></td>
|
784
|
-
<td class="parameter_description"><p>a <a href="
|
784
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> to load the pixbuf from</p></td>
|
785
785
|
<td class="parameter_annotations"> </td>
|
786
786
|
</tr>
|
787
787
|
<tr>
|
@@ -796,12 +796,12 @@ scale the image at all in that dimension.</p>
|
|
796
796
|
</tr>
|
797
797
|
<tr>
|
798
798
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
799
|
-
<td class="parameter_description"><p><a href="
|
799
|
+
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</p></td>
|
800
800
|
<td class="parameter_annotations"> </td>
|
801
801
|
</tr>
|
802
802
|
<tr>
|
803
803
|
<td class="parameter_name"><p>cancellable</p></td>
|
804
|
-
<td class="parameter_description"><p> optional <a href="
|
804
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
805
805
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
806
806
|
</tr>
|
807
807
|
<tr>
|
@@ -814,7 +814,7 @@ scale the image at all in that dimension.</p>
|
|
814
814
|
</div>
|
815
815
|
<div class="refsect3">
|
816
816
|
<a name="gdk-pixbuf-new-from-stream-at-scale.returns"></a><h4>Returns</h4>
|
817
|
-
<p> A newly-created pixbuf, or <a href="
|
817
|
+
<p> A newly-created pixbuf, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
|
818
818
|
conditions occurred: the file could not be opened, the image format is
|
819
819
|
not supported, there was not enough memory to allocate the image buffer,
|
820
820
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -826,13 +826,13 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
826
826
|
<a name="gdk-pixbuf-new-from-stream-at-scale-async"></a><h3>gdk_pixbuf_new_from_stream_at_scale_async ()</h3>
|
827
827
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
828
828
|
gdk_pixbuf_new_from_stream_at_scale_async
|
829
|
-
(<em class="parameter"><code><a href="
|
830
|
-
<em class="parameter"><code><a href="
|
831
|
-
<em class="parameter"><code><a href="
|
832
|
-
<em class="parameter"><code><a href="
|
833
|
-
<em class="parameter"><code><a href="
|
834
|
-
<em class="parameter"><code><a href="
|
835
|
-
<em class="parameter"><code><a href="
|
829
|
+
(<em class="parameter"><code><a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> *stream</code></em>,
|
830
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
|
831
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
|
832
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
|
833
|
+
<em class="parameter"><code><a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>,
|
834
|
+
<em class="parameter"><code><a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
|
835
|
+
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
|
836
836
|
<p>Creates a new pixbuf by asynchronously loading an image from an input stream.</p>
|
837
837
|
<p>For more details see <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()"><code class="function">gdk_pixbuf_new_from_stream_at_scale()</code></a>, which is the synchronous
|
838
838
|
version of this function.</p>
|
@@ -850,7 +850,7 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
850
850
|
<tbody>
|
851
851
|
<tr>
|
852
852
|
<td class="parameter_name"><p>stream</p></td>
|
853
|
-
<td class="parameter_description"><p>a <a href="
|
853
|
+
<td class="parameter_description"><p>a <a href="../gio/GInputStream.html#GInputStream-struct"><span class="type">GInputStream</span></a> from which to load the pixbuf</p></td>
|
854
854
|
<td class="parameter_annotations"> </td>
|
855
855
|
</tr>
|
856
856
|
<tr>
|
@@ -865,17 +865,17 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
865
865
|
</tr>
|
866
866
|
<tr>
|
867
867
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
868
|
-
<td class="parameter_description"><p><a href="
|
868
|
+
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio</p></td>
|
869
869
|
<td class="parameter_annotations"> </td>
|
870
870
|
</tr>
|
871
871
|
<tr>
|
872
872
|
<td class="parameter_name"><p>cancellable</p></td>
|
873
|
-
<td class="parameter_description"><p> optional <a href="
|
873
|
+
<td class="parameter_description"><p> optional <a href="../gio/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
|
874
874
|
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
875
875
|
</tr>
|
876
876
|
<tr>
|
877
877
|
<td class="parameter_name"><p>callback</p></td>
|
878
|
-
<td class="parameter_description"><p>a <a href="
|
878
|
+
<td class="parameter_description"><p>a <a href="../gio/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> to call when the pixbuf is loaded</p></td>
|
879
879
|
<td class="parameter_annotations"> </td>
|
880
880
|
</tr>
|
881
881
|
<tr>
|