gdk_pixbuf2 3.2.5-x86-mingw32 → 3.2.6-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/COPYING.LIB +502 -0
- data/README.md +30 -0
- data/Rakefile +5 -5
- data/gdk_pixbuf2.gemspec +42 -0
- data/lib/gdk_pixbuf2/deprecated.rb +9 -7
- data/lib/gdk_pixbuf2/loader.rb +10 -1
- data/lib/gdk_pixbuf2/pixbuf.rb +14 -12
- data/test/test-pixbuf.rb +2 -2
- 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-features.h +2 -2
- 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 +1 -1
- data/vendor/local/lib/girepository-1.0/GdkPixbuf-2.0.typelib +0 -0
- data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
- data/vendor/local/lib/libgdk_pixbuf-2.0.la +3 -3
- data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +1 -1
- data/vendor/local/share/gir-1.0/GdkPixbuf-2.0.gir +24 -20
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +64 -64
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/annotation-glossary.html +4 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +75 -74
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +108 -105
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +133 -133
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +34 -34
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +43 -43
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +55 -55
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +14 -14
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Scaling.html +36 -36
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +82 -82
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Utilities.html +15 -15
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Versioning.html +4 -4
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html +6 -6
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html +3 -3
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-XlibRGB.html +8 -8
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-csource.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html +3 -3
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-from-drawables.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-rendering.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-query-loaders.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.html +3 -3
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/license.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn01.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn02.html +2 -2
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fur/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/kk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/man/man1/gdk-pixbuf-csource.1 +1 -135
- data/vendor/local/share/man/man1/gdk-pixbuf-query-loaders.1 +1 -73
- metadata +7 -18
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="rn01.html" title="API Reference">
|
9
9
|
<link rel="prev" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html" title="Reference Counting and Memory Mangement">
|
10
10
|
<link rel="next" href="gdk-pixbuf-File-saving.html" title="File saving">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -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><
|
172
|
+
<em class="parameter"><code><span class="type">GError</span> **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 <
|
174
|
+
detected automatically. If <code class="literal">NULL</code> 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 <
|
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 <span class="type">G_FILE_ERROR</span> 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">
|
@@ -185,8 +185,9 @@ Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Struct
|
|
185
185
|
<tbody>
|
186
186
|
<tr>
|
187
187
|
<td class="parameter_name"><p>filename</p></td>
|
188
|
-
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
189
|
-
|
188
|
+
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
189
|
+
name encoding. </p></td>
|
190
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
190
191
|
</tr>
|
191
192
|
<tr>
|
192
193
|
<td class="parameter_name"><p>error</p></td>
|
@@ -198,7 +199,7 @@ Possible errors are in the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Struct
|
|
198
199
|
</div>
|
199
200
|
<div class="refsect3">
|
200
201
|
<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 <
|
202
|
+
<p> A newly-created pixbuf with a reference count of 1, or <code class="literal">NULL</code> if
|
202
203
|
any of several error conditions occurred: the file could not be opened,
|
203
204
|
there was no loader for the file's format, there was not enough memory to
|
204
205
|
allocate the image buffer, or the image file contained invalid data.</p>
|
@@ -211,12 +212,12 @@ allocate the image buffer, or the image file contained invalid data.</p>
|
|
211
212
|
gdk_pixbuf_new_from_file_at_size (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
212
213
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
213
214
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
214
|
-
<em class="parameter"><code><
|
215
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
215
216
|
<p>Creates a new pixbuf by loading an image from a file.
|
216
|
-
The file format is detected automatically. If <
|
217
|
+
The file format is detected automatically. If <code class="literal">NULL</code> is returned, then
|
217
218
|
<em class="parameter"><code>error</code></em>
|
218
219
|
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
|
-
<
|
220
|
+
<span class="type">G_FILE_ERROR</span> domains.</p>
|
220
221
|
<p>The image will be scaled to fit in the requested size, preserving
|
221
222
|
the image's aspect ratio. Note that the returned pixbuf may be smaller
|
222
223
|
than <em class="parameter"><code>width</code></em>
|
@@ -235,8 +236,9 @@ and image at the requested size, regardless of aspect ratio, use
|
|
235
236
|
<tbody>
|
236
237
|
<tr>
|
237
238
|
<td class="parameter_name"><p>filename</p></td>
|
238
|
-
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
239
|
-
|
239
|
+
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
240
|
+
name encoding. </p></td>
|
241
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
240
242
|
</tr>
|
241
243
|
<tr>
|
242
244
|
<td class="parameter_name"><p>width</p></td>
|
@@ -259,7 +261,7 @@ and image at the requested size, regardless of aspect ratio, use
|
|
259
261
|
<div class="refsect3">
|
260
262
|
<a name="gdk-pixbuf-new-from-file-at-size.returns"></a><h4>Returns</h4>
|
261
263
|
<p> A newly-created pixbuf with a reference count of 1, or
|
262
|
-
<
|
264
|
+
<code class="literal">NULL</code> if any of several error conditions occurred: the file could not
|
263
265
|
be opened, there was no loader for the file's format, there was not
|
264
266
|
enough memory to allocate the image buffer, or the image file contained
|
265
267
|
invalid data.</p>
|
@@ -273,12 +275,12 @@ invalid data.</p>
|
|
273
275
|
gdk_pixbuf_new_from_file_at_scale (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
|
274
276
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
275
277
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
276
|
-
<em class="parameter"><code><
|
277
|
-
<em class="parameter"><code><
|
278
|
+
<em class="parameter"><code><span class="type">gboolean</span> preserve_aspect_ratio</code></em>,
|
279
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
278
280
|
<p>Creates a new pixbuf by loading an image from a file. The file format is
|
279
|
-
detected automatically. If <
|
281
|
+
detected automatically. If <code class="literal">NULL</code> is returned, then <em class="parameter"><code>error</code></em>
|
280
282
|
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 <
|
283
|
+
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 <span class="type">G_FILE_ERROR</span> domains.
|
282
284
|
The image will be scaled to fit in the requested size, optionally preserving
|
283
285
|
the image's aspect ratio. </p>
|
284
286
|
<p>When preserving the aspect ratio, a <em class="parameter"><code>width</code></em>
|
@@ -304,8 +306,9 @@ allowed since 2.8.</p>
|
|
304
306
|
<tbody>
|
305
307
|
<tr>
|
306
308
|
<td class="parameter_name"><p>filename</p></td>
|
307
|
-
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
308
|
-
|
309
|
+
<td class="parameter_description"><p>Name of file to load, in the GLib file
|
310
|
+
name encoding. </p></td>
|
311
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
309
312
|
</tr>
|
310
313
|
<tr>
|
311
314
|
<td class="parameter_name"><p>width</p></td>
|
@@ -319,7 +322,7 @@ allowed since 2.8.</p>
|
|
319
322
|
</tr>
|
320
323
|
<tr>
|
321
324
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
322
|
-
<td class="parameter_description"><p><
|
325
|
+
<td class="parameter_description"><p><code class="literal">TRUE</code> to preserve the image's aspect ratio</p></td>
|
323
326
|
<td class="parameter_annotations"> </td>
|
324
327
|
</tr>
|
325
328
|
<tr>
|
@@ -332,7 +335,7 @@ allowed since 2.8.</p>
|
|
332
335
|
</div>
|
333
336
|
<div class="refsect3">
|
334
337
|
<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 <
|
338
|
+
<p> A newly-created pixbuf with a reference count of 1, or <code class="literal">NULL</code>
|
336
339
|
if any of several error conditions occurred: the file could not be opened,
|
337
340
|
there was no loader for the file's format, there was not enough memory to
|
338
341
|
allocate the image buffer, or the image file contained invalid data.</p>
|
@@ -343,9 +346,9 @@ allocate the image buffer, or the image file contained invalid data.</p>
|
|
343
346
|
<div class="refsect2">
|
344
347
|
<a name="gdk-pixbuf-get-file-info"></a><h3>gdk_pixbuf_get_file_info ()</h3>
|
345
348
|
<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 <
|
347
|
-
<em class="parameter"><code><
|
348
|
-
<em class="parameter"><code><
|
349
|
+
gdk_pixbuf_get_file_info (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
350
|
+
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
351
|
+
<em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
|
349
352
|
<p>Parses an image file far enough to determine its format and size.</p>
|
350
353
|
<div class="refsect3">
|
351
354
|
<a name="gdk-pixbuf-get-file-info.parameters"></a><h4>Parameters</h4>
|
@@ -358,19 +361,19 @@ gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="../glib/gli
|
|
358
361
|
<tbody>
|
359
362
|
<tr>
|
360
363
|
<td class="parameter_name"><p>filename</p></td>
|
361
|
-
<td class="parameter_description"><p>The name of the file to identify
|
362
|
-
<td class="parameter_annotations">
|
364
|
+
<td class="parameter_description"><p>The name of the file to identify. </p></td>
|
365
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
363
366
|
</tr>
|
364
367
|
<tr>
|
365
368
|
<td class="parameter_name"><p>width</p></td>
|
366
|
-
<td class="parameter_description"><p>
|
367
|
-
image, or <
|
369
|
+
<td class="parameter_description"><p>Return location for the width of the
|
370
|
+
image, or <code class="literal">NULL</code>. </p></td>
|
368
371
|
<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
372
|
</tr>
|
370
373
|
<tr>
|
371
374
|
<td class="parameter_name"><p>height</p></td>
|
372
|
-
<td class="parameter_description"><p>
|
373
|
-
image, or <
|
375
|
+
<td class="parameter_description"><p>Return location for the height of the
|
376
|
+
image, or <code class="literal">NULL</code>. </p></td>
|
374
377
|
<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
378
|
</tr>
|
376
379
|
</tbody>
|
@@ -378,8 +381,8 @@ image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="lit
|
|
378
381
|
</div>
|
379
382
|
<div class="refsect3">
|
380
383
|
<a name="gdk-pixbuf-get-file-info.returns"></a><h4>Returns</h4>
|
381
|
-
<p>
|
382
|
-
the image format of the file or <
|
384
|
+
<p>A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing
|
385
|
+
the image format of the file or <code class="literal">NULL</code> if the image format wasn't
|
383
386
|
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
387
|
not be freed. </p>
|
385
388
|
<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 +393,10 @@ not be freed. </p>
|
|
390
393
|
<div class="refsect2">
|
391
394
|
<a name="gdk-pixbuf-get-file-info-async"></a><h3>gdk_pixbuf_get_file_info_async ()</h3>
|
392
395
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
393
|
-
gdk_pixbuf_get_file_info_async (<em class="parameter"><code>const <
|
394
|
-
<em class="parameter"><code><
|
395
|
-
<em class="parameter"><code><
|
396
|
-
<em class="parameter"><code><
|
396
|
+
gdk_pixbuf_get_file_info_async (<em class="parameter"><code>const <span class="type">gchar</span> *filename</code></em>,
|
397
|
+
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
|
398
|
+
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
|
399
|
+
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
397
400
|
<p>Asynchronously parses an image file far enough to determine its
|
398
401
|
format and size.</p>
|
399
402
|
<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
|
@@ -413,17 +416,17 @@ get the result of the operation.</p>
|
|
413
416
|
<tbody>
|
414
417
|
<tr>
|
415
418
|
<td class="parameter_name"><p>filename</p></td>
|
416
|
-
<td class="parameter_description"><p>The name of the file to identify</p></td>
|
417
|
-
<td class="parameter_annotations">
|
419
|
+
<td class="parameter_description"><p>The name of the file to identify. </p></td>
|
420
|
+
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
418
421
|
</tr>
|
419
422
|
<tr>
|
420
423
|
<td class="parameter_name"><p>cancellable</p></td>
|
421
|
-
<td class="parameter_description"><p>
|
424
|
+
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, <code class="literal">NULL</code> to ignore. </p></td>
|
422
425
|
<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
426
|
</tr>
|
424
427
|
<tr>
|
425
428
|
<td class="parameter_name"><p>callback</p></td>
|
426
|
-
<td class="parameter_description"><p>a <
|
429
|
+
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the file info is available</p></td>
|
427
430
|
<td class="parameter_annotations"> </td>
|
428
431
|
</tr>
|
429
432
|
<tr>
|
@@ -440,10 +443,10 @@ get the result of the operation.</p>
|
|
440
443
|
<div class="refsect2">
|
441
444
|
<a name="gdk-pixbuf-get-file-info-finish"></a><h3>gdk_pixbuf_get_file_info_finish ()</h3>
|
442
445
|
<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><
|
444
|
-
<em class="parameter"><code><
|
445
|
-
<em class="parameter"><code><
|
446
|
-
<em class="parameter"><code><
|
446
|
+
gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *async_result</code></em>,
|
447
|
+
<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
|
448
|
+
<em class="parameter"><code><span class="type">gint</span> *height</code></em>,
|
449
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
447
450
|
<p>Finishes an asynchronous pixbuf parsing operation started with
|
448
451
|
<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
452
|
<div class="refsect3">
|
@@ -457,22 +460,22 @@ gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="../gio/GAs
|
|
457
460
|
<tbody>
|
458
461
|
<tr>
|
459
462
|
<td class="parameter_name"><p>async_result</p></td>
|
460
|
-
<td class="parameter_description"><p>a <
|
463
|
+
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
|
461
464
|
<td class="parameter_annotations"> </td>
|
462
465
|
</tr>
|
463
466
|
<tr>
|
464
467
|
<td class="parameter_name"><p>width</p></td>
|
465
|
-
<td class="parameter_description"><p>
|
468
|
+
<td class="parameter_description"><p>Return location for the width of the image, or <code class="literal">NULL</code>. </p></td>
|
466
469
|
<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
470
|
</tr>
|
468
471
|
<tr>
|
469
472
|
<td class="parameter_name"><p>height</p></td>
|
470
|
-
<td class="parameter_description"><p>
|
473
|
+
<td class="parameter_description"><p>Return location for the height of the image, or <code class="literal">NULL</code>. </p></td>
|
471
474
|
<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
475
|
</tr>
|
473
476
|
<tr>
|
474
477
|
<td class="parameter_name"><p>error</p></td>
|
475
|
-
<td class="parameter_description"><p>a <
|
478
|
+
<td class="parameter_description"><p>a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td>
|
476
479
|
<td class="parameter_annotations"> </td>
|
477
480
|
</tr>
|
478
481
|
</tbody>
|
@@ -480,8 +483,8 @@ gdk_pixbuf_get_file_info_finish (<em class="parameter"><code><a href="../gio/GAs
|
|
480
483
|
</div>
|
481
484
|
<div class="refsect3">
|
482
485
|
<a name="gdk-pixbuf-get-file-info-finish.returns"></a><h4>Returns</h4>
|
483
|
-
<p>
|
484
|
-
format of the file or <
|
486
|
+
<p>A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing the image
|
487
|
+
format of the file or <code class="literal">NULL</code> if the image format wasn't
|
485
488
|
recognized. The return value is owned by GdkPixbuf and should
|
486
489
|
not be freed. </p>
|
487
490
|
<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 +496,9 @@ not be freed. </p>
|
|
493
496
|
<a name="gdk-pixbuf-new-from-resource"></a><h3>gdk_pixbuf_new_from_resource ()</h3>
|
494
497
|
<pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
|
495
498
|
gdk_pixbuf_new_from_resource (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>,
|
496
|
-
<em class="parameter"><code><
|
499
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
497
500
|
<p>Creates a new pixbuf by loading an image from an resource.</p>
|
498
|
-
<p>The file format is detected automatically. If <
|
501
|
+
<p>The file format is detected automatically. If <code class="literal">NULL</code> is returned, then
|
499
502
|
<em class="parameter"><code>error</code></em>
|
500
503
|
will be set.</p>
|
501
504
|
<div class="refsect3">
|
@@ -522,7 +525,7 @@ gdk_pixbuf_new_from_resource (<em class="parameter"><code>const <span class="typ
|
|
522
525
|
</div>
|
523
526
|
<div class="refsect3">
|
524
527
|
<a name="gdk-pixbuf-new-from-resource.returns"></a><h4>Returns</h4>
|
525
|
-
<p> A newly-created pixbuf, or <
|
528
|
+
<p> A newly-created pixbuf, or <code class="literal">NULL</code> if any of several error
|
526
529
|
conditions occurred: the file could not be opened, the image format is
|
527
530
|
not supported, there was not enough memory to allocate the image buffer,
|
528
531
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -536,10 +539,10 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
536
539
|
gdk_pixbuf_new_from_resource_at_scale (<em class="parameter"><code>const <span class="type">char</span> *resource_path</code></em>,
|
537
540
|
<em class="parameter"><code><span class="type">int</span> width</code></em>,
|
538
541
|
<em class="parameter"><code><span class="type">int</span> height</code></em>,
|
539
|
-
<em class="parameter"><code><
|
540
|
-
<em class="parameter"><code><
|
542
|
+
<em class="parameter"><code><span class="type">gboolean</span> preserve_aspect_ratio</code></em>,
|
543
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
541
544
|
<p>Creates a new pixbuf by loading an image from an resource.</p>
|
542
|
-
<p>The file format is detected automatically. If <
|
545
|
+
<p>The file format is detected automatically. If <code class="literal">NULL</code> is returned, then
|
543
546
|
<em class="parameter"><code>error</code></em>
|
544
547
|
will be set.</p>
|
545
548
|
<p>The image will be scaled to fit in the requested size, optionally
|
@@ -579,7 +582,7 @@ exact given width. When not preserving aspect ratio, a <em class="parameter"><co
|
|
579
582
|
</tr>
|
580
583
|
<tr>
|
581
584
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
582
|
-
<td class="parameter_description"><p><
|
585
|
+
<td class="parameter_description"><p><code class="literal">TRUE</code> to preserve the image's aspect ratio</p></td>
|
583
586
|
<td class="parameter_annotations"> </td>
|
584
587
|
</tr>
|
585
588
|
<tr>
|
@@ -592,7 +595,7 @@ exact given width. When not preserving aspect ratio, a <em class="parameter"><co
|
|
592
595
|
</div>
|
593
596
|
<div class="refsect3">
|
594
597
|
<a name="gdk-pixbuf-new-from-resource-at-scale.returns"></a><h4>Returns</h4>
|
595
|
-
<p> A newly-created pixbuf, or <
|
598
|
+
<p> A newly-created pixbuf, or <code class="literal">NULL</code> if any of several error
|
596
599
|
conditions occurred: the file could not be opened, the image format is
|
597
600
|
not supported, there was not enough memory to allocate the image buffer,
|
598
601
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -603,17 +606,17 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
603
606
|
<div class="refsect2">
|
604
607
|
<a name="gdk-pixbuf-new-from-stream"></a><h3>gdk_pixbuf_new_from_stream ()</h3>
|
605
608
|
<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><
|
607
|
-
<em class="parameter"><code><
|
608
|
-
<em class="parameter"><code><
|
609
|
+
gdk_pixbuf_new_from_stream (<em class="parameter"><code><span class="type">GInputStream</span> *stream</code></em>,
|
610
|
+
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
|
611
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
609
612
|
<p>Creates a new pixbuf by loading an image from an input stream. </p>
|
610
|
-
<p>The file format is detected automatically. If <
|
613
|
+
<p>The file format is detected automatically. If <code class="literal">NULL</code> is returned, then
|
611
614
|
<em class="parameter"><code>error</code></em>
|
612
615
|
will be set. The <em class="parameter"><code>cancellable</code></em>
|
613
616
|
can be used to abort the operation
|
614
617
|
from another thread. If the operation was cancelled, the error
|
615
|
-
<
|
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 <
|
618
|
+
<code class="literal">G_IO_ERROR_CANCELLED</code> will be returned. Other possible errors are in
|
619
|
+
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 <code class="literal">G_IO_ERROR</code> domains. </p>
|
617
620
|
<p>The stream is not closed.</p>
|
618
621
|
<div class="refsect3">
|
619
622
|
<a name="gdk-pixbuf-new-from-stream.parameters"></a><h4>Parameters</h4>
|
@@ -626,12 +629,12 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
626
629
|
<tbody>
|
627
630
|
<tr>
|
628
631
|
<td class="parameter_name"><p>stream</p></td>
|
629
|
-
<td class="parameter_description"><p>a <
|
632
|
+
<td class="parameter_description"><p>a <span class="type">GInputStream</span> to load the pixbuf from</p></td>
|
630
633
|
<td class="parameter_annotations"> </td>
|
631
634
|
</tr>
|
632
635
|
<tr>
|
633
636
|
<td class="parameter_name"><p>cancellable</p></td>
|
634
|
-
<td class="parameter_description"><p>
|
637
|
+
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, <code class="literal">NULL</code> to ignore. </p></td>
|
635
638
|
<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
639
|
</tr>
|
637
640
|
<tr>
|
@@ -644,7 +647,7 @@ the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GDK-PIXBUF-ERR
|
|
644
647
|
</div>
|
645
648
|
<div class="refsect3">
|
646
649
|
<a name="gdk-pixbuf-new-from-stream.returns"></a><h4>Returns</h4>
|
647
|
-
<p> A newly-created pixbuf, or <
|
650
|
+
<p> A newly-created pixbuf, or <code class="literal">NULL</code> if any of several error
|
648
651
|
conditions occurred: the file could not be opened, the image format is
|
649
652
|
not supported, there was not enough memory to allocate the image buffer,
|
650
653
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -655,10 +658,10 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
655
658
|
<div class="refsect2">
|
656
659
|
<a name="gdk-pixbuf-new-from-stream-async"></a><h3>gdk_pixbuf_new_from_stream_async ()</h3>
|
657
660
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
658
|
-
gdk_pixbuf_new_from_stream_async (<em class="parameter"><code><
|
659
|
-
<em class="parameter"><code><
|
660
|
-
<em class="parameter"><code><
|
661
|
-
<em class="parameter"><code><
|
661
|
+
gdk_pixbuf_new_from_stream_async (<em class="parameter"><code><span class="type">GInputStream</span> *stream</code></em>,
|
662
|
+
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
|
663
|
+
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
|
664
|
+
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
662
665
|
<p>Creates a new pixbuf by asynchronously loading an image from an input stream.</p>
|
663
666
|
<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
667
|
version of this function.</p>
|
@@ -676,17 +679,17 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
676
679
|
<tbody>
|
677
680
|
<tr>
|
678
681
|
<td class="parameter_name"><p>stream</p></td>
|
679
|
-
<td class="parameter_description"><p>a <
|
682
|
+
<td class="parameter_description"><p>a <span class="type">GInputStream</span> from which to load the pixbuf</p></td>
|
680
683
|
<td class="parameter_annotations"> </td>
|
681
684
|
</tr>
|
682
685
|
<tr>
|
683
686
|
<td class="parameter_name"><p>cancellable</p></td>
|
684
|
-
<td class="parameter_description"><p>
|
687
|
+
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, <code class="literal">NULL</code> to ignore. </p></td>
|
685
688
|
<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
689
|
</tr>
|
687
690
|
<tr>
|
688
691
|
<td class="parameter_name"><p>callback</p></td>
|
689
|
-
<td class="parameter_description"><p>a <
|
692
|
+
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the pixbuf is loaded</p></td>
|
690
693
|
<td class="parameter_annotations"> </td>
|
691
694
|
</tr>
|
692
695
|
<tr>
|
@@ -703,8 +706,8 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
703
706
|
<div class="refsect2">
|
704
707
|
<a name="gdk-pixbuf-new-from-stream-finish"></a><h3>gdk_pixbuf_new_from_stream_finish ()</h3>
|
705
708
|
<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><
|
707
|
-
<em class="parameter"><code><
|
709
|
+
gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><span class="type">GAsyncResult</span> *async_result</code></em>,
|
710
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
708
711
|
<p>Finishes an asynchronous pixbuf creation operation started with
|
709
712
|
<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
713
|
<div class="refsect3">
|
@@ -718,12 +721,12 @@ gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="../gio/G
|
|
718
721
|
<tbody>
|
719
722
|
<tr>
|
720
723
|
<td class="parameter_name"><p>async_result</p></td>
|
721
|
-
<td class="parameter_description"><p>a <
|
724
|
+
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
|
722
725
|
<td class="parameter_annotations"> </td>
|
723
726
|
</tr>
|
724
727
|
<tr>
|
725
728
|
<td class="parameter_name"><p>error</p></td>
|
726
|
-
<td class="parameter_description"><p>a <
|
729
|
+
<td class="parameter_description"><p>a <span class="type">GError</span>, or <code class="literal">NULL</code></p></td>
|
727
730
|
<td class="parameter_annotations"> </td>
|
728
731
|
</tr>
|
729
732
|
</tbody>
|
@@ -731,8 +734,8 @@ gdk_pixbuf_new_from_stream_finish (<em class="parameter"><code><a href="../gio/G
|
|
731
734
|
</div>
|
732
735
|
<div class="refsect3">
|
733
736
|
<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 <
|
735
|
-
object with <
|
737
|
+
<p> a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> or <code class="literal">NULL</code> on error. Free the returned
|
738
|
+
object with <code class="function">g_object_unref()</code>.</p>
|
736
739
|
</div>
|
737
740
|
<p class="since">Since: 2.24</p>
|
738
741
|
</div>
|
@@ -740,20 +743,20 @@ object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref
|
|
740
743
|
<div class="refsect2">
|
741
744
|
<a name="gdk-pixbuf-new-from-stream-at-scale"></a><h3>gdk_pixbuf_new_from_stream_at_scale ()</h3>
|
742
745
|
<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><
|
744
|
-
<em class="parameter"><code><
|
745
|
-
<em class="parameter"><code><
|
746
|
-
<em class="parameter"><code><
|
747
|
-
<em class="parameter"><code><
|
748
|
-
<em class="parameter"><code><
|
746
|
+
gdk_pixbuf_new_from_stream_at_scale (<em class="parameter"><code><span class="type">GInputStream</span> *stream</code></em>,
|
747
|
+
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
748
|
+
<em class="parameter"><code><span class="type">gint</span> height</code></em>,
|
749
|
+
<em class="parameter"><code><span class="type">gboolean</span> preserve_aspect_ratio</code></em>,
|
750
|
+
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
|
751
|
+
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
749
752
|
<p>Creates a new pixbuf by loading an image from an input stream. </p>
|
750
|
-
<p>The file format is detected automatically. If <
|
753
|
+
<p>The file format is detected automatically. If <code class="literal">NULL</code> is returned, then
|
751
754
|
<em class="parameter"><code>error</code></em>
|
752
755
|
will be set. The <em class="parameter"><code>cancellable</code></em>
|
753
756
|
can be used to abort the operation
|
754
757
|
from another thread. If the operation was cancelled, the error
|
755
|
-
<
|
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 <
|
758
|
+
<code class="literal">G_IO_ERROR_CANCELLED</code> will be returned. Other possible errors are in
|
759
|
+
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 <code class="literal">G_IO_ERROR</code> domains. </p>
|
757
760
|
<p>The image will be scaled to fit in the requested size, optionally
|
758
761
|
preserving the image's aspect ratio.</p>
|
759
762
|
<p>When preserving the aspect ratio, a <em class="parameter"><code>width</code></em>
|
@@ -781,7 +784,7 @@ scale the image at all in that dimension.</p>
|
|
781
784
|
<tbody>
|
782
785
|
<tr>
|
783
786
|
<td class="parameter_name"><p>stream</p></td>
|
784
|
-
<td class="parameter_description"><p>a <
|
787
|
+
<td class="parameter_description"><p>a <span class="type">GInputStream</span> to load the pixbuf from</p></td>
|
785
788
|
<td class="parameter_annotations"> </td>
|
786
789
|
</tr>
|
787
790
|
<tr>
|
@@ -796,12 +799,12 @@ scale the image at all in that dimension.</p>
|
|
796
799
|
</tr>
|
797
800
|
<tr>
|
798
801
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
799
|
-
<td class="parameter_description"><p><
|
802
|
+
<td class="parameter_description"><p><code class="literal">TRUE</code> to preserve the image's aspect ratio</p></td>
|
800
803
|
<td class="parameter_annotations"> </td>
|
801
804
|
</tr>
|
802
805
|
<tr>
|
803
806
|
<td class="parameter_name"><p>cancellable</p></td>
|
804
|
-
<td class="parameter_description"><p>
|
807
|
+
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, <code class="literal">NULL</code> to ignore. </p></td>
|
805
808
|
<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
809
|
</tr>
|
807
810
|
<tr>
|
@@ -814,7 +817,7 @@ scale the image at all in that dimension.</p>
|
|
814
817
|
</div>
|
815
818
|
<div class="refsect3">
|
816
819
|
<a name="gdk-pixbuf-new-from-stream-at-scale.returns"></a><h4>Returns</h4>
|
817
|
-
<p> A newly-created pixbuf, or <
|
820
|
+
<p> A newly-created pixbuf, or <code class="literal">NULL</code> if any of several error
|
818
821
|
conditions occurred: the file could not be opened, the image format is
|
819
822
|
not supported, there was not enough memory to allocate the image buffer,
|
820
823
|
the stream contained invalid data, or the operation was cancelled.</p>
|
@@ -826,13 +829,13 @@ the stream contained invalid data, or the operation was cancelled.</p>
|
|
826
829
|
<a name="gdk-pixbuf-new-from-stream-at-scale-async"></a><h3>gdk_pixbuf_new_from_stream_at_scale_async ()</h3>
|
827
830
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
828
831
|
gdk_pixbuf_new_from_stream_at_scale_async
|
829
|
-
(<em class="parameter"><code><
|
830
|
-
<em class="parameter"><code><
|
831
|
-
<em class="parameter"><code><
|
832
|
-
<em class="parameter"><code><
|
833
|
-
<em class="parameter"><code><
|
834
|
-
<em class="parameter"><code><
|
835
|
-
<em class="parameter"><code><
|
832
|
+
(<em class="parameter"><code><span class="type">GInputStream</span> *stream</code></em>,
|
833
|
+
<em class="parameter"><code><span class="type">gint</span> width</code></em>,
|
834
|
+
<em class="parameter"><code><span class="type">gint</span> height</code></em>,
|
835
|
+
<em class="parameter"><code><span class="type">gboolean</span> preserve_aspect_ratio</code></em>,
|
836
|
+
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
|
837
|
+
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
|
838
|
+
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
836
839
|
<p>Creates a new pixbuf by asynchronously loading an image from an input stream.</p>
|
837
840
|
<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
841
|
version of this function.</p>
|
@@ -850,7 +853,7 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
850
853
|
<tbody>
|
851
854
|
<tr>
|
852
855
|
<td class="parameter_name"><p>stream</p></td>
|
853
|
-
<td class="parameter_description"><p>a <
|
856
|
+
<td class="parameter_description"><p>a <span class="type">GInputStream</span> from which to load the pixbuf</p></td>
|
854
857
|
<td class="parameter_annotations"> </td>
|
855
858
|
</tr>
|
856
859
|
<tr>
|
@@ -865,17 +868,17 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
865
868
|
</tr>
|
866
869
|
<tr>
|
867
870
|
<td class="parameter_name"><p>preserve_aspect_ratio</p></td>
|
868
|
-
<td class="parameter_description"><p><
|
871
|
+
<td class="parameter_description"><p><code class="literal">TRUE</code> to preserve the image's aspect ratio</p></td>
|
869
872
|
<td class="parameter_annotations"> </td>
|
870
873
|
</tr>
|
871
874
|
<tr>
|
872
875
|
<td class="parameter_name"><p>cancellable</p></td>
|
873
|
-
<td class="parameter_description"><p>
|
876
|
+
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, <code class="literal">NULL</code> to ignore. </p></td>
|
874
877
|
<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
878
|
</tr>
|
876
879
|
<tr>
|
877
880
|
<td class="parameter_name"><p>callback</p></td>
|
878
|
-
<td class="parameter_description"><p>a <
|
881
|
+
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the pixbuf is loaded</p></td>
|
879
882
|
<td class="parameter_annotations"> </td>
|
880
883
|
</tr>
|
881
884
|
<tr>
|
@@ -898,6 +901,6 @@ You can then call <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-
|
|
898
901
|
</div>
|
899
902
|
</div>
|
900
903
|
<div class="footer">
|
901
|
-
<hr>Generated by GTK-Doc V1.
|
904
|
+
<hr>Generated by GTK-Doc V1.27</div>
|
902
905
|
</body>
|
903
906
|
</html>
|