gdk_pixbuf2 1.0.3-x86-mingw32 → 1.1.0-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (178) hide show
  1. data/ext/gdk_pixbuf2/rbgdk-pixbuf-format.c +49 -40
  2. data/ext/gdk_pixbuf2/rbgdk-pixbuf-loader.c +50 -40
  3. data/ext/gdk_pixbuf2/rbgdk-pixbuf.c +250 -168
  4. data/ext/gdk_pixbuf2/rbgdk-pixbuf.h +25 -18
  5. data/ext/gdk_pixbuf2/rbgdk-pixbuf2conversions.h +42 -0
  6. data/ext/gdk_pixbuf2/rbgdk-pixbuf2private.h +35 -0
  7. data/ext/gdk_pixbuf2/rbgdk-pixbufanimation.c +46 -83
  8. data/ext/gdk_pixbuf2/rbgdk-pixbufanimationiter.c +71 -0
  9. data/ext/gdk_pixbuf2/rbgdk-pixbufsimpleanim.c +29 -17
  10. data/ext/gdk_pixbuf2/rbgdk-pixdata.c +81 -77
  11. data/lib/1.8/gdk_pixbuf2.so +0 -0
  12. data/lib/1.9/gdk_pixbuf2.so +0 -0
  13. data/vendor/local/bin/gdk-pixbuf-csource.exe +0 -0
  14. data/vendor/local/bin/gdk-pixbuf-query-loaders.exe +0 -0
  15. data/vendor/local/bin/libgdk_pixbuf-2.0-0.dll +0 -0
  16. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-animation.h +40 -0
  17. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-core.h +200 -5
  18. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-features.h +82 -3
  19. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-io.h +170 -0
  20. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-loader.h +6 -1
  21. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-simple-anim.h +5 -0
  22. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-transform.h +42 -1
  23. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache +2 -2
  24. data/vendor/local/lib/gdk_pixbuf-2.0.lib +0 -0
  25. data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
  26. data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +4 -2
  27. data/vendor/local/manifest/{gdk-pixbuf-dev_2.22.1-1_win32.mft → gdk-pixbuf-dev_2.24.0-1_win32.mft} +12 -13
  28. data/vendor/local/manifest/{gdk-pixbuf_2.22.1-1_win32.mft → gdk-pixbuf_2.24.0-1_win32.mft} +2 -1
  29. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +181 -150
  30. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/annotation-glossary.html +30 -9
  31. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-10.html +3 -3
  32. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-12.html +4 -4
  33. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-14.html +6 -6
  34. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-2.html +35 -3
  35. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-4.html +13 -9
  36. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-6.html +6 -6
  37. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-8.html +5 -5
  38. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-deprecated.html +7 -7
  39. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-full.html +251 -629
  40. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +644 -0
  41. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +372 -0
  42. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +642 -0
  43. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +417 -0
  44. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +495 -0
  45. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +485 -184
  46. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +168 -0
  47. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/{gdk-pixbuf-scaling.html → gdk-pixbuf-Scaling.html} +296 -190
  48. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +617 -0
  49. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/{gdk-pixbuf-util.html → gdk-pixbuf-Utilities.html} +83 -93
  50. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Versioning.html +63 -26
  51. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-csource.html +16 -16
  52. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-from-drawables.html +8 -8
  53. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-rendering.html +8 -8
  54. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-query-loaders.html +12 -12
  55. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf.devhelp2 +149 -128
  56. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.html +18 -18
  57. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.sgml +184 -154
  58. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/license.html +3 -3
  59. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn01.html +18 -18
  60. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn02.html +5 -5
  61. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/style.css +2 -1
  62. data/vendor/local/share/locale/af/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  63. data/vendor/local/share/locale/ang/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  64. data/vendor/local/share/locale/ar/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  65. data/vendor/local/share/locale/as/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  66. data/vendor/local/share/locale/ast/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  67. data/vendor/local/share/locale/az/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  68. data/vendor/local/share/locale/be/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  69. data/vendor/local/share/locale/be@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  70. data/vendor/local/share/locale/bg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  71. data/vendor/local/share/locale/bn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  72. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  73. data/vendor/local/share/locale/br/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  74. data/vendor/local/share/locale/bs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  75. data/vendor/local/share/locale/ca/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  76. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  77. data/vendor/local/share/locale/crh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  78. data/vendor/local/share/locale/cs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  79. data/vendor/local/share/locale/cy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  80. data/vendor/local/share/locale/da/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  81. data/vendor/local/share/locale/de/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  82. data/vendor/local/share/locale/dz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  83. data/vendor/local/share/locale/el/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  84. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  85. data/vendor/local/share/locale/en_CA/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  86. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  87. data/vendor/local/share/locale/eo/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  88. data/vendor/local/share/locale/es/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  89. data/vendor/local/share/locale/et/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  90. data/vendor/local/share/locale/eu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  91. data/vendor/local/share/locale/fa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  92. data/vendor/local/share/locale/fi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  93. data/vendor/local/share/locale/fr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  94. data/vendor/local/share/locale/ga/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  95. data/vendor/local/share/locale/gl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  96. data/vendor/local/share/locale/gu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  97. data/vendor/local/share/locale/he/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  98. data/vendor/local/share/locale/hi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  99. data/vendor/local/share/locale/hr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  100. data/vendor/local/share/locale/hu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  101. data/vendor/local/share/locale/hy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  102. data/vendor/local/share/locale/ia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  103. data/vendor/local/share/locale/id/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  104. data/vendor/local/share/locale/io/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  105. data/vendor/local/share/locale/is/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  106. data/vendor/local/share/locale/it/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  107. data/vendor/local/share/locale/ja/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  108. data/vendor/local/share/locale/ka/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  109. data/vendor/local/share/locale/kn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  110. data/vendor/local/share/locale/ko/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  111. data/vendor/local/share/locale/ku/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  112. data/vendor/local/share/locale/li/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  113. data/vendor/local/share/locale/lt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  114. data/vendor/local/share/locale/lv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  115. data/vendor/local/share/locale/mai/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  116. data/vendor/local/share/locale/mi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  117. data/vendor/local/share/locale/mk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  118. data/vendor/local/share/locale/ml/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  119. data/vendor/local/share/locale/mn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  120. data/vendor/local/share/locale/mr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  121. data/vendor/local/share/locale/ms/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  122. data/vendor/local/share/locale/my/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  123. data/vendor/local/share/locale/nb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  124. data/vendor/local/share/locale/nds/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  125. data/vendor/local/share/locale/ne/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  126. data/vendor/local/share/locale/nl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  127. data/vendor/local/share/locale/nn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  128. data/vendor/local/share/locale/nso/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  129. data/vendor/local/share/locale/oc/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  130. data/vendor/local/share/locale/or/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  131. data/vendor/local/share/locale/pa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  132. data/vendor/local/share/locale/pl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  133. data/vendor/local/share/locale/ps/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  134. data/vendor/local/share/locale/pt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  135. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  136. data/vendor/local/share/locale/ro/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  137. data/vendor/local/share/locale/ru/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  138. data/vendor/local/share/locale/si/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  139. data/vendor/local/share/locale/sk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  140. data/vendor/local/share/locale/sl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  141. data/vendor/local/share/locale/sq/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  142. data/vendor/local/share/locale/sr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  143. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  144. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  145. data/vendor/local/share/locale/sv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  146. data/vendor/local/share/locale/ta/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  147. data/vendor/local/share/locale/te/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  148. data/vendor/local/share/locale/th/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  149. data/vendor/local/share/locale/tk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  150. data/vendor/local/share/locale/tr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  151. data/vendor/local/share/locale/tt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  152. data/vendor/local/share/locale/ug/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  153. data/vendor/local/share/locale/uk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  154. data/vendor/local/share/locale/uz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  155. data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  156. data/vendor/local/share/locale/vi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  157. data/vendor/local/share/locale/wa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  158. data/vendor/local/share/locale/xh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  159. data/vendor/local/share/locale/yi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  160. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  161. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  162. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  163. data/vendor/local/share/man/man1/gdk-pixbuf-csource.1 +2 -2
  164. data/vendor/local/share/man/man1/gdk-pixbuf-query-loaders.1 +2 -2
  165. data/vendor/local/src/dieterv/packaging/gdk-pixbuf_2.24.0-1_win32.log +956 -0
  166. data/vendor/local/src/dieterv/packaging/gdk-pixbuf_2.24.0-1_win32.sh +97 -0
  167. metadata +26 -24
  168. data/ChangeLog +0 -482
  169. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-animation.html +0 -654
  170. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-creating.html +0 -406
  171. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-file-loading.html +0 -402
  172. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-file-saving.html +0 -685
  173. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html +0 -460
  174. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-inline.html +0 -516
  175. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-refcounting.html +0 -132
  176. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf.devhelp +0 -175
  177. data/vendor/local/src/tml/packaging/gdk-pixbuf_2.22.1-1_win32.log +0 -1012
  178. data/vendor/local/src/tml/packaging/gdk-pixbuf_2.22.1-1_win32.sh +0 -256
@@ -1,406 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>creating</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
- <link rel="home" href="index.html" title="GDK-PixBuf Reference Manual">
8
- <link rel="up" href="rn01.html" title="API Reference">
9
- <link rel="prev" href="gdk-pixbuf-file-saving.html" title="file-saving">
10
- <link rel="next" href="gdk-pixbuf-inline.html" title="inline">
11
- <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="gdk-pixbuf-file-saving.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">GDK-PixBuf Reference Manual</th>
21
- <td><a accesskey="n" href="gdk-pixbuf-inline.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#gdk-pixbuf-creating.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#gdk-pixbuf-creating.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry" title="creating">
30
- <a name="gdk-pixbuf-creating"></a><div class="titlepage"></div>
31
- <div class="refnamediv"><table width="100%"><tr>
32
- <td valign="top">
33
- <h2><span class="refentrytitle"><a name="gdk-pixbuf-creating.top_of_page"></a>creating</span></h2>
34
- <p>creating</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv" title="Synopsis">
39
- <a name="gdk-pixbuf-creating.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
42
-
43
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-new" title="gdk_pixbuf_new ()">gdk_pixbuf_new</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>,
44
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>,
45
- <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>,
46
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
47
- <em class="parameter"><code><span class="type">int</span> height</code></em>);
48
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()">gdk_pixbuf_new_from_data</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *data</code></em>,
49
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>,
50
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>,
51
- <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>,
52
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
53
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
54
- <em class="parameter"><code><span class="type">int</span> rowstride</code></em>,
55
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-refcounting.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> destroy_fn</code></em>,
56
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> destroy_fn_data</code></em>);
57
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-new-from-xpm-data" title="gdk_pixbuf_new_from_xpm_data ()">gdk_pixbuf_new_from_xpm_data</a> (<em class="parameter"><code>const <span class="type">char</span> **data</code></em>);
58
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>* <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-new-from-inline" title="gdk_pixbuf_new_from_inline ()">gdk_pixbuf_new_from_inline</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> data_length</code></em>,
59
- <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>,
60
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>,
61
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
62
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()">gdk_pixbuf_new_subpixbuf</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>,
63
- <em class="parameter"><code><span class="type">int</span> src_x</code></em>,
64
- <em class="parameter"><code><span class="type">int</span> src_y</code></em>,
65
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
66
- <em class="parameter"><code><span class="type">int</span> height</code></em>);
67
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-creating.html#gdk-pixbuf-copy" title="gdk_pixbuf_copy ()">gdk_pixbuf_copy</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);
68
- </pre>
69
- </div>
70
- <div class="refsect1" title="Description">
71
- <a name="gdk-pixbuf-creating.description"></a><h2>Description</h2>
72
- <p>
73
- </p>
74
- </div>
75
- <div class="refsect1" title="Details">
76
- <a name="gdk-pixbuf-creating.details"></a><h2>Details</h2>
77
- <div class="refsect2" title="gdk_pixbuf_new ()">
78
- <a name="gdk-pixbuf-new"></a><h3>gdk_pixbuf_new ()</h3>
79
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>,
80
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>,
81
- <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>,
82
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
83
- <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
84
- <p>
85
- Creates a new <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure and allocates a buffer for it. The
86
- buffer has an optimal rowstride. Note that the buffer is not cleared;
87
- you will have to fill it completely yourself.
88
- </p>
89
- <div class="variablelist"><table border="0">
90
- <col align="left" valign="top">
91
- <tbody>
92
- <tr>
93
- <td><p><span class="term"><em class="parameter"><code>colorspace</code></em> :</span></p></td>
94
- <td>Color space for image
95
- </td>
96
- </tr>
97
- <tr>
98
- <td><p><span class="term"><em class="parameter"><code>has_alpha</code></em> :</span></p></td>
99
- <td>Whether the image should have transparency information
100
- </td>
101
- </tr>
102
- <tr>
103
- <td><p><span class="term"><em class="parameter"><code>bits_per_sample</code></em> :</span></p></td>
104
- <td>Number of bits per color sample
105
- </td>
106
- </tr>
107
- <tr>
108
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
109
- <td>Width of image in pixels, must be &gt; 0
110
- </td>
111
- </tr>
112
- <tr>
113
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
114
- <td>Height of image in pixels, must be &gt; 0
115
- </td>
116
- </tr>
117
- <tr>
118
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
119
- <td> A newly-created <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with a reference count of 1, or
120
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be allocated for the image buffer.
121
- </td>
122
- </tr>
123
- </tbody>
124
- </table></div>
125
- </div>
126
- <hr>
127
- <div class="refsect2" title="gdk_pixbuf_new_from_data ()">
128
- <a name="gdk-pixbuf-new-from-data"></a><h3>gdk_pixbuf_new_from_data ()</h3>
129
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_data (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *data</code></em>,
130
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkColorspace" title="enum GdkColorspace"><span class="type">GdkColorspace</span></a> colorspace</code></em>,
131
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_alpha</code></em>,
132
- <em class="parameter"><code><span class="type">int</span> bits_per_sample</code></em>,
133
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
134
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
135
- <em class="parameter"><code><span class="type">int</span> rowstride</code></em>,
136
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-refcounting.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> destroy_fn</code></em>,
137
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> destroy_fn_data</code></em>);</pre>
138
- <p>
139
- Creates a new <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> out of in-memory image data. Currently only RGB
140
- images with 8 bits per sample are supported.
141
- </p>
142
- <div class="variablelist"><table border="0">
143
- <col align="left" valign="top">
144
- <tbody>
145
- <tr>
146
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
147
- <td>Image data in 8-bit/sample packed format
148
- </td>
149
- </tr>
150
- <tr>
151
- <td><p><span class="term"><em class="parameter"><code>colorspace</code></em> :</span></p></td>
152
- <td>Colorspace for the image data
153
- </td>
154
- </tr>
155
- <tr>
156
- <td><p><span class="term"><em class="parameter"><code>has_alpha</code></em> :</span></p></td>
157
- <td>Whether the data has an opacity channel
158
- </td>
159
- </tr>
160
- <tr>
161
- <td><p><span class="term"><em class="parameter"><code>bits_per_sample</code></em> :</span></p></td>
162
- <td>Number of bits per sample
163
- </td>
164
- </tr>
165
- <tr>
166
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
167
- <td>Width of the image in pixels, must be &gt; 0
168
- </td>
169
- </tr>
170
- <tr>
171
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
172
- <td>Height of the image in pixels, must be &gt; 0
173
- </td>
174
- </tr>
175
- <tr>
176
- <td><p><span class="term"><em class="parameter"><code>rowstride</code></em> :</span></p></td>
177
- <td>Distance in bytes between row starts
178
- </td>
179
- </tr>
180
- <tr>
181
- <td><p><span class="term"><em class="parameter"><code>destroy_fn</code></em> :</span></p></td>
182
- <td> Function used to free the data when the pixbuf's reference count
183
- drops to zero, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the data should not be freed. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
184
- </td>
185
- </tr>
186
- <tr>
187
- <td><p><span class="term"><em class="parameter"><code>destroy_fn_data</code></em> :</span></p></td>
188
- <td>Closure data to pass to the destroy notification function
189
- </td>
190
- </tr>
191
- <tr>
192
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
193
- <td> A newly-created <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure with a reference count of 1. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
194
- </td>
195
- </tr>
196
- </tbody>
197
- </table></div>
198
- </div>
199
- <hr>
200
- <div class="refsect2" title="gdk_pixbuf_new_from_xpm_data ()">
201
- <a name="gdk-pixbuf-new-from-xpm-data"></a><h3>gdk_pixbuf_new_from_xpm_data ()</h3>
202
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_xpm_data (<em class="parameter"><code>const <span class="type">char</span> **data</code></em>);</pre>
203
- <p>
204
- Creates a new pixbuf by parsing XPM data in memory. This data is commonly
205
- the result of including an XPM file into a program's C source.
206
- </p>
207
- <div class="variablelist"><table border="0">
208
- <col align="left" valign="top">
209
- <tbody>
210
- <tr>
211
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
212
- <td>Pointer to inline XPM data.
213
- </td>
214
- </tr>
215
- <tr>
216
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
217
- <td> A newly-created pixbuf with a reference count of 1.
218
- </td>
219
- </tr>
220
- </tbody>
221
- </table></div>
222
- </div>
223
- <hr>
224
- <div class="refsect2" title="gdk_pixbuf_new_from_inline ()">
225
- <a name="gdk-pixbuf-new-from-inline"></a><h3>gdk_pixbuf_new_from_inline ()</h3>
226
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>* gdk_pixbuf_new_from_inline (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> data_length</code></em>,
227
- <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>,
228
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> copy_pixels</code></em>,
229
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
230
- <p>
231
- Create a <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> from a flat representation that is suitable for
232
- storing as inline data in a program. This is useful if you want to
233
- ship a program with images, but don't want to depend on any
234
- external files.
235
- </p>
236
- <p>
237
- gdk-pixbuf ships with a program called <span class="command"><strong>gdk-pixbuf-csource</strong></span>
238
- which allows for conversion of <a href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbufs</span></a> into such a inline representation.
239
- In almost all cases, you should pass the <code class="option">--raw</code> flag to
240
- <span class="command"><strong>gdk-pixbuf-csource</strong></span>. A sample invocation would be:
241
- </p>
242
- <p>
243
- </p>
244
- <div class="informalexample">
245
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
246
- <tbody>
247
- <tr>
248
- <td class="listing_lines" align="right"><pre>1</pre></td>
249
- <td class="listing_code"><pre class="programlisting"><span class="normal">gdk</span><span class="symbol">-</span><span class="normal">pixbuf</span><span class="symbol">-</span><span class="normal">csource </span><span class="symbol">--</span><span class="normal">raw </span><span class="symbol">--</span><span class="normal">name</span><span class="symbol">=</span><span class="usertype">myimage_inline</span><span class="normal"> myimage</span><span class="symbol">.</span><span class="normal">png</span></pre></td>
250
- </tr>
251
- </tbody>
252
- </table>
253
- </div>
254
-
255
- <p>
256
- </p>
257
- <p>
258
- For the typical case where the inline pixbuf is read-only static data,
259
- you don't need to copy the pixel data unless you intend to write to
260
- it, so you can pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> for <em class="parameter"><code>copy_pixels</code></em>. (If you pass
261
- <code class="option">--rle</code> to <span class="command"><strong>gdk-pixbuf-csource</strong></span>, a copy
262
- will be made even if <em class="parameter"><code>copy_pixels</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, so using this option is
263
- generally a bad idea.)
264
- </p>
265
- <p>
266
- If you create a pixbuf from const inline data compiled into your
267
- program, it's probably safe to ignore errors and disable length checks,
268
- since things will always succeed:
269
- </p>
270
- <div class="informalexample">
271
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
272
- <tbody>
273
- <tr>
274
- <td class="listing_lines" align="right"><pre>1</pre></td>
275
- <td class="listing_code"><pre class="programlisting"><span class="normal">pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-creating.html#gdk-pixbuf-new-from-inline">gdk_pixbuf_new_from_inline</a></span><span class="normal"> </span><span class="symbol">(-</span><span class="number">1</span><span class="symbol">,</span><span class="normal"> myimage_inline</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
276
- </tr>
277
- </tbody>
278
- </table>
279
- </div>
280
-
281
- <p>
282
- </p>
283
- <p>
284
- For non-const inline data, you could get out of memory. For untrusted
285
- inline data located at runtime, you could have corrupt inline data in
286
- addition.
287
- </p>
288
- <div class="variablelist"><table border="0">
289
- <col align="left" valign="top">
290
- <tbody>
291
- <tr>
292
- <td><p><span class="term"><em class="parameter"><code>data_length</code></em> :</span></p></td>
293
- <td>Length in bytes of the <em class="parameter"><code>data</code></em> argument or -1 to
294
- disable length checks
295
- </td>
296
- </tr>
297
- <tr>
298
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
299
- <td>Byte data containing a serialized <a class="link" href="gdk-pixbuf-inline.html#GdkPixdata" title="GdkPixdata"><span class="type">GdkPixdata</span></a> structure
300
- </td>
301
- </tr>
302
- <tr>
303
- <td><p><span class="term"><em class="parameter"><code>copy_pixels</code></em> :</span></p></td>
304
- <td>Whether to copy the pixel data, or use direct pointers
305
- <em class="parameter"><code>data</code></em> for the resulting pixbuf
306
- </td>
307
- </tr>
308
- <tr>
309
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
310
- <td>
311
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> return location, may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors
312
- </td>
313
- </tr>
314
- <tr>
315
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316
- <td> A newly-created <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure with a reference,
317
- count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if an error occurred.
318
- </td>
319
- </tr>
320
- </tbody>
321
- </table></div>
322
- </div>
323
- <hr>
324
- <div class="refsect2" title="gdk_pixbuf_new_subpixbuf ()">
325
- <a name="gdk-pixbuf-new-subpixbuf"></a><h3>gdk_pixbuf_new_subpixbuf ()</h3>
326
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_subpixbuf (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src_pixbuf</code></em>,
327
- <em class="parameter"><code><span class="type">int</span> src_x</code></em>,
328
- <em class="parameter"><code><span class="type">int</span> src_y</code></em>,
329
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
330
- <em class="parameter"><code><span class="type">int</span> height</code></em>);</pre>
331
- <p>
332
- Creates a new pixbuf which represents a sub-region of
333
- <em class="parameter"><code>src_pixbuf</code></em>. The new pixbuf shares its pixels with the
334
- original pixbuf, so writing to one affects both.
335
- The new pixbuf holds a reference to <em class="parameter"><code>src_pixbuf</code></em>, so
336
- <em class="parameter"><code>src_pixbuf</code></em> will not be finalized until the new pixbuf
337
- is finalized.
338
- </p>
339
- <div class="variablelist"><table border="0">
340
- <col align="left" valign="top">
341
- <tbody>
342
- <tr>
343
- <td><p><span class="term"><em class="parameter"><code>src_pixbuf</code></em> :</span></p></td>
344
- <td>a <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
345
- </td>
346
- </tr>
347
- <tr>
348
- <td><p><span class="term"><em class="parameter"><code>src_x</code></em> :</span></p></td>
349
- <td>X coord in <em class="parameter"><code>src_pixbuf</code></em>
350
- </td>
351
- </tr>
352
- <tr>
353
- <td><p><span class="term"><em class="parameter"><code>src_y</code></em> :</span></p></td>
354
- <td>Y coord in <em class="parameter"><code>src_pixbuf</code></em>
355
- </td>
356
- </tr>
357
- <tr>
358
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
359
- <td>width of region in <em class="parameter"><code>src_pixbuf</code></em>
360
- </td>
361
- </tr>
362
- <tr>
363
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
364
- <td>height of region in <em class="parameter"><code>src_pixbuf</code></em>
365
- </td>
366
- </tr>
367
- <tr>
368
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
369
- <td> a new pixbuf. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
370
- </td>
371
- </tr>
372
- </tbody>
373
- </table></div>
374
- </div>
375
- <hr>
376
- <div class="refsect2" title="gdk_pixbuf_copy ()">
377
- <a name="gdk-pixbuf-copy"></a><h3>gdk_pixbuf_copy ()</h3>
378
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_copy (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
379
- <p>
380
- Creates a new <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with a copy of the information in the specified
381
- <em class="parameter"><code>pixbuf</code></em>.
382
- </p>
383
- <div class="variablelist"><table border="0">
384
- <col align="left" valign="top">
385
- <tbody>
386
- <tr>
387
- <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
388
- <td>A pixbuf.
389
- </td>
390
- </tr>
391
- <tr>
392
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
393
- <td> A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
394
- not enough memory could be allocated. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
395
- </td>
396
- </tr>
397
- </tbody>
398
- </table></div>
399
- </div>
400
- </div>
401
- </div>
402
- <div class="footer">
403
- <hr>
404
- Generated by GTK-Doc V1.15</div>
405
- </body>
406
- </html>
@@ -1,402 +0,0 @@
1
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html>
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <title>file-loading</title>
6
- <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
- <link rel="home" href="index.html" title="GDK-PixBuf Reference Manual">
8
- <link rel="up" href="rn01.html" title="API Reference">
9
- <link rel="prev" href="gdk-pixbuf-refcounting.html" title="refcounting">
10
- <link rel="next" href="gdk-pixbuf-file-saving.html" title="file-saving">
11
- <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
- <link rel="stylesheet" href="style.css" type="text/css">
13
- </head>
14
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
- <tr valign="middle">
17
- <td><a accesskey="p" href="gdk-pixbuf-refcounting.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
- <td><a accesskey="u" href="rn01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
- <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
- <th width="100%" align="center">GDK-PixBuf Reference Manual</th>
21
- <td><a accesskey="n" href="gdk-pixbuf-file-saving.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
- </tr>
23
- <tr><td colspan="5" class="shortcuts">
24
- <a href="#gdk-pixbuf-file-loading.synopsis" class="shortcut">Top</a>
25
-  | 
26
- <a href="#gdk-pixbuf-file-loading.description" class="shortcut">Description</a>
27
- </td></tr>
28
- </table>
29
- <div class="refentry" title="file-loading">
30
- <a name="gdk-pixbuf-file-loading"></a><div class="titlepage"></div>
31
- <div class="refnamediv"><table width="100%"><tr>
32
- <td valign="top">
33
- <h2><span class="refentrytitle"><a name="gdk-pixbuf-file-loading.top_of_page"></a>file-loading</span></h2>
34
- <p>file-loading</p>
35
- </td>
36
- <td valign="top" align="right"></td>
37
- </tr></table></div>
38
- <div class="refsynopsisdiv" title="Synopsis">
39
- <a name="gdk-pixbuf-file-loading.synopsis"></a><h2>Synopsis</h2>
40
- <pre class="synopsis">
41
- #include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
42
-
43
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file" title="gdk_pixbuf_new_from_file ()">gdk_pixbuf_new_from_file</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
44
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
45
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file-at-size" title="gdk_pixbuf_new_from_file_at_size ()">gdk_pixbuf_new_from_file_at_size</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
46
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
47
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
48
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
49
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()">gdk_pixbuf_new_from_file_at_scale</a> (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
50
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
51
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
52
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
53
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
54
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()">gdk_pixbuf_get_file_info</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
55
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>,
56
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>);
57
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-stream" title="gdk_pixbuf_new_from_stream ()">gdk_pixbuf_new_from_stream</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>,
58
- <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
59
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
60
- <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-stream-at-scale" title="gdk_pixbuf_new_from_stream_at_scale ()">gdk_pixbuf_new_from_stream_at_scale</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>,
61
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
62
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
63
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
64
- <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
65
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
66
- </pre>
67
- </div>
68
- <div class="refsect1" title="Description">
69
- <a name="gdk-pixbuf-file-loading.description"></a><h2>Description</h2>
70
- <p>
71
- </p>
72
- </div>
73
- <div class="refsect1" title="Details">
74
- <a name="gdk-pixbuf-file-loading.details"></a><h2>Details</h2>
75
- <div class="refsect2" title="gdk_pixbuf_new_from_file ()">
76
- <a name="gdk-pixbuf-new-from-file"></a><h3>gdk_pixbuf_new_from_file ()</h3>
77
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
78
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
79
- <p>
80
- Creates a new pixbuf by loading an image from a file. The file format is
81
- detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em> will be set.
82
- Possible errors are in the <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.
83
- </p>
84
- <div class="variablelist"><table border="0">
85
- <col align="left" valign="top">
86
- <tbody>
87
- <tr>
88
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
89
- <td>Name of file to load, in the GLib file name encoding
90
- </td>
91
- </tr>
92
- <tr>
93
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
94
- <td>Return location for an error
95
- </td>
96
- </tr>
97
- <tr>
98
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
99
- <td> A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
100
- any of several error conditions occurred: the file could not be opened,
101
- there was no loader for the file's format, there was not enough memory to
102
- allocate the image buffer, or the image file contained invalid data.
103
- </td>
104
- </tr>
105
- </tbody>
106
- </table></div>
107
- </div>
108
- <hr>
109
- <div class="refsect2" title="gdk_pixbuf_new_from_file_at_size ()">
110
- <a name="gdk-pixbuf-new-from-file-at-size"></a><h3>gdk_pixbuf_new_from_file_at_size ()</h3>
111
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file_at_size (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
112
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
113
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
114
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
115
- <p>
116
- Creates a new pixbuf by loading an image from a file.
117
- The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
118
- <em class="parameter"><code>error</code></em> will be set. Possible errors are in the <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and
119
- <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.
120
- </p>
121
- <p>
122
- The image will be scaled to fit in the requested size, preserving
123
- the image's aspect ratio. Note that the returned pixbuf may be smaller
124
- than <em class="parameter"><code>width</code></em> x <em class="parameter"><code>height</code></em>, if the aspect ratio requires it. To load
125
- and image at the requested size, regardless of aspect ratio, use
126
- <a class="link" href="gdk-pixbuf-file-loading.html#gdk-pixbuf-new-from-file-at-scale" title="gdk_pixbuf_new_from_file_at_scale ()"><code class="function">gdk_pixbuf_new_from_file_at_scale()</code></a>.
127
- </p>
128
- <div class="variablelist"><table border="0">
129
- <col align="left" valign="top">
130
- <tbody>
131
- <tr>
132
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
133
- <td>Name of file to load, in the GLib file name encoding
134
- </td>
135
- </tr>
136
- <tr>
137
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
138
- <td>The width the image should have or -1 to not constrain the width
139
- </td>
140
- </tr>
141
- <tr>
142
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
143
- <td>The height the image should have or -1 to not constrain the height
144
- </td>
145
- </tr>
146
- <tr>
147
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
148
- <td>Return location for an error
149
- </td>
150
- </tr>
151
- <tr>
152
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
153
- <td> A newly-created pixbuf with a reference count of 1, or
154
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error conditions occurred: the file could not
155
- be opened, there was no loader for the file's format, there was not
156
- enough memory to allocate the image buffer, or the image file contained
157
- invalid data.
158
-
159
- </td>
160
- </tr>
161
- </tbody>
162
- </table></div>
163
- <p class="since">Since 2.4</p>
164
- </div>
165
- <hr>
166
- <div class="refsect2" title="gdk_pixbuf_new_from_file_at_scale ()">
167
- <a name="gdk-pixbuf-new-from-file-at-scale"></a><h3>gdk_pixbuf_new_from_file_at_scale ()</h3>
168
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_file_at_scale (<em class="parameter"><code>const <span class="type">char</span> *filename</code></em>,
169
- <em class="parameter"><code><span class="type">int</span> width</code></em>,
170
- <em class="parameter"><code><span class="type">int</span> height</code></em>,
171
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
172
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
173
- <p>
174
- Creates a new pixbuf by loading an image from a file. The file format is
175
- detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then <em class="parameter"><code>error</code></em> will be set.
176
- Possible errors are in the <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a> domains.
177
- The image will be scaled to fit in the requested size, optionally preserving
178
- the image's aspect ratio.
179
- </p>
180
- <p>
181
- When preserving the aspect ratio, a <em class="parameter"><code>width</code></em> of -1 will cause the image
182
- to be scaled to the exact given height, and a <em class="parameter"><code>height</code></em> of -1 will cause
183
- the image to be scaled to the exact given width. When not preserving
184
- aspect ratio, a <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> of -1 means to not scale the image
185
- at all in that dimension. Negative values for <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> are
186
- allowed since 2.8.
187
- </p>
188
- <div class="variablelist"><table border="0">
189
- <col align="left" valign="top">
190
- <tbody>
191
- <tr>
192
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
193
- <td>Name of file to load, in the GLib file name encoding
194
- </td>
195
- </tr>
196
- <tr>
197
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
198
- <td>The width the image should have or -1 to not constrain the width
199
- </td>
200
- </tr>
201
- <tr>
202
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
203
- <td>The height the image should have or -1 to not constrain the height
204
- </td>
205
- </tr>
206
- <tr>
207
- <td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td>
208
- <td>
209
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio
210
- </td>
211
- </tr>
212
- <tr>
213
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
214
- <td>Return location for an error
215
- </td>
216
- </tr>
217
- <tr>
218
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
219
- <td> A newly-created pixbuf with a reference count of 1, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
220
- if any of several error conditions occurred: the file could not be opened,
221
- there was no loader for the file's format, there was not enough memory to
222
- allocate the image buffer, or the image file contained invalid data.
223
-
224
- </td>
225
- </tr>
226
- </tbody>
227
- </table></div>
228
- <p class="since">Since 2.6</p>
229
- </div>
230
- <hr>
231
- <div class="refsect2" title="gdk_pixbuf_get_file_info ()">
232
- <a name="gdk-pixbuf-get-file-info"></a><h3>gdk_pixbuf_get_file_info ()</h3>
233
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_get_file_info (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
234
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *width</code></em>,
235
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *height</code></em>);</pre>
236
- <p>
237
- Parses an image file far enough to determine its format and size.
238
- </p>
239
- <div class="variablelist"><table border="0">
240
- <col align="left" valign="top">
241
- <tbody>
242
- <tr>
243
- <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
244
- <td>The name of the file to identify.
245
- </td>
246
- </tr>
247
- <tr>
248
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
249
- <td>Return location for the width of the image, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
250
- </td>
251
- </tr>
252
- <tr>
253
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
254
- <td>Return location for the height of the image, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
255
- </td>
256
- </tr>
257
- <tr>
258
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
259
- <td> A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> describing the image format of the file
260
- or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the image format wasn't recognized. The return value
261
- is owned by GdkPixbuf and should not be freed.
262
-
263
- </td>
264
- </tr>
265
- </tbody>
266
- </table></div>
267
- <p class="since">Since 2.4</p>
268
- </div>
269
- <hr>
270
- <div class="refsect2" title="gdk_pixbuf_new_from_stream ()">
271
- <a name="gdk-pixbuf-new-from-stream"></a><h3>gdk_pixbuf_new_from_stream ()</h3>
272
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_stream (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>,
273
- <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
274
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
275
- <p>
276
- Creates a new pixbuf by loading an image from an input stream.
277
- </p>
278
- <p>
279
- The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
280
- <em class="parameter"><code>error</code></em> will be set. The <em class="parameter"><code>cancellable</code></em> can be used to abort the operation
281
- from another thread. If the operation was cancelled, the error
282
- <code class="literal">GIO_ERROR_CANCELLED</code> will be returned. Other possible errors are in
283
- the <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains.
284
- </p>
285
- <p>
286
- The stream is not closed.
287
- </p>
288
- <div class="variablelist"><table border="0">
289
- <col align="left" valign="top">
290
- <tbody>
291
- <tr>
292
- <td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td>
293
- <td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> to load the pixbuf from
294
- </td>
295
- </tr>
296
- <tr>
297
- <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
298
- <td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
299
- </td>
300
- </tr>
301
- <tr>
302
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
303
- <td>Return location for an error
304
- </td>
305
- </tr>
306
- <tr>
307
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
308
- <td> A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
309
- conditions occurred: the file could not be opened, the image format is
310
- not supported, there was not enough memory to allocate the image buffer,
311
- the stream contained invalid data, or the operation was cancelled.
312
-
313
- </td>
314
- </tr>
315
- </tbody>
316
- </table></div>
317
- <p class="since">Since 2.14</p>
318
- </div>
319
- <hr>
320
- <div class="refsect2" title="gdk_pixbuf_new_from_stream_at_scale ()">
321
- <a name="gdk-pixbuf-new-from-stream-at-scale"></a><h3>gdk_pixbuf_new_from_stream_at_scale ()</h3>
322
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_new_from_stream_at_scale (<em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> *stream</code></em>,
323
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> width</code></em>,
324
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> height</code></em>,
325
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> preserve_aspect_ratio</code></em>,
326
- <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> *cancellable</code></em>,
327
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
328
- <p>
329
- Creates a new pixbuf by loading an image from an input stream.
330
- </p>
331
- <p>
332
- The file format is detected automatically. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, then
333
- <em class="parameter"><code>error</code></em> will be set. The <em class="parameter"><code>cancellable</code></em> can be used to abort the operation
334
- from another thread. If the operation was cancelled, the error
335
- <code class="literal">GIO_ERROR_CANCELLED</code> will be returned. Other possible errors are in
336
- the <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GDK-PIXBUF-ERROR:CAPS" title="GDK_PIXBUF_ERROR"><span class="type">GDK_PIXBUF_ERROR</span></a> and <a href="http://library.gnome.org/devel/gio/unstable/gio-GIOError.html#G-IO-ERROR:CAPS"><code class="literal">G_IO_ERROR</code></a> domains.
337
- </p>
338
- <p>
339
- The image will be scaled to fit in the requested size, optionally
340
- preserving the image's aspect ratio. When preserving the aspect ratio,
341
- a <em class="parameter"><code>width</code></em> of -1 will cause the image to be scaled to the exact given
342
- height, and a <em class="parameter"><code>height</code></em> of -1 will cause the image to be scaled to the
343
- exact given width. When not preserving aspect ratio, a <em class="parameter"><code>width</code></em> or
344
- <em class="parameter"><code>height</code></em> of -1 means to not scale the image at all in that dimension.
345
- </p>
346
- <p>
347
- The stream is not closed.
348
- </p>
349
- <div class="variablelist"><table border="0">
350
- <col align="left" valign="top">
351
- <tbody>
352
- <tr>
353
- <td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td>
354
- <td>a <a href="http://library.gnome.org/devel/gio/unstable/GInputStream.html"><span class="type">GInputStream</span></a> to load the pixbuf from
355
- </td>
356
- </tr>
357
- <tr>
358
- <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
359
- <td>The width the image should have or -1 to not constrain the width
360
- </td>
361
- </tr>
362
- <tr>
363
- <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
364
- <td>The height the image should have or -1 to not constrain the height
365
- </td>
366
- </tr>
367
- <tr>
368
- <td><p><span class="term"><em class="parameter"><code>preserve_aspect_ratio</code></em> :</span></p></td>
369
- <td>
370
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to preserve the image's aspect ratio
371
- </td>
372
- </tr>
373
- <tr>
374
- <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
375
- <td>optional <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
376
- </td>
377
- </tr>
378
- <tr>
379
- <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
380
- <td>Return location for an error
381
- </td>
382
- </tr>
383
- <tr>
384
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
385
- <td> A newly-created pixbuf, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if any of several error
386
- conditions occurred: the file could not be opened, the image format is
387
- not supported, there was not enough memory to allocate the image buffer,
388
- the stream contained invalid data, or the operation was cancelled.
389
-
390
- </td>
391
- </tr>
392
- </tbody>
393
- </table></div>
394
- <p class="since">Since 2.14</p>
395
- </div>
396
- </div>
397
- </div>
398
- <div class="footer">
399
- <hr>
400
- Generated by GTK-Doc V1.15</div>
401
- </body>
402
- </html>