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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. data/ext/gdk_pixbuf2/rbgdk-pixbuf-format.c +49 -40
  2. data/ext/gdk_pixbuf2/rbgdk-pixbuf-loader.c +50 -40
  3. data/ext/gdk_pixbuf2/rbgdk-pixbuf.c +250 -168
  4. data/ext/gdk_pixbuf2/rbgdk-pixbuf.h +25 -18
  5. data/ext/gdk_pixbuf2/rbgdk-pixbuf2conversions.h +42 -0
  6. data/ext/gdk_pixbuf2/rbgdk-pixbuf2private.h +35 -0
  7. data/ext/gdk_pixbuf2/rbgdk-pixbufanimation.c +46 -83
  8. data/ext/gdk_pixbuf2/rbgdk-pixbufanimationiter.c +71 -0
  9. data/ext/gdk_pixbuf2/rbgdk-pixbufsimpleanim.c +29 -17
  10. data/ext/gdk_pixbuf2/rbgdk-pixdata.c +81 -77
  11. data/lib/1.8/gdk_pixbuf2.so +0 -0
  12. data/lib/1.9/gdk_pixbuf2.so +0 -0
  13. data/vendor/local/bin/gdk-pixbuf-csource.exe +0 -0
  14. data/vendor/local/bin/gdk-pixbuf-query-loaders.exe +0 -0
  15. data/vendor/local/bin/libgdk_pixbuf-2.0-0.dll +0 -0
  16. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-animation.h +40 -0
  17. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-core.h +200 -5
  18. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-features.h +82 -3
  19. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-io.h +170 -0
  20. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-loader.h +6 -1
  21. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-simple-anim.h +5 -0
  22. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-transform.h +42 -1
  23. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache +2 -2
  24. data/vendor/local/lib/gdk_pixbuf-2.0.lib +0 -0
  25. data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
  26. data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +4 -2
  27. data/vendor/local/manifest/{gdk-pixbuf-dev_2.22.1-1_win32.mft → gdk-pixbuf-dev_2.24.0-1_win32.mft} +12 -13
  28. data/vendor/local/manifest/{gdk-pixbuf_2.22.1-1_win32.mft → gdk-pixbuf_2.24.0-1_win32.mft} +2 -1
  29. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +181 -150
  30. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/annotation-glossary.html +30 -9
  31. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-10.html +3 -3
  32. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-12.html +4 -4
  33. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-14.html +6 -6
  34. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-2.html +35 -3
  35. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-4.html +13 -9
  36. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-6.html +6 -6
  37. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-8.html +5 -5
  38. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-deprecated.html +7 -7
  39. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-full.html +251 -629
  40. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +644 -0
  41. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +372 -0
  42. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +642 -0
  43. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +417 -0
  44. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +495 -0
  45. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +485 -184
  46. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +168 -0
  47. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/{gdk-pixbuf-scaling.html → gdk-pixbuf-Scaling.html} +296 -190
  48. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +617 -0
  49. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/{gdk-pixbuf-util.html → gdk-pixbuf-Utilities.html} +83 -93
  50. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Versioning.html +63 -26
  51. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-csource.html +16 -16
  52. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-from-drawables.html +8 -8
  53. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-rendering.html +8 -8
  54. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-query-loaders.html +12 -12
  55. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf.devhelp2 +149 -128
  56. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.html +18 -18
  57. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.sgml +184 -154
  58. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/license.html +3 -3
  59. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn01.html +18 -18
  60. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn02.html +5 -5
  61. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/style.css +2 -1
  62. data/vendor/local/share/locale/af/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  63. data/vendor/local/share/locale/ang/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  64. data/vendor/local/share/locale/ar/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  65. data/vendor/local/share/locale/as/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  66. data/vendor/local/share/locale/ast/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  67. data/vendor/local/share/locale/az/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  68. data/vendor/local/share/locale/be/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  69. data/vendor/local/share/locale/be@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  70. data/vendor/local/share/locale/bg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  71. data/vendor/local/share/locale/bn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  72. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  73. data/vendor/local/share/locale/br/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  74. data/vendor/local/share/locale/bs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  75. data/vendor/local/share/locale/ca/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  76. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  77. data/vendor/local/share/locale/crh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  78. data/vendor/local/share/locale/cs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  79. data/vendor/local/share/locale/cy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  80. data/vendor/local/share/locale/da/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  81. data/vendor/local/share/locale/de/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  82. data/vendor/local/share/locale/dz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  83. data/vendor/local/share/locale/el/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  84. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  85. data/vendor/local/share/locale/en_CA/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  86. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  87. data/vendor/local/share/locale/eo/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  88. data/vendor/local/share/locale/es/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  89. data/vendor/local/share/locale/et/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  90. data/vendor/local/share/locale/eu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  91. data/vendor/local/share/locale/fa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  92. data/vendor/local/share/locale/fi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  93. data/vendor/local/share/locale/fr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  94. data/vendor/local/share/locale/ga/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  95. data/vendor/local/share/locale/gl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  96. data/vendor/local/share/locale/gu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  97. data/vendor/local/share/locale/he/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  98. data/vendor/local/share/locale/hi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  99. data/vendor/local/share/locale/hr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  100. data/vendor/local/share/locale/hu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  101. data/vendor/local/share/locale/hy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  102. data/vendor/local/share/locale/ia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  103. data/vendor/local/share/locale/id/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  104. data/vendor/local/share/locale/io/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  105. data/vendor/local/share/locale/is/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  106. data/vendor/local/share/locale/it/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  107. data/vendor/local/share/locale/ja/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  108. data/vendor/local/share/locale/ka/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  109. data/vendor/local/share/locale/kn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  110. data/vendor/local/share/locale/ko/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  111. data/vendor/local/share/locale/ku/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  112. data/vendor/local/share/locale/li/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  113. data/vendor/local/share/locale/lt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  114. data/vendor/local/share/locale/lv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  115. data/vendor/local/share/locale/mai/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  116. data/vendor/local/share/locale/mi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  117. data/vendor/local/share/locale/mk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  118. data/vendor/local/share/locale/ml/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  119. data/vendor/local/share/locale/mn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  120. data/vendor/local/share/locale/mr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  121. data/vendor/local/share/locale/ms/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  122. data/vendor/local/share/locale/my/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  123. data/vendor/local/share/locale/nb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  124. data/vendor/local/share/locale/nds/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  125. data/vendor/local/share/locale/ne/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  126. data/vendor/local/share/locale/nl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  127. data/vendor/local/share/locale/nn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  128. data/vendor/local/share/locale/nso/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  129. data/vendor/local/share/locale/oc/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  130. data/vendor/local/share/locale/or/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  131. data/vendor/local/share/locale/pa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  132. data/vendor/local/share/locale/pl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  133. data/vendor/local/share/locale/ps/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  134. data/vendor/local/share/locale/pt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  135. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  136. data/vendor/local/share/locale/ro/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  137. data/vendor/local/share/locale/ru/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  138. data/vendor/local/share/locale/si/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  139. data/vendor/local/share/locale/sk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  140. data/vendor/local/share/locale/sl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  141. data/vendor/local/share/locale/sq/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  142. data/vendor/local/share/locale/sr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  143. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  144. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  145. data/vendor/local/share/locale/sv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  146. data/vendor/local/share/locale/ta/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  147. data/vendor/local/share/locale/te/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  148. data/vendor/local/share/locale/th/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  149. data/vendor/local/share/locale/tk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  150. data/vendor/local/share/locale/tr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  151. data/vendor/local/share/locale/tt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  152. data/vendor/local/share/locale/ug/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  153. data/vendor/local/share/locale/uk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  154. data/vendor/local/share/locale/uz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  155. data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  156. data/vendor/local/share/locale/vi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  157. data/vendor/local/share/locale/wa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  158. data/vendor/local/share/locale/xh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  159. data/vendor/local/share/locale/yi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  160. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  161. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  162. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  163. data/vendor/local/share/man/man1/gdk-pixbuf-csource.1 +2 -2
  164. data/vendor/local/share/man/man1/gdk-pixbuf-query-loaders.1 +2 -2
  165. data/vendor/local/src/dieterv/packaging/gdk-pixbuf_2.24.0-1_win32.log +956 -0
  166. data/vendor/local/src/dieterv/packaging/gdk-pixbuf_2.24.0-1_win32.sh +97 -0
  167. metadata +26 -24
  168. data/ChangeLog +0 -482
  169. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-animation.html +0 -654
  170. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-creating.html +0 -406
  171. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-file-loading.html +0 -402
  172. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-file-saving.html +0 -685
  173. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html +0 -460
  174. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-inline.html +0 -516
  175. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-refcounting.html +0 -132
  176. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf.devhelp +0 -175
  177. data/vendor/local/src/tml/packaging/gdk-pixbuf_2.22.1-1_win32.log +0 -1012
  178. data/vendor/local/src/tml/packaging/gdk-pixbuf_2.22.1-1_win32.sh +0 -256
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>