gdk_pixbuf2 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- 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.win32/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.win32/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.win32/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.win32/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>
|