gdk_pixbuf2 3.2.5-x86-mingw32 → 3.2.6-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +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>
|