gdk_pixbuf2 1.0.3-x86-mingw32 → 1.1.0-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.
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>