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
data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html CHANGED
@@ -8,7 +8,7 @@
8
8
  <link rel="up" href="rn01.html" title="API Reference">
9
9
  <link rel="prev" href="GdkPixbufLoader.html" title="GdkPixbufLoader">
10
10
  <link rel="next" href="rn02.html" title="Tools Reference">
11
- <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -26,108 +26,155 @@
26
26
  <a href="#gdk-pixbuf-Module-Interface.description" class="shortcut">Description</a>
27
27
  </td></tr>
28
28
  </table>
29
- <div class="refentry" title="Module Interface">
29
+ <div class="refentry">
30
30
  <a name="gdk-pixbuf-Module-Interface"></a><div class="titlepage"></div>
31
31
  <div class="refnamediv"><table width="100%"><tr>
32
32
  <td valign="top">
33
33
  <h2><span class="refentrytitle"><a name="gdk-pixbuf-Module-Interface.top_of_page"></a>Module Interface</span></h2>
34
- <p>Module Interface</p>
34
+ <p>Module Interface — Extending &amp;gdk-pixbuf;</p>
35
35
  </td>
36
36
  <td valign="top" align="right"></td>
37
37
  </tr></table></div>
38
- <div class="refsynopsisdiv" title="Synopsis">
38
+ <div class="refsynopsisdiv">
39
39
  <a name="gdk-pixbuf-Module-Interface.synopsis"></a><h2>Synopsis</h2>
40
40
  <pre class="synopsis">
41
41
  #include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
42
42
 
43
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()">gdk_pixbuf_set_option</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
44
- <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> *key</code></em>,
45
- <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> *value</code></em>);
46
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()">gdk_pixbuf_get_formats</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
47
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()">gdk_pixbuf_format_copy</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
48
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()">gdk_pixbuf_format_free</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
49
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()">gdk_pixbuf_format_get_name</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
50
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" title="gdk_pixbuf_format_get_description ()">gdk_pixbuf_format_get_description</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
51
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()">gdk_pixbuf_format_get_mime_types</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
52
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" title="gdk_pixbuf_format_get_extensions ()">gdk_pixbuf_format_get_extensions</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
53
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" title="gdk_pixbuf_format_is_writable ()">gdk_pixbuf_format_is_writable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
54
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" title="gdk_pixbuf_format_is_scalable ()">gdk_pixbuf_format_is_scalable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
55
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" title="gdk_pixbuf_format_is_disabled ()">gdk_pixbuf_format_is_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
56
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()">gdk_pixbuf_format_set_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>,
57
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> disabled</code></em>);
58
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()">gdk_pixbuf_format_get_license</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
59
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat">GdkPixbufFormat</a>;
43
+ <span class="returnvalue">gboolean</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-set-option" title="gdk_pixbuf_set_option ()">gdk_pixbuf_set_option</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
44
+ <em class="parameter"><code>const <span class="type">gchar</span> *key</code></em>,
45
+ <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
46
+ <span class="returnvalue">GSList</span> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-get-formats" title="gdk_pixbuf_get_formats ()">gdk_pixbuf_get_formats</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
47
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()">gdk_pixbuf_format_copy</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
48
+ <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()">gdk_pixbuf_format_free</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
49
+ <span class="returnvalue">gchar</span> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-name" title="gdk_pixbuf_format_get_name ()">gdk_pixbuf_format_get_name</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
50
+ <span class="returnvalue">gchar</span> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-description" title="gdk_pixbuf_format_get_description ()">gdk_pixbuf_format_get_description</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
51
+ <span class="returnvalue">gchar</span> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-mime-types" title="gdk_pixbuf_format_get_mime_types ()">gdk_pixbuf_format_get_mime_types</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
52
+ <span class="returnvalue">gchar</span> ** <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-extensions" title="gdk_pixbuf_format_get_extensions ()">gdk_pixbuf_format_get_extensions</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
53
+ <span class="returnvalue">gboolean</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-writable" title="gdk_pixbuf_format_is_writable ()">gdk_pixbuf_format_is_writable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
54
+ <span class="returnvalue">gboolean</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-scalable" title="gdk_pixbuf_format_is_scalable ()">gdk_pixbuf_format_is_scalable</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
55
+ <span class="returnvalue">gboolean</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-is-disabled" title="gdk_pixbuf_format_is_disabled ()">gdk_pixbuf_format_is_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
56
+ <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()">gdk_pixbuf_format_set_disabled</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>,
57
+ <em class="parameter"><code><span class="type">gboolean</span> disabled</code></em>);
58
+ <span class="returnvalue">gchar</span> * <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-get-license" title="gdk_pixbuf_format_get_license ()">gdk_pixbuf_format_get_license</a> (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);
59
+ struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat">GdkPixbufFormat</a>;
60
60
  enum <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags">GdkPixbufFormatFlags</a>;
61
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="GdkPixbufModulePattern">GdkPixbufModulePattern</a>;
62
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()">*GdkPixbufModuleFillVtableFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>);
63
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()">*GdkPixbufModuleFillInfoFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>);
64
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" title="GdkPixbufModuleSizeFunc ()">*GdkPixbufModuleSizeFunc</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> *width</code></em>,
65
- <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>,
66
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
67
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" title="GdkPixbufModulePreparedFunc ()">*GdkPixbufModulePreparedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
68
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-animation.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>,
69
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
70
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" title="GdkPixbufModuleUpdatedFunc ()">*GdkPixbufModuleUpdatedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
61
+ struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern">GdkPixbufModulePattern</a>;
62
+ <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()">*GdkPixbufModuleFillVtableFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>);
63
+ <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()">*GdkPixbufModuleFillInfoFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>);
64
+ <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleSizeFunc" title="GdkPixbufModuleSizeFunc ()">*GdkPixbufModuleSizeFunc</a>) (<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
65
+ <em class="parameter"><code><span class="type">gint</span> *height</code></em>,
66
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
67
+ <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePreparedFunc" title="GdkPixbufModulePreparedFunc ()">*GdkPixbufModulePreparedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
68
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>,
69
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
70
+ <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleUpdatedFunc" title="GdkPixbufModuleUpdatedFunc ()">*GdkPixbufModuleUpdatedFunc</a>) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
71
71
  <em class="parameter"><code><span class="type">int</span> x</code></em>,
72
72
  <em class="parameter"><code><span class="type">int</span> y</code></em>,
73
73
  <em class="parameter"><code><span class="type">int</span> width</code></em>,
74
74
  <em class="parameter"><code><span class="type">int</span> height</code></em>,
75
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
76
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="GdkPixbufModule">GdkPixbufModule</a>;
75
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
76
+ struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule">GdkPixbufModule</a>;
77
77
 
78
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass" title="GdkPixbufAnimationClass">GdkPixbufAnimationClass</a>;
79
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass" title="GdkPixbufAnimationIterClass">GdkPixbufAnimationIterClass</a>;
78
+ struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationClass" title="struct GdkPixbufAnimationClass">GdkPixbufAnimationClass</a>;
79
+ struct <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufAnimationIterClass" title="struct GdkPixbufAnimationIterClass">GdkPixbufAnimationIterClass</a>;
80
80
  </pre>
81
81
  </div>
82
- <div class="refsect1" title="Description">
82
+ <div class="refsect1">
83
83
  <a name="gdk-pixbuf-Module-Interface.description"></a><h2>Description</h2>
84
84
  <p>
85
+ If &amp;gdk-pixbuf; has been compiled with GModule support, it can be extended by
86
+ modules which can load (and perhaps also save) new image and animation
87
+ formats. Each loadable module must export a
88
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillInfoFunc" title="GdkPixbufModuleFillInfoFunc ()"><span class="type">GdkPixbufModuleFillInfoFunc</span></a> function named <code class="function">fill_info</code> and
89
+ a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()"><span class="type">GdkPixbufModuleFillVtableFunc</span></a> function named
90
+ <code class="function">fill_vtable</code>.
91
+ </p>
92
+ <p>
93
+ In order to make format-checking work before actually loading the modules
94
+ (which may require dlopening image libraries), modules export their
95
+ signatures (and other information) via the <code class="function">fill_info</code>
96
+ function. An external utility, <span class="command"><strong>gdk-pixbuf-query-loaders</strong></span>,
97
+ uses this to create a text file containing a list of all available loaders and
98
+ their signatures. This file is then read at runtime by &amp;gdk-pixbuf; to obtain
99
+ the list of available loaders and their signatures.
100
+ </p>
101
+ <p>
102
+ Modules may only implement a subset of the functionality available via
103
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>. If a particular functionality is not implemented, the
104
+ <code class="function">fill_vtable</code> function will simply not set the corresponding
105
+ function pointers of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> structure. If a module supports
106
+ incremental loading (i.e. provides <span class="type">begin_load</span>, <span class="type">stop_load</span> and
107
+ <span class="type">load_increment</span>), it doesn't have to implement <span class="type">load</span>, since &amp;gdk-pixbuf; can
108
+ supply a generic <span class="type">load</span> implementation wrapping the incremental loading.
109
+ </p>
110
+ <p>
111
+ Installing a module is a two-step process:
112
+ </p>
113
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc">
114
+ <li class="listitem"><p>copy the module file(s) to the loader directory (normally
115
+ <code class="filename"><em class="replaceable"><code>libdir</code></em>/gtk-2.0/<em class="replaceable"><code>version</code></em>/loaders</code>,
116
+ unless overridden by the environment variable
117
+ <code class="envar">GDK_PIXBUF_MODULEDIR</code>)
118
+ </p></li>
119
+ <li class="listitem"><p>call <span class="command"><strong>gdk-pixbuf-query-loaders</strong></span> to update the
120
+ module file (normally
121
+ <code class="filename"><em class="replaceable"><code>sysconfdir</code></em>/gtk-2.0/gdk-pixbuf.loaders</code>,
122
+ unless overridden by the environment variable
123
+ <code class="envar">GDK_PIXBUF_MODULE_FILE</code>)
124
+ </p></li>
125
+ </ul></div>
126
+ <p>
127
+ </p>
128
+ <p>
129
+ The &amp;gdk-pixbuf; interfaces needed for implementing modules are contained in
130
+ <code class="filename">gdk-pixbuf-io.h</code> (and
131
+ <code class="filename">gdk-pixbuf-animation.h</code> if the module supports animations).
132
+ They are not covered by the same stability guarantees as the regular
133
+ &amp;gdk-pixbuf; API. To underline this fact, they are protected by
134
+ <code class="literal">#ifdef GDK_PIXBUF_ENABLE_BACKEND</code>.
85
135
  </p>
86
136
  </div>
87
- <div class="refsect1" title="Details">
137
+ <div class="refsect1">
88
138
  <a name="gdk-pixbuf-Module-Interface.details"></a><h2>Details</h2>
89
- <div class="refsect2" title="gdk_pixbuf_set_option ()">
139
+ <div class="refsect2">
90
140
  <a name="gdk-pixbuf-set-option"></a><h3>gdk_pixbuf_set_option ()</h3>
91
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_set_option (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
92
- <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> *key</code></em>,
93
- <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> *value</code></em>);</pre>
141
+ <pre class="programlisting"><span class="returnvalue">gboolean</span> gdk_pixbuf_set_option (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
142
+ <em class="parameter"><code>const <span class="type">gchar</span> *key</code></em>,
143
+ <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
94
144
  <p>
95
- Attaches a key/value pair as an option to a <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. If <code class="literal">key</code> already
145
+ Attaches a key/value pair as an option to a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>. If <code class="literal">key</code> already
96
146
  exists in the list of options attached to <em class="parameter"><code>pixbuf</code></em>, the new value is
97
- ignored and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned.
147
+ ignored and <code class="literal">FALSE</code> is returned.
98
148
  </p>
99
149
  <div class="variablelist"><table border="0">
100
150
  <col align="left" valign="top">
101
151
  <tbody>
102
152
  <tr>
103
153
  <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
104
- <td>a <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
154
+ <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
105
155
  </td>
106
156
  </tr>
107
157
  <tr>
108
158
  <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
109
- <td>a nul-terminated string.
110
- </td>
159
+ <td>a nul-terminated string.</td>
111
160
  </tr>
112
161
  <tr>
113
162
  <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
114
- <td>a nul-terminated string.
115
- </td>
163
+ <td>a nul-terminated string.</td>
116
164
  </tr>
117
165
  <tr>
118
166
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
119
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success.
120
-
121
- </td>
167
+ <td>
168
+ <code class="literal">TRUE</code> on success.</td>
122
169
  </tr>
123
170
  </tbody>
124
171
  </table></div>
125
172
  <p class="since">Since 2.2</p>
126
173
  </div>
127
174
  <hr>
128
- <div class="refsect2" title="gdk_pixbuf_get_formats ()">
175
+ <div class="refsect2">
129
176
  <a name="gdk-pixbuf-get-formats"></a><h3>gdk_pixbuf_get_formats ()</h3>
130
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gdk_pixbuf_get_formats (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
177
+ <pre class="programlisting"><span class="returnvalue">GSList</span> * gdk_pixbuf_get_formats (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
131
178
  <p>
132
179
  Obtains the available information about the image formats supported
133
180
  by GdkPixbuf.
@@ -136,10 +183,10 @@ by GdkPixbuf.
136
183
  <col align="left" valign="top">
137
184
  <tbody><tr>
138
185
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
139
- <td> A list of
140
- <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>s describing the supported
186
+ <td>A list of
187
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>s describing the supported
141
188
  image formats. The list should be freed when it is no longer needed,
142
- but the structures themselves are owned by <a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> and should not be
189
+ but the structures themselves are owned by <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> and should not be
143
190
  freed. <span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkPixbufFormat]</span>
144
191
  </td>
145
192
  </tr></tbody>
@@ -147,9 +194,9 @@ freed. <span class="annotation">[<acronym title="Free data container after the c
147
194
  <p class="since">Since 2.2</p>
148
195
  </div>
149
196
  <hr>
150
- <div class="refsect2" title="gdk_pixbuf_format_copy ()">
197
+ <div class="refsect2">
151
198
  <a name="gdk-pixbuf-format-copy"></a><h3>gdk_pixbuf_format_copy ()</h3>
152
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_format_copy (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
199
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="returnvalue">GdkPixbufFormat</span></a> * gdk_pixbuf_format_copy (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
153
200
  <p>
154
201
  Creates a copy of <em class="parameter"><code>format</code></em>
155
202
  </p>
@@ -158,42 +205,40 @@ Creates a copy of <em class="parameter"><code>format</code></em>
158
205
  <tbody>
159
206
  <tr>
160
207
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
161
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
208
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
162
209
  </td>
163
210
  </tr>
164
211
  <tr>
165
212
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
166
- <td> the newly allocated copy of a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>. Use
167
- <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()"><code class="function">gdk_pixbuf_format_free()</code></a> to free the resources when done
168
-
169
- </td>
213
+ <td>the newly allocated copy of a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>. Use
214
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-free" title="gdk_pixbuf_format_free ()"><code class="function">gdk_pixbuf_format_free()</code></a> to free the resources when done</td>
170
215
  </tr>
171
216
  </tbody>
172
217
  </table></div>
173
218
  <p class="since">Since 2.22</p>
174
219
  </div>
175
220
  <hr>
176
- <div class="refsect2" title="gdk_pixbuf_format_free ()">
221
+ <div class="refsect2">
177
222
  <a name="gdk-pixbuf-format-free"></a><h3>gdk_pixbuf_format_free ()</h3>
178
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_free (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
223
+ <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_free (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
179
224
  <p>
180
- Frees the resources allocated when copying a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
225
+ Frees the resources allocated when copying a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
181
226
  using <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-copy" title="gdk_pixbuf_format_copy ()"><code class="function">gdk_pixbuf_format_copy()</code></a>
182
227
  </p>
183
228
  <div class="variablelist"><table border="0">
184
229
  <col align="left" valign="top">
185
230
  <tbody><tr>
186
231
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
187
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
232
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
188
233
  </td>
189
234
  </tr></tbody>
190
235
  </table></div>
191
236
  <p class="since">Since 2.22</p>
192
237
  </div>
193
238
  <hr>
194
- <div class="refsect2" title="gdk_pixbuf_format_get_name ()">
239
+ <div class="refsect2">
195
240
  <a name="gdk-pixbuf-format-get-name"></a><h3>gdk_pixbuf_format_get_name ()</h3>
196
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_name (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
241
+ <pre class="programlisting"><span class="returnvalue">gchar</span> * gdk_pixbuf_format_get_name (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
197
242
  <p>
198
243
  Returns the name of the format.
199
244
  </p>
@@ -202,23 +247,21 @@ Returns the name of the format.
202
247
  <tbody>
203
248
  <tr>
204
249
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
205
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
250
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
206
251
  </td>
207
252
  </tr>
208
253
  <tr>
209
254
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
210
- <td> the name of the format.
211
-
212
- </td>
255
+ <td>the name of the format.</td>
213
256
  </tr>
214
257
  </tbody>
215
258
  </table></div>
216
259
  <p class="since">Since 2.2</p>
217
260
  </div>
218
261
  <hr>
219
- <div class="refsect2" title="gdk_pixbuf_format_get_description ()">
262
+ <div class="refsect2">
220
263
  <a name="gdk-pixbuf-format-get-description"></a><h3>gdk_pixbuf_format_get_description ()</h3>
221
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_description (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
264
+ <pre class="programlisting"><span class="returnvalue">gchar</span> * gdk_pixbuf_format_get_description (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
222
265
  <p>
223
266
  Returns a description of the format.
224
267
  </p>
@@ -227,23 +270,21 @@ Returns a description of the format.
227
270
  <tbody>
228
271
  <tr>
229
272
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
230
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
273
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
231
274
  </td>
232
275
  </tr>
233
276
  <tr>
234
277
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
235
- <td> a description of the format.
236
-
237
- </td>
278
+ <td>a description of the format.</td>
238
279
  </tr>
239
280
  </tbody>
240
281
  </table></div>
241
282
  <p class="since">Since 2.2</p>
242
283
  </div>
243
284
  <hr>
244
- <div class="refsect2" title="gdk_pixbuf_format_get_mime_types ()">
285
+ <div class="refsect2">
245
286
  <a name="gdk-pixbuf-format-get-mime-types"></a><h3>gdk_pixbuf_format_get_mime_types ()</h3>
246
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gdk_pixbuf_format_get_mime_types (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
287
+ <pre class="programlisting"><span class="returnvalue">gchar</span> ** gdk_pixbuf_format_get_mime_types (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
247
288
  <p>
248
289
  Returns the mime types supported by the format.
249
290
  </p>
@@ -252,13 +293,13 @@ Returns the mime types supported by the format.
252
293
  <tbody>
253
294
  <tr>
254
295
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
255
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
296
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
256
297
  </td>
257
298
  </tr>
258
299
  <tr>
259
300
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
260
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of mime types which must be freed with
261
- <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
301
+ <td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of mime types which must be freed with
302
+ <code class="function">g_strfreev()</code> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
262
303
  </td>
263
304
  </tr>
264
305
  </tbody>
@@ -266,9 +307,9 @@ Returns the mime types supported by the format.
266
307
  <p class="since">Since 2.2</p>
267
308
  </div>
268
309
  <hr>
269
- <div class="refsect2" title="gdk_pixbuf_format_get_extensions ()">
310
+ <div class="refsect2">
270
311
  <a name="gdk-pixbuf-format-get-extensions"></a><h3>gdk_pixbuf_format_get_extensions ()</h3>
271
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> ** gdk_pixbuf_format_get_extensions (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
312
+ <pre class="programlisting"><span class="returnvalue">gchar</span> ** gdk_pixbuf_format_get_extensions (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
272
313
  <p>
273
314
  Returns the filename extensions typically used for files in the
274
315
  given format.
@@ -278,13 +319,13 @@ given format.
278
319
  <tbody>
279
320
  <tr>
280
321
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
281
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
322
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
282
323
  </td>
283
324
  </tr>
284
325
  <tr>
285
326
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
286
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of filename extensions which must be
287
- freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
327
+ <td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of filename extensions which must be
328
+ freed with <code class="function">g_strfreev()</code> when it is no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
288
329
  </td>
289
330
  </tr>
290
331
  </tbody>
@@ -292,9 +333,9 @@ freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Uti
292
333
  <p class="since">Since 2.2</p>
293
334
  </div>
294
335
  <hr>
295
- <div class="refsect2" title="gdk_pixbuf_format_is_writable ()">
336
+ <div class="refsect2">
296
337
  <a name="gdk-pixbuf-format-is-writable"></a><h3>gdk_pixbuf_format_is_writable ()</h3>
297
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_writable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
338
+ <pre class="programlisting"><span class="returnvalue">gboolean</span> gdk_pixbuf_format_is_writable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
298
339
  <p>
299
340
  Returns whether pixbufs can be saved in the given format.
300
341
  </p>
@@ -303,23 +344,21 @@ Returns whether pixbufs can be saved in the given format.
303
344
  <tbody>
304
345
  <tr>
305
346
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
306
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
347
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
307
348
  </td>
308
349
  </tr>
309
350
  <tr>
310
351
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
311
- <td> whether pixbufs can be saved in the given format.
312
-
313
- </td>
352
+ <td>whether pixbufs can be saved in the given format.</td>
314
353
  </tr>
315
354
  </tbody>
316
355
  </table></div>
317
356
  <p class="since">Since 2.2</p>
318
357
  </div>
319
358
  <hr>
320
- <div class="refsect2" title="gdk_pixbuf_format_is_scalable ()">
359
+ <div class="refsect2">
321
360
  <a name="gdk-pixbuf-format-is-scalable"></a><h3>gdk_pixbuf_format_is_scalable ()</h3>
322
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_scalable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
361
+ <pre class="programlisting"><span class="returnvalue">gboolean</span> gdk_pixbuf_format_is_scalable (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
323
362
  <p>
324
363
  Returns whether this image format is scalable. If a file is in a
325
364
  scalable format, it is preferable to load it at the desired size,
@@ -331,23 +370,21 @@ resulting pixbuf to the desired size.
331
370
  <tbody>
332
371
  <tr>
333
372
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
334
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
373
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
335
374
  </td>
336
375
  </tr>
337
376
  <tr>
338
377
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
339
- <td> whether this image format is scalable.
340
-
341
- </td>
378
+ <td>whether this image format is scalable.</td>
342
379
  </tr>
343
380
  </tbody>
344
381
  </table></div>
345
382
  <p class="since">Since 2.6</p>
346
383
  </div>
347
384
  <hr>
348
- <div class="refsect2" title="gdk_pixbuf_format_is_disabled ()">
385
+ <div class="refsect2">
349
386
  <a name="gdk-pixbuf-format-is-disabled"></a><h3>gdk_pixbuf_format_is_disabled ()</h3>
350
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gdk_pixbuf_format_is_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
387
+ <pre class="programlisting"><span class="returnvalue">gboolean</span> gdk_pixbuf_format_is_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
351
388
  <p>
352
389
  Returns whether this image format is disabled. See
353
390
  <a class="link" href="gdk-pixbuf-Module-Interface.html#gdk-pixbuf-format-set-disabled" title="gdk_pixbuf_format_set_disabled ()"><code class="function">gdk_pixbuf_format_set_disabled()</code></a>.
@@ -357,24 +394,22 @@ Returns whether this image format is disabled. See
357
394
  <tbody>
358
395
  <tr>
359
396
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
360
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
397
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
361
398
  </td>
362
399
  </tr>
363
400
  <tr>
364
401
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
365
- <td> whether this image format is disabled.
366
-
367
- </td>
402
+ <td>whether this image format is disabled.</td>
368
403
  </tr>
369
404
  </tbody>
370
405
  </table></div>
371
406
  <p class="since">Since 2.6</p>
372
407
  </div>
373
408
  <hr>
374
- <div class="refsect2" title="gdk_pixbuf_format_set_disabled ()">
409
+ <div class="refsect2">
375
410
  <a name="gdk-pixbuf-format-set-disabled"></a><h3>gdk_pixbuf_format_set_disabled ()</h3>
376
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_set_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>,
377
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> disabled</code></em>);</pre>
411
+ <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_format_set_disabled (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>,
412
+ <em class="parameter"><code><span class="type">gboolean</span> disabled</code></em>);</pre>
378
413
  <p>
379
414
  Disables or enables an image format. If a format is disabled,
380
415
  gdk-pixbuf won't use the image loader for this format to load
@@ -386,13 +421,13 @@ with an inappropriate license, see <a class="link" href="gdk-pixbuf-Module-Inter
386
421
  <tbody>
387
422
  <tr>
388
423
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
389
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
424
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
390
425
  </td>
391
426
  </tr>
392
427
  <tr>
393
428
  <td><p><span class="term"><em class="parameter"><code>disabled</code></em> :</span></p></td>
394
429
  <td>
395
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to disable the format <em class="parameter"><code>format</code></em>
430
+ <code class="literal">TRUE</code> to disable the format <em class="parameter"><code>format</code></em>
396
431
  </td>
397
432
  </tr>
398
433
  </tbody>
@@ -400,37 +435,35 @@ with an inappropriate license, see <a class="link" href="gdk-pixbuf-Module-Inter
400
435
  <p class="since">Since 2.6</p>
401
436
  </div>
402
437
  <hr>
403
- <div class="refsect2" title="gdk_pixbuf_format_get_license ()">
438
+ <div class="refsect2">
404
439
  <a name="gdk-pixbuf-format-get-license"></a><h3>gdk_pixbuf_format_get_license ()</h3>
405
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gdk_pixbuf_format_get_license (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
440
+ <pre class="programlisting"><span class="returnvalue">gchar</span> * gdk_pixbuf_format_get_license (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *format</code></em>);</pre>
406
441
  <p>
407
442
  Returns information about the license of the image loader for the format. The
408
443
  returned string should be a shorthand for a wellknown license, e.g. "LGPL",
409
444
  "GPL", "QPL", "GPL/QPL", or "other" to indicate some other license. This
410
- string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it's no longer needed.
445
+ string should be freed with <code class="function">g_free()</code> when it's no longer needed.
411
446
  </p>
412
447
  <div class="variablelist"><table border="0">
413
448
  <col align="left" valign="top">
414
449
  <tbody>
415
450
  <tr>
416
451
  <td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
417
- <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
452
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>
418
453
  </td>
419
454
  </tr>
420
455
  <tr>
421
456
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
422
- <td> a string describing the license of <em class="parameter"><code>format</code></em>.
423
-
424
- </td>
457
+ <td>a string describing the license of <em class="parameter"><code>format</code></em>.</td>
425
458
  </tr>
426
459
  </tbody>
427
460
  </table></div>
428
461
  <p class="since">Since 2.6</p>
429
462
  </div>
430
463
  <hr>
431
- <div class="refsect2" title="GdkPixbufFormat">
432
- <a name="GdkPixbufFormat"></a><h3>GdkPixbufFormat</h3>
433
- <pre class="programlisting">typedef struct {
464
+ <div class="refsect2">
465
+ <a name="GdkPixbufFormat"></a><h3>struct GdkPixbufFormat</h3>
466
+ <pre class="programlisting">struct GdkPixbufFormat {
434
467
  gchar *name;
435
468
  GdkPixbufModulePattern *signature;
436
469
  gchar *domain;
@@ -440,13 +473,60 @@ string should be freed with <a href="http://library.gnome.org/devel/glib/unstabl
440
473
  guint32 flags;
441
474
  gboolean disabled;
442
475
  gchar *license;
443
- } GdkPixbufFormat;
476
+ };
444
477
  </pre>
445
478
  <p>
479
+ A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> contains information about the image format accepted by a
480
+ module. Only modules should access the fields directly, applications should
481
+ use the <code class="function">gdk_pixbuf_format_*</code> functions.
446
482
  </p>
483
+ <div class="variablelist"><table border="0">
484
+ <col align="left" valign="top">
485
+ <tbody>
486
+ <tr>
487
+ <td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkPixbufFormat.name"></a>name</code></em>;</span></p></td>
488
+ <td>the name of the image format.</td>
489
+ </tr>
490
+ <tr>
491
+ <td><p><span class="term"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern"><span class="type">GdkPixbufModulePattern</span></a> *<em class="structfield"><code><a name="GdkPixbufFormat.signature"></a>signature</code></em>;</span></p></td>
492
+ <td>the signature of the module.</td>
493
+ </tr>
494
+ <tr>
495
+ <td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkPixbufFormat.domain"></a>domain</code></em>;</span></p></td>
496
+ <td>the message domain for the <em class="parameter"><code>description</code></em>.</td>
497
+ </tr>
498
+ <tr>
499
+ <td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkPixbufFormat.description"></a>description</code></em>;</span></p></td>
500
+ <td>a description of the image format.</td>
501
+ </tr>
502
+ <tr>
503
+ <td><p><span class="term"><span class="type">gchar</span> **<em class="structfield"><code><a name="GdkPixbufFormat.mime-types"></a>mime_types</code></em>;</span></p></td>
504
+ <td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of MIME types for the image format.</td>
505
+ </tr>
506
+ <tr>
507
+ <td><p><span class="term"><span class="type">gchar</span> **<em class="structfield"><code><a name="GdkPixbufFormat.extensions"></a>extensions</code></em>;</span></p></td>
508
+ <td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array of typical filename extensions for the
509
+ image format.</td>
510
+ </tr>
511
+ <tr>
512
+ <td><p><span class="term"><span class="type">guint32</span> <em class="structfield"><code><a name="GdkPixbufFormat.flags"></a>flags</code></em>;</span></p></td>
513
+ <td>a combination of <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormatFlags" title="enum GdkPixbufFormatFlags"><span class="type">GdkPixbufFormatFlags</span></a>.</td>
514
+ </tr>
515
+ <tr>
516
+ <td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="GdkPixbufFormat.disabled"></a>disabled</code></em>;</span></p></td>
517
+ <td>a boolean determining whether the loader is disabled.</td>
518
+ </tr>
519
+ <tr>
520
+ <td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GdkPixbufFormat.license"></a>license</code></em>;</span></p></td>
521
+ <td>a string containing license information, typically set to
522
+ shorthands like "GPL", "LGPL", etc.</td>
523
+ </tr>
524
+ </tbody>
525
+ </table></div>
526
+ <p class="since">Since 2.2</p>
447
527
  </div>
448
528
  <hr>
449
- <div class="refsect2" title="enum GdkPixbufFormatFlags">
529
+ <div class="refsect2">
450
530
  <a name="GdkPixbufFormatFlags"></a><h3>enum GdkPixbufFormatFlags</h3>
451
531
  <pre class="programlisting">typedef enum /*&lt; skip &gt;*/
452
532
  {
@@ -456,159 +536,259 @@ string should be freed with <a href="http://library.gnome.org/devel/glib/unstabl
456
536
  } GdkPixbufFormatFlags;
457
537
  </pre>
458
538
  <p>
539
+ Flags which allow a module to specify further details about the supported
540
+ operations.
459
541
  </p>
542
+ <div class="variablelist"><table border="0">
543
+ <col align="left" valign="top">
544
+ <tbody>
545
+ <tr>
546
+ <td><p><a name="GDK-PIXBUF-FORMAT-WRITABLE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_WRITABLE</code></span></p></td>
547
+ <td>the module can write out images in the format.
548
+ </td>
549
+ </tr>
550
+ <tr>
551
+ <td><p><a name="GDK-PIXBUF-FORMAT-SCALABLE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_SCALABLE</code></span></p></td>
552
+ <td>the image format is scalable
553
+ </td>
554
+ </tr>
555
+ <tr>
556
+ <td><p><a name="GDK-PIXBUF-FORMAT-THREADSAFE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_FORMAT_THREADSAFE</code></span></p></td>
557
+ <td>the module is threadsafe. If this flag is not
558
+ set, &amp;gdk-pixbuf; will use a lock to prevent multiple threads from using
559
+ this module at the same time. (Since 2.6)
560
+ </td>
561
+ </tr>
562
+ </tbody>
563
+ </table></div>
564
+ <p class="since">Since 2.2</p>
460
565
  </div>
461
566
  <hr>
462
- <div class="refsect2" title="GdkPixbufModulePattern">
463
- <a name="GdkPixbufModulePattern"></a><h3>GdkPixbufModulePattern</h3>
464
- <pre class="programlisting">typedef struct {
567
+ <div class="refsect2">
568
+ <a name="GdkPixbufModulePattern"></a><h3>struct GdkPixbufModulePattern</h3>
569
+ <pre class="programlisting">struct GdkPixbufModulePattern {
465
570
  char *prefix;
466
571
  char *mask;
467
572
  int relevance;
468
- } GdkPixbufModulePattern;
573
+ };
574
+ </pre>
575
+ <p>
576
+ The signature of a module is a set of prefixes. Prefixes are encoded as
577
+ pairs of ordinary strings, where the second string, called the mask, if
578
+ not <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, must be of the same length as the first one and may contain
579
+ ' ', '!', 'x', 'z', and 'n' to indicate bytes that must be matched,
580
+ not matched, "don't-care"-bytes, zeros and non-zeros.
581
+ Each prefix has an associated integer that describes the relevance of
582
+ the prefix, with 0 meaning a mismatch and 100 a "perfect match".
583
+ </p>
584
+ <p>
585
+ Starting with &amp;gdk-pixbuf; 2.8, the first byte of the mask may be '*',
586
+ indicating an unanchored pattern that matches not only at the beginning,
587
+ but also in the middle. Versions prior to 2.8 will interpret the '*'
588
+ like an 'x'.
589
+ </p>
590
+ <p>
591
+ The signature of a module is stored as an array of
592
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModulePattern" title="struct GdkPixbufModulePattern"><span class="type">GdkPixbufModulePattern</span></a>s. The array is terminated by a pattern
593
+ where the <em class="parameter"><code>prefix</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
594
+ </p>
595
+ <p>
596
+ </p>
597
+ <div class="informalexample">
598
+ <pre class="programlisting">
599
+ GdkPixbufModulePattern *signature[] = {
600
+ { "abcdx", " !x z", 100 },
601
+ { "bla", NULL, 90 },
602
+ { NULL, NULL, 0 }
603
+ };
469
604
  </pre>
605
+ The example matches e.g. "auud\0" with relevance 100, and "blau" with
606
+ relevance 90.</div>
470
607
  <p>
471
608
  </p>
609
+ <div class="variablelist"><table border="0">
610
+ <col align="left" valign="top">
611
+ <tbody>
612
+ <tr>
613
+ <td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModulePattern.prefix"></a>prefix</code></em>;</span></p></td>
614
+ <td>the prefix for this pattern</td>
615
+ </tr>
616
+ <tr>
617
+ <td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModulePattern.mask"></a>mask</code></em>;</span></p></td>
618
+ <td>mask containing bytes which modify how the prefix is matched against
619
+ test data</td>
620
+ </tr>
621
+ <tr>
622
+ <td><p><span class="term"><span class="type">int</span> <em class="structfield"><code><a name="GdkPixbufModulePattern.relevance"></a>relevance</code></em>;</span></p></td>
623
+ <td>relevance of this pattern</td>
624
+ </tr>
625
+ </tbody>
626
+ </table></div>
627
+ <p class="since">Since 2.2</p>
472
628
  </div>
473
629
  <hr>
474
- <div class="refsect2" title="GdkPixbufModuleFillVtableFunc ()">
630
+ <div class="refsect2">
475
631
  <a name="GdkPixbufModuleFillVtableFunc"></a><h3>GdkPixbufModuleFillVtableFunc ()</h3>
476
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillVtableFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>);</pre>
632
+ <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillVtableFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> *module</code></em>);</pre>
477
633
  <p>
634
+ Defines the type of the function used to set the vtable of a
635
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> when it is loaded.
478
636
  </p>
479
637
  <div class="variablelist"><table border="0">
480
638
  <col align="left" valign="top">
481
639
  <tbody><tr>
482
640
  <td><p><span class="term"><em class="parameter"><code>module</code></em> :</span></p></td>
483
- <td>
484
- </td>
641
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>.</td>
485
642
  </tr></tbody>
486
643
  </table></div>
644
+ <p class="since">Since 2.2</p>
487
645
  </div>
488
646
  <hr>
489
- <div class="refsect2" title="GdkPixbufModuleFillInfoFunc ()">
647
+ <div class="refsect2">
490
648
  <a name="GdkPixbufModuleFillInfoFunc"></a><h3>GdkPixbufModuleFillInfoFunc ()</h3>
491
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillInfoFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>);</pre>
649
+ <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleFillInfoFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *info</code></em>);</pre>
492
650
  <p>
651
+ Defines the type of the function used to fill a
652
+ <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> structure with information about a module.
493
653
  </p>
494
654
  <div class="variablelist"><table border="0">
495
655
  <col align="left" valign="top">
496
656
  <tbody><tr>
497
657
  <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
498
- <td>
499
- </td>
658
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a>.</td>
500
659
  </tr></tbody>
501
660
  </table></div>
661
+ <p class="since">Since 2.2</p>
502
662
  </div>
503
663
  <hr>
504
- <div class="refsect2" title="GdkPixbufModuleSizeFunc ()">
664
+ <div class="refsect2">
505
665
  <a name="GdkPixbufModuleSizeFunc"></a><h3>GdkPixbufModuleSizeFunc ()</h3>
506
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleSizeFunc) (<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>,
507
- <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>,
508
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
666
+ <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleSizeFunc) (<em class="parameter"><code><span class="type">gint</span> *width</code></em>,
667
+ <em class="parameter"><code><span class="type">gint</span> *height</code></em>,
668
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
509
669
  <p>
670
+ Defines the type of the function that gets called once the size
671
+ of the loaded image is known.
672
+ </p>
673
+ <p>
674
+ The function is expected to set <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> to the desired
675
+ size to which the image should be scaled. If a module has no efficient
676
+ way to achieve the desired scaling during the loading of the image, it may
677
+ either ignore the size request, or only approximate it -- &amp;gdk-pixbuf; will
678
+ then perform the required scaling on the completely loaded image.
679
+ </p>
680
+ <p>
681
+ If the function sets <em class="parameter"><code>width</code></em> or <em class="parameter"><code>height</code></em> to zero, the module should interpret
682
+ this as a hint that it will be closed soon and shouldn't allocate further
683
+ resources. This convention is used to implement <a class="link" href="gdk-pixbuf-File-Loading.html#gdk-pixbuf-get-file-info" title="gdk_pixbuf_get_file_info ()"><code class="function">gdk_pixbuf_get_file_info()</code></a>
684
+ efficiently.
510
685
  </p>
511
686
  <div class="variablelist"><table border="0">
512
687
  <col align="left" valign="top">
513
688
  <tbody>
514
689
  <tr>
515
690
  <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
516
- <td>
517
- </td>
691
+ <td>pointer to a location containing the current image width</td>
518
692
  </tr>
519
693
  <tr>
520
694
  <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
521
- <td>
522
- </td>
695
+ <td>pointer to a location containing the current image height</td>
523
696
  </tr>
524
697
  <tr>
525
698
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
526
- <td>
527
- </td>
699
+ <td>the loader.</td>
528
700
  </tr>
529
701
  </tbody>
530
702
  </table></div>
703
+ <p class="since">Since 2.2</p>
531
704
  </div>
532
705
  <hr>
533
- <div class="refsect2" title="GdkPixbufModulePreparedFunc ()">
706
+ <div class="refsect2">
534
707
  <a name="GdkPixbufModulePreparedFunc"></a><h3>GdkPixbufModulePreparedFunc ()</h3>
535
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModulePreparedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
536
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-animation.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>,
537
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
708
+ <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModulePreparedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
709
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a> *anim</code></em>,
710
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
711
+ <p>
712
+ Defines the type of the function that gets called once the initial
713
+ setup of <em class="parameter"><code>pixbuf</code></em> is done.
714
+ </p>
538
715
  <p>
716
+ <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> uses a function of this type to emit the
717
+ "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-prepared" title='The "area-prepared" signal'>area_prepared</a>"
718
+ signal.
539
719
  </p>
540
720
  <div class="variablelist"><table border="0">
541
721
  <col align="left" valign="top">
542
722
  <tbody>
543
723
  <tr>
544
724
  <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
545
- <td>
546
- </td>
725
+ <td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that is currently being loaded.</td>
547
726
  </tr>
548
727
  <tr>
549
728
  <td><p><span class="term"><em class="parameter"><code>anim</code></em> :</span></p></td>
550
- <td>
551
- </td>
729
+ <td>if an animation is being loaded, the <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a>, else <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
552
730
  </tr>
553
731
  <tr>
554
732
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
555
- <td>
556
- </td>
733
+ <td>the loader.</td>
557
734
  </tr>
558
735
  </tbody>
559
736
  </table></div>
737
+ <p class="since">Since 2.2</p>
560
738
  </div>
561
739
  <hr>
562
- <div class="refsect2" title="GdkPixbufModuleUpdatedFunc ()">
740
+ <div class="refsect2">
563
741
  <a name="GdkPixbufModuleUpdatedFunc"></a><h3>GdkPixbufModuleUpdatedFunc ()</h3>
564
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleUpdatedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
742
+ <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufModuleUpdatedFunc) (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
565
743
  <em class="parameter"><code><span class="type">int</span> x</code></em>,
566
744
  <em class="parameter"><code><span class="type">int</span> y</code></em>,
567
745
  <em class="parameter"><code><span class="type">int</span> width</code></em>,
568
746
  <em class="parameter"><code><span class="type">int</span> height</code></em>,
569
- <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
747
+ <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
748
+ <p>
749
+ Defines the type of the function that gets called every time a region
750
+ of <em class="parameter"><code>pixbuf</code></em> is updated.
751
+ </p>
570
752
  <p>
753
+ <a class="link" href="GdkPixbufLoader.html" title="GdkPixbufLoader"><span class="type">GdkPixbufLoader</span></a> uses a function of this type to emit the
754
+ "<a class="link" href="GdkPixbufLoader.html#GdkPixbufLoader-area-updated" title='The "area-updated" signal'>area_updated</a>"
755
+ signal.
571
756
  </p>
572
757
  <div class="variablelist"><table border="0">
573
758
  <col align="left" valign="top">
574
759
  <tbody>
575
760
  <tr>
576
761
  <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
577
- <td>
578
- </td>
762
+ <td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> that is currently being loaded.</td>
579
763
  </tr>
580
764
  <tr>
581
765
  <td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
582
- <td>
583
- </td>
766
+ <td>the X origin of the updated area.</td>
584
767
  </tr>
585
768
  <tr>
586
769
  <td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
587
- <td>
588
- </td>
770
+ <td>the Y origin of the updated area.</td>
589
771
  </tr>
590
772
  <tr>
591
773
  <td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
592
- <td>
593
- </td>
774
+ <td>the width of the updated area.</td>
594
775
  </tr>
595
776
  <tr>
596
777
  <td><p><span class="term"><em class="parameter"><code>height</code></em> :</span></p></td>
597
- <td>
598
- </td>
778
+ <td>the height of the updated area.</td>
599
779
  </tr>
600
780
  <tr>
601
781
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
602
- <td>
603
- </td>
782
+ <td>the loader.</td>
604
783
  </tr>
605
784
  </tbody>
606
785
  </table></div>
786
+ <p class="since">Since 2.2</p>
607
787
  </div>
608
788
  <hr>
609
- <div class="refsect2" title="GdkPixbufModule">
610
- <a name="GdkPixbufModule"></a><h3>GdkPixbufModule</h3>
611
- <pre class="programlisting">typedef struct {
789
+ <div class="refsect2">
790
+ <a name="GdkPixbufModule"></a><h3>struct GdkPixbufModule</h3>
791
+ <pre class="programlisting">struct GdkPixbufModule {
612
792
  char *module_name;
613
793
  char *module_path;
614
794
  GModule *module;
@@ -649,15 +829,77 @@ string should be freed with <a href="http://library.gnome.org/devel/glib/unstabl
649
829
  gchar **option_keys,
650
830
  gchar **option_values,
651
831
  GError **error);
652
- } GdkPixbufModule;
832
+ };
653
833
  </pre>
654
834
  <p>
835
+ A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> contains the necessary functions to load and save
836
+ images in a certain file format.
837
+ </p>
838
+ <p>
839
+ A <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a> can be loaded dynamically from a <span class="type">GModule</span>.
840
+ Each loadable module must contain a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModuleFillVtableFunc" title="GdkPixbufModuleFillVtableFunc ()"><span class="type">GdkPixbufModuleFillVtableFunc</span></a> function
841
+ named <code class="function">fill_vtable</code>, which will get called when the module
842
+ is loaded and must set the function pointers of the <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufModule" title="struct GdkPixbufModule"><span class="type">GdkPixbufModule</span></a>.
655
843
  </p>
844
+ <div class="variablelist"><table border="0">
845
+ <col align="left" valign="top">
846
+ <tbody>
847
+ <tr>
848
+ <td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModule.module-name"></a>module_name</code></em>;</span></p></td>
849
+ <td>the name of the module, usually the same as the
850
+ usual file extension for images of this type, eg. "xpm", "jpeg" or "png".</td>
851
+ </tr>
852
+ <tr>
853
+ <td><p><span class="term"><span class="type">char</span> *<em class="structfield"><code><a name="GdkPixbufModule.module-path"></a>module_path</code></em>;</span></p></td>
854
+ <td>the path from which the module is loaded.</td>
855
+ </tr>
856
+ <tr>
857
+ <td><p><span class="term"><span class="type">GModule</span> *<em class="structfield"><code><a name="GdkPixbufModule.module"></a>module</code></em>;</span></p></td>
858
+ <td>the loaded <span class="type">GModule</span>.</td>
859
+ </tr>
860
+ <tr>
861
+ <td><p><span class="term"><a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> *<em class="structfield"><code><a name="GdkPixbufModule.info"></a>info</code></em>;</span></p></td>
862
+ <td>a <a class="link" href="gdk-pixbuf-Module-Interface.html#GdkPixbufFormat" title="struct GdkPixbufFormat"><span class="type">GdkPixbufFormat</span></a> holding information about the module.</td>
863
+ </tr>
864
+ <tr>
865
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load"></a>load</code></em> ()</span></p></td>
866
+ <td>loads an image from a file.</td>
867
+ </tr>
868
+ <tr>
869
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-xpm-data"></a>load_xpm_data</code></em> ()</span></p></td>
870
+ <td>loads an image from data in memory.</td>
871
+ </tr>
872
+ <tr>
873
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.begin-load"></a>begin_load</code></em> ()</span></p></td>
874
+ <td>begins an incremental load.</td>
875
+ </tr>
876
+ <tr>
877
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.stop-load"></a>stop_load</code></em> ()</span></p></td>
878
+ <td>stops an incremental load.</td>
879
+ </tr>
880
+ <tr>
881
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-increment"></a>load_increment</code></em> ()</span></p></td>
882
+ <td>continues an incremental load.</td>
883
+ </tr>
884
+ <tr>
885
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.load-animation"></a>load_animation</code></em> ()</span></p></td>
886
+ <td>loads an animation from a file.</td>
887
+ </tr>
888
+ <tr>
889
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.save"></a>save</code></em> ()</span></p></td>
890
+ <td>saves a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> to a file.</td>
891
+ </tr>
892
+ <tr>
893
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufModule.save-to-callback"></a>save_to_callback</code></em> ()</span></p></td>
894
+ <td>saves a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> by calling the given <a class="link" href="gdk-pixbuf-File-saving.html#GdkPixbufSaveFunc" title="GdkPixbufSaveFunc ()"><span class="type">GdkPixbufSaveFunc</span></a>.</td>
895
+ </tr>
896
+ </tbody>
897
+ </table></div>
656
898
  </div>
657
899
  <hr>
658
- <div class="refsect2" title="GdkPixbufAnimationClass">
659
- <a name="GdkPixbufAnimationClass"></a><h3>GdkPixbufAnimationClass</h3>
660
- <pre class="programlisting">typedef struct {
900
+ <div class="refsect2">
901
+ <a name="GdkPixbufAnimationClass"></a><h3>struct GdkPixbufAnimationClass</h3>
902
+ <pre class="programlisting">struct GdkPixbufAnimationClass {
661
903
  GObjectClass parent_class;
662
904
 
663
905
 
@@ -671,15 +913,43 @@ string should be freed with <a href="http://library.gnome.org/devel/glib/unstabl
671
913
 
672
914
  GdkPixbufAnimationIter* (*get_iter) (GdkPixbufAnimation *anim,
673
915
  const GTimeVal *start_time);
674
- } GdkPixbufAnimationClass;
916
+ };
675
917
  </pre>
676
918
  <p>
919
+ Modules supporting animations must derive a type from
920
+ <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimation"><span class="type">GdkPixbufAnimation</span></a>, providing suitable implementations of the
921
+ virtual functions.
677
922
  </p>
923
+ <div class="variablelist"><table border="0">
924
+ <col align="left" valign="top">
925
+ <tbody>
926
+ <tr>
927
+ <td><p><span class="term"><span class="type">GObjectClass</span> <em class="structfield"><code><a name="GdkPixbufAnimationClass.parent-class"></a>parent_class</code></em>;</span></p></td>
928
+ <td>the parent class</td>
929
+ </tr>
930
+ <tr>
931
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.is-static-image"></a>is_static_image</code></em> ()</span></p></td>
932
+ <td>returns whether the given animation is just a static image.</td>
933
+ </tr>
934
+ <tr>
935
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-static-image"></a>get_static_image</code></em> ()</span></p></td>
936
+ <td>returns a static image representing the given animation.</td>
937
+ </tr>
938
+ <tr>
939
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-size"></a>get_size</code></em> ()</span></p></td>
940
+ <td>fills <em class="parameter"><code>width</code></em> and <em class="parameter"><code>height</code></em> with the frame size of the animation.</td>
941
+ </tr>
942
+ <tr>
943
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationClass.get-iter"></a>get_iter</code></em> ()</span></p></td>
944
+ <td>returns an iterator for the given animation.</td>
945
+ </tr>
946
+ </tbody>
947
+ </table></div>
678
948
  </div>
679
949
  <hr>
680
- <div class="refsect2" title="GdkPixbufAnimationIterClass">
681
- <a name="GdkPixbufAnimationIterClass"></a><h3>GdkPixbufAnimationIterClass</h3>
682
- <pre class="programlisting">typedef struct {
950
+ <div class="refsect2">
951
+ <a name="GdkPixbufAnimationIterClass"></a><h3>struct GdkPixbufAnimationIterClass</h3>
952
+ <pre class="programlisting">struct GdkPixbufAnimationIterClass {
683
953
  GObjectClass parent_class;
684
954
 
685
955
 
@@ -691,15 +961,46 @@ string should be freed with <a href="http://library.gnome.org/devel/glib/unstabl
691
961
 
692
962
  gboolean (*advance) (GdkPixbufAnimationIter *iter,
693
963
  const GTimeVal *current_time);
694
- } GdkPixbufAnimationIterClass;
964
+ };
695
965
  </pre>
696
966
  <p>
967
+ Modules supporting animations must derive a type from
968
+ <a class="link" href="gdk-pixbuf-Animations.html#GdkPixbufAnimationIter"><span class="type">GdkPixbufAnimationIter</span></a>, providing suitable implementations of the
969
+ virtual functions.
697
970
  </p>
971
+ <div class="variablelist"><table border="0">
972
+ <col align="left" valign="top">
973
+ <tbody>
974
+ <tr>
975
+ <td><p><span class="term"><span class="type">GObjectClass</span> <em class="structfield"><code><a name="GdkPixbufAnimationIterClass.parent-class"></a>parent_class</code></em>;</span></p></td>
976
+ <td>the parent class</td>
977
+ </tr>
978
+ <tr>
979
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.get-delay-time"></a>get_delay_time</code></em> ()</span></p></td>
980
+ <td>returns the time in milliseconds that the current frame
981
+ should be shown.</td>
982
+ </tr>
983
+ <tr>
984
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.get-pixbuf"></a>get_pixbuf</code></em> ()</span></p></td>
985
+ <td>returns the current frame.</td>
986
+ </tr>
987
+ <tr>
988
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.on-currently-loading-frame"></a>on_currently_loading_frame</code></em> ()</span></p></td>
989
+ <td>returns whether the current frame of <em class="parameter"><code>iter</code></em> is
990
+ being loaded.</td>
991
+ </tr>
992
+ <tr>
993
+ <td><p><span class="term"><em class="structfield"><code><a name="GdkPixbufAnimationIterClass.advance"></a>advance</code></em> ()</span></p></td>
994
+ <td>advances the iterator to <em class="parameter"><code>current_time</code></em>, possibly changing the
995
+ current frame.</td>
996
+ </tr>
997
+ </tbody>
998
+ </table></div>
698
999
  </div>
699
1000
  </div>
700
1001
  </div>
701
1002
  <div class="footer">
702
1003
  <hr>
703
- Generated by GTK-Doc V1.15</div>
1004
+ Generated by GTK-Doc V1.17.1</div>
704
1005
  </body>
705
1006
  </html>