gdk_pixbuf2 2.1.0-x86-mingw32 → 2.2.0-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (173) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +1 -1
  3. data/lib/1.9/gdk_pixbuf2.so +0 -0
  4. data/lib/2.0/gdk_pixbuf2.so +0 -0
  5. data/lib/2.1/gdk_pixbuf2.so +0 -0
  6. data/vendor/local/bin/gdk-pixbuf-csource.exe +0 -0
  7. data/vendor/local/bin/gdk-pixbuf-pixdata.exe +0 -0
  8. data/vendor/local/bin/gdk-pixbuf-query-loaders.exe +0 -0
  9. data/vendor/local/bin/libgdk_pixbuf-2.0-0.dll +0 -0
  10. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-animation.h +1 -3
  11. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-core.h +1 -3
  12. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-features.h +2 -2
  13. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-io.h +1 -3
  14. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-loader.h +1 -3
  15. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-simple-anim.h +1 -3
  16. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-transform.h +1 -3
  17. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf.h +1 -3
  18. data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixdata.h +1 -3
  19. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache +1 -1
  20. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.a +0 -0
  21. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll +0 -0
  22. data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll.a +0 -0
  23. data/vendor/local/lib/girepository-1.0/GdkPixbuf-2.0.typelib +0 -0
  24. data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
  25. data/vendor/local/lib/libgdk_pixbuf-2.0.la +1 -1
  26. data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +1 -1
  27. data/vendor/local/share/gir-1.0/GdkPixbuf-2.0.gir +30 -27
  28. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +557 -416
  29. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/annotation-glossary.html +10 -12
  30. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-12.html +5 -5
  31. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-14.html +9 -11
  32. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-2.html +22 -24
  33. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-26.html +10 -12
  34. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-28.html +8 -8
  35. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-30.html +5 -5
  36. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-4.html +16 -18
  37. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-6.html +14 -16
  38. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-2-8.html +6 -6
  39. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-deprecated.html +11 -13
  40. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-full.html +165 -167
  41. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +768 -578
  42. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +546 -428
  43. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +549 -474
  44. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +321 -265
  45. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +467 -349
  46. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +887 -662
  47. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +122 -91
  48. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Scaling.html +656 -518
  49. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +631 -484
  50. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Utilities.html +247 -171
  51. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Versioning.html +110 -89
  52. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html +119 -98
  53. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Xlib-Rendering.html +275 -230
  54. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-XlibRGB.html +784 -581
  55. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-csource.html +5 -5
  56. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-Xlib-initialization.html +86 -55
  57. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-from-drawables.html +5 -5
  58. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf-rendering.html +5 -5
  59. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-query-loaders.html +5 -5
  60. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf.devhelp2 +153 -192
  61. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.html +3 -3
  62. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.sgml +98 -97
  63. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/license.html +4 -4
  64. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn01.html +4 -4
  65. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn02.html +4 -4
  66. data/vendor/local/share/gtk-doc/html/gdk-pixbuf/style.css +247 -94
  67. data/vendor/local/share/locale/af/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  68. data/vendor/local/share/locale/ang/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  69. data/vendor/local/share/locale/ar/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  70. data/vendor/local/share/locale/as/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  71. data/vendor/local/share/locale/ast/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  72. data/vendor/local/share/locale/az/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  73. data/vendor/local/share/locale/be/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  74. data/vendor/local/share/locale/be@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  75. data/vendor/local/share/locale/bg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  76. data/vendor/local/share/locale/bn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  77. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  78. data/vendor/local/share/locale/br/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  79. data/vendor/local/share/locale/bs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  80. data/vendor/local/share/locale/ca/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  81. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  82. data/vendor/local/share/locale/crh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  83. data/vendor/local/share/locale/cs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  84. data/vendor/local/share/locale/csb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  85. data/vendor/local/share/locale/cy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  86. data/vendor/local/share/locale/da/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  87. data/vendor/local/share/locale/de/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  88. data/vendor/local/share/locale/dz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  89. data/vendor/local/share/locale/el/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  90. data/vendor/local/share/locale/en@shaw/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  91. data/vendor/local/share/locale/en_CA/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  92. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  93. data/vendor/local/share/locale/eo/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  94. data/vendor/local/share/locale/es/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  95. data/vendor/local/share/locale/et/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  96. data/vendor/local/share/locale/eu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  97. data/vendor/local/share/locale/fa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  98. data/vendor/local/share/locale/fi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  99. data/vendor/local/share/locale/fr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  100. data/vendor/local/share/locale/ga/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  101. data/vendor/local/share/locale/gl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  102. data/vendor/local/share/locale/gu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  103. data/vendor/local/share/locale/he/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  104. data/vendor/local/share/locale/hi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  105. data/vendor/local/share/locale/hr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  106. data/vendor/local/share/locale/hu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  107. data/vendor/local/share/locale/hy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  108. data/vendor/local/share/locale/ia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  109. data/vendor/local/share/locale/id/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  110. data/vendor/local/share/locale/io/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  111. data/vendor/local/share/locale/is/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  112. data/vendor/local/share/locale/it/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  113. data/vendor/local/share/locale/ja/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  114. data/vendor/local/share/locale/ka/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  115. data/vendor/local/share/locale/km/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  116. data/vendor/local/share/locale/kn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  117. data/vendor/local/share/locale/ko/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  118. data/vendor/local/share/locale/ku/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  119. data/vendor/local/share/locale/li/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  120. data/vendor/local/share/locale/lt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  121. data/vendor/local/share/locale/lv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  122. data/vendor/local/share/locale/mai/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  123. data/vendor/local/share/locale/mi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  124. data/vendor/local/share/locale/mk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  125. data/vendor/local/share/locale/ml/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  126. data/vendor/local/share/locale/mn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  127. data/vendor/local/share/locale/mr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  128. data/vendor/local/share/locale/ms/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  129. data/vendor/local/share/locale/my/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  130. data/vendor/local/share/locale/nb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  131. data/vendor/local/share/locale/nds/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  132. data/vendor/local/share/locale/ne/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  133. data/vendor/local/share/locale/nl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  134. data/vendor/local/share/locale/nn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  135. data/vendor/local/share/locale/nso/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  136. data/vendor/local/share/locale/oc/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  137. data/vendor/local/share/locale/or/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  138. data/vendor/local/share/locale/pa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  139. data/vendor/local/share/locale/pl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  140. data/vendor/local/share/locale/ps/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  141. data/vendor/local/share/locale/pt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  142. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  143. data/vendor/local/share/locale/ro/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  144. data/vendor/local/share/locale/ru/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  145. data/vendor/local/share/locale/si/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  146. data/vendor/local/share/locale/sk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  147. data/vendor/local/share/locale/sl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  148. data/vendor/local/share/locale/sq/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  149. data/vendor/local/share/locale/sr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  150. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  151. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  152. data/vendor/local/share/locale/sv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  153. data/vendor/local/share/locale/ta/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  154. data/vendor/local/share/locale/te/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  155. data/vendor/local/share/locale/tg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  156. data/vendor/local/share/locale/th/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  157. data/vendor/local/share/locale/tk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  158. data/vendor/local/share/locale/tr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  159. data/vendor/local/share/locale/tt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  160. data/vendor/local/share/locale/ug/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  161. data/vendor/local/share/locale/uk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  162. data/vendor/local/share/locale/uz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  163. data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  164. data/vendor/local/share/locale/vi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  165. data/vendor/local/share/locale/wa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  166. data/vendor/local/share/locale/xh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  167. data/vendor/local/share/locale/yi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  168. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  169. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  170. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gdk-pixbuf.mo +0 -0
  171. data/vendor/local/share/man/man1/gdk-pixbuf-csource.1 +1 -1
  172. data/vendor/local/share/man/man1/gdk-pixbuf-query-loaders.1 +1 -1
  173. metadata +4 -4
@@ -8,15 +8,14 @@
8
8
  <link rel="up" href="rn01.html" title="API Reference">
9
9
  <link rel="prev" href="gdk-pixbuf-The-GdkPixbuf-Structure.html" title="The GdkPixbuf Structure">
10
10
  <link rel="next" href="gdk-pixbuf-File-Loading.html" title="File Loading">
11
- <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.20.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">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
- <td width="100%" align="left">
17
- <a href="#" class="shortcut">Top</a>
18
-  | 
19
- <a href="#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description" class="shortcut">Description</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18
+ <a href="#gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description" class="shortcut">Description</a></span>
20
19
  </td>
21
20
  <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
  <td><a accesskey="u" href="rn01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
@@ -30,148 +29,180 @@
30
29
  <h2><span class="refentrytitle"><a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.top_of_page"></a>Reference Counting and Memory Mangement</span></h2>
31
30
  <p>Reference Counting and Memory Mangement — Functions for reference counting and memory management on pixbufs.</p>
32
31
  </td>
33
- <td valign="top" align="right"></td>
32
+ <td class="gallery_image" valign="top" align="right"></td>
34
33
  </tr></table></div>
35
- <div class="refsynopsisdiv">
36
- <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.synopsis"></a><h2>Synopsis</h2>
37
- <pre class="synopsis">
38
- #include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
39
-
40
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()">gdk_pixbuf_ref</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>);
41
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()">gdk_pixbuf_unref</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>);
42
- <span class="returnvalue">void</span> (<a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()">*GdkPixbufDestroyNotify</a>) (<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pixels</code></em>,
43
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
34
+ <div class="refsect1">
35
+ <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.functions"></a><h2>Functions</h2>
36
+ <div class="informaltable"><table width="100%" border="0">
37
+ <colgroup>
38
+ <col width="150px" class="functions_return">
39
+ <col class="functions_name">
40
+ </colgroup>
41
+ <tbody>
42
+ <tr>
43
+ <td class="function_type">
44
+ <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
45
+ </td>
46
+ <td class="function_name">
47
+ <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()">gdk_pixbuf_ref</a> <span class="c_punctuation">()</span>
48
+ </td>
49
+ </tr>
50
+ <tr>
51
+ <td class="function_type">
52
+ <span class="returnvalue">void</span>
53
+ </td>
54
+ <td class="function_name">
55
+ <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()">gdk_pixbuf_unref</a> <span class="c_punctuation">()</span>
56
+ </td>
57
+ </tr>
58
+ <tr>
59
+ <td class="function_type">
60
+ <span class="returnvalue">void</span>
61
+ </td>
62
+ <td class="function_name">
63
+ <span class="c_punctuation">(</span><a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()">*GdkPixbufDestroyNotify</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
64
+ </td>
65
+ </tr>
66
+ </tbody>
67
+ </table></div>
68
+ </div>
69
+ <div class="refsect1">
70
+ <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.includes"></a><h2>Includes</h2>
71
+ <pre class="synopsis">#include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
44
72
  </pre>
45
73
  </div>
46
74
  <div class="refsect1">
47
75
  <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.description"></a><h2>Description</h2>
48
- <p>
49
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures are reference counted. This means that an
76
+ <p><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures are reference counted. This means that an
50
77
  application can share a single pixbuf among many parts of the
51
78
  code. When a piece of the program needs to keep a pointer to a
52
79
  pixbuf, it should add a reference to it by calling <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.
53
80
  When it no longer needs the pixbuf, it should subtract a reference
54
81
  by calling <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. The pixbuf will be destroyed when
55
82
  its reference count drops to zero. Newly-created <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
56
- structures start with a reference count of one.
57
- </p>
58
- <p>
59
- </p>
60
- <div class="note">
61
- <h3 class="title">Note</h3>
62
- As <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> is derived from <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> now, <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()"><code class="function">gdk_pixbuf_ref()</code></a> and
63
- <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()"><code class="function">gdk_pixbuf_unref()</code></a> are deprecated in favour of <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>
64
- and <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> resp.
65
- </div>
66
- <p>
67
- </p>
68
- <p>
69
- <span class="emphasis"><em>Finalizing</em></span> a pixbuf means to free its pixel
83
+ structures start with a reference count of one.</p>
84
+ <p>&gt; As <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> is derived from <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> now, <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-ref" title="gdk_pixbuf_ref ()"><code class="function">gdk_pixbuf_ref()</code></a> and
85
+ &gt; <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref" title="gdk_pixbuf_unref ()"><code class="function">gdk_pixbuf_unref()</code></a> are deprecated in favour of <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>
86
+ &gt; and <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> resp.</p>
87
+ <p>Finalizing a pixbuf means to free its pixel
70
88
  data and to free the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structure itself. Most of the
71
89
  library functions that create <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> structures create the
72
90
  pixel data by themselves and define the way it should be freed;
73
91
  you do not need to worry about those. The only function that lets
74
92
  you specify how to free the pixel data is
75
- <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>. Since you pass it a pre-allocated
93
+ <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>. Since you pass it a pre-allocated
76
94
  pixel buffer, you must also specify a way to free that data. This
77
- is done with a function of type <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a>. When a
78
- pixbuf created with <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> is finalized, your
95
+ is done with a function of type <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a>. When a
96
+ pixbuf created with <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> is finalized, your
79
97
  destroy notification function will be called, and it is its
80
- responsibility to free the pixel array.
81
- </p>
98
+ responsibility to free the pixel array.</p>
82
99
  </div>
83
100
  <div class="refsect1">
84
- <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.details"></a><h2>Details</h2>
101
+ <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.functions_details"></a><h2>Functions</h2>
85
102
  <div class="refsect2">
86
- <a name="gdk-pixbuf-ref"></a><h3>gdk_pixbuf_ref ()</h3>
87
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_ref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
103
+ <a name="gdk-pixbuf-ref"></a><h3>gdk_pixbuf_ref ()</h3>
104
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
105
+ gdk_pixbuf_ref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
88
106
  <div class="warning">
89
- <h3 class="title">Warning</h3>
90
- <p><code class="literal">gdk_pixbuf_ref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.</p>
107
+ <p><code class="literal">gdk_pixbuf_ref</code> has been deprecated since version 2.0 and should not be used in newly-written code.</p>
108
+ <p>Use <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>.</p>
91
109
  </div>
92
- <p>
93
- Adds a reference to a pixbuf.
94
- </p>
95
- <div class="variablelist"><table border="0" class="variablelist">
110
+ <p>Adds a reference to a pixbuf.</p>
111
+ <div class="refsect3">
112
+ <a name="id-1.2.5.6.2.6"></a><h4>Parameters</h4>
113
+ <div class="informaltable"><table width="100%" border="0">
96
114
  <colgroup>
97
- <col align="left" valign="top">
98
- <col>
115
+ <col width="150px" class="parameters_name">
116
+ <col class="parameters_description">
117
+ <col width="200px" class="parameters_annotations">
99
118
  </colgroup>
100
- <tbody>
101
- <tr>
102
- <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
103
- <td>A pixbuf.</td>
104
- </tr>
105
- <tr>
106
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
107
- <td>The same as the <em class="parameter"><code>pixbuf</code></em> argument.</td>
108
- </tr>
109
- </tbody>
119
+ <tbody><tr>
120
+ <td class="parameter_name"><p>pixbuf</p></td>
121
+ <td class="parameter_description"><p>A pixbuf.</p></td>
122
+ <td class="parameter_annotations"> </td>
123
+ </tr></tbody>
110
124
  </table></div>
111
125
  </div>
126
+ <div class="refsect3">
127
+ <a name="id-1.2.5.6.2.7"></a><h4>Returns</h4>
128
+ <p> The same as the <em class="parameter"><code>pixbuf</code></em>
129
+ argument.</p>
130
+ <p></p>
131
+ </div>
132
+ </div>
112
133
  <hr>
113
134
  <div class="refsect2">
114
- <a name="gdk-pixbuf-unref"></a><h3>gdk_pixbuf_unref ()</h3>
115
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_unref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
135
+ <a name="gdk-pixbuf-unref"></a><h3>gdk_pixbuf_unref ()</h3>
136
+ <pre class="programlisting"><span class="returnvalue">void</span>
137
+ gdk_pixbuf_unref (<em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
116
138
  <div class="warning">
117
- <h3 class="title">Warning</h3>
118
- <p><code class="literal">gdk_pixbuf_unref</code> has been deprecated since version 2.0 and should not be used in newly-written code. Use <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
139
+ <p><code class="literal">gdk_pixbuf_unref</code> has been deprecated since version 2.0 and should not be used in newly-written code.</p>
140
+ <p>Use <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
119
141
  </div>
120
- <p>
121
- Removes a reference from a pixbuf.
122
- </p>
123
- <div class="variablelist"><table border="0" class="variablelist">
142
+ <p>Removes a reference from a pixbuf.</p>
143
+ <div class="refsect3">
144
+ <a name="id-1.2.5.6.3.6"></a><h4>Parameters</h4>
145
+ <div class="informaltable"><table width="100%" border="0">
124
146
  <colgroup>
125
- <col align="left" valign="top">
126
- <col>
147
+ <col width="150px" class="parameters_name">
148
+ <col class="parameters_description">
149
+ <col width="200px" class="parameters_annotations">
127
150
  </colgroup>
128
151
  <tbody><tr>
129
- <td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
130
- <td>A pixbuf.</td>
152
+ <td class="parameter_name"><p>pixbuf</p></td>
153
+ <td class="parameter_description"><p>A pixbuf.</p></td>
154
+ <td class="parameter_annotations"> </td>
131
155
  </tr></tbody>
132
156
  </table></div>
133
157
  </div>
158
+ </div>
134
159
  <hr>
135
160
  <div class="refsect2">
136
- <a name="GdkPixbufDestroyNotify"></a><h3>GdkPixbufDestroyNotify ()</h3>
137
- <pre class="programlisting"><span class="returnvalue">void</span> (*GdkPixbufDestroyNotify) (<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pixels</code></em>,
138
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
139
- <p>
140
- A function of this type is responsible for freeing the pixel array
141
- of a pixbuf. The <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> function lets you
161
+ <a name="GdkPixbufDestroyNotify"></a><h3>GdkPixbufDestroyNotify ()</h3>
162
+ <pre class="programlisting"><span class="returnvalue">void</span>
163
+ <span class="c_punctuation">(</span>*GdkPixbufDestroyNotify<span class="c_punctuation">)</span> (<em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"><span class="type">guchar</span></a> *pixels</code></em>,
164
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
165
+ <p>A function of this type is responsible for freeing the pixel array
166
+ of a pixbuf. The <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a> function lets you
142
167
  pass in a pre-allocated pixel array so that a pixbuf can be
143
168
  created from it; in this case you will need to pass in a function
144
- of <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> so that the pixel data can be freed
145
- when the pixbuf is finalized.
146
- </p>
147
- <div class="variablelist"><table border="0" class="variablelist">
169
+ of <a class="link" href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#GdkPixbufDestroyNotify" title="GdkPixbufDestroyNotify ()"><span class="type">GdkPixbufDestroyNotify</span></a> so that the pixel data can be freed
170
+ when the pixbuf is finalized.</p>
171
+ <div class="refsect3">
172
+ <a name="id-1.2.5.6.4.5"></a><h4>Parameters</h4>
173
+ <div class="informaltable"><table width="100%" border="0">
148
174
  <colgroup>
149
- <col align="left" valign="top">
150
- <col>
175
+ <col width="150px" class="parameters_name">
176
+ <col class="parameters_description">
177
+ <col width="200px" class="parameters_annotations">
151
178
  </colgroup>
152
179
  <tbody>
153
180
  <tr>
154
- <td><p><span class="term"><em class="parameter"><code>pixels</code></em> :</span></p></td>
155
- <td>The pixel array of the pixbuf
156
- that is being finalized. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span>
157
- </td>
181
+ <td class="parameter_name"><p>pixels</p></td>
182
+ <td class="parameter_description"><p> The pixel array of the pixbuf
183
+ that is being finalized. </p></td>
184
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span></td>
158
185
  </tr>
159
186
  <tr>
160
- <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
161
- <td>User closure data. <span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span>
162
- </td>
187
+ <td class="parameter_name"><p>data</p></td>
188
+ <td class="parameter_description"><p> User closure data. </p></td>
189
+ <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
163
190
  </tr>
164
191
  </tbody>
165
192
  </table></div>
166
193
  </div>
167
194
  </div>
195
+ </div>
196
+ <div class="refsect1">
197
+ <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.other_details"></a><h2>Types and Values</h2>
198
+ </div>
168
199
  <div class="refsect1">
169
200
  <a name="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.see-also"></a><h2>See Also</h2>
170
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>.
201
+ <p><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-from-data" title="gdk_pixbuf_new_from_data ()"><code class="function">gdk_pixbuf_new_from_data()</code></a>.</p>
171
202
  </div>
172
203
  </div>
173
204
  <div class="footer">
174
205
  <hr>
175
- Generated by GTK-Doc V1.19.1</div>
206
+ Generated by GTK-Doc V1.20.1</div>
176
207
  </body>
177
208
  </html>
@@ -8,15 +8,14 @@
8
8
  <link rel="up" href="rn01.html" title="API Reference">
9
9
  <link rel="prev" href="gdk-pixbuf-Inline-data.html" title="Inline data">
10
10
  <link rel="next" href="gdk-pixbuf-gdk-pixbuf-rendering.html" title="Rendering">
11
- <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.20.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">
15
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
- <td width="100%" align="left">
17
- <a href="#" class="shortcut">Top</a>
18
-  | 
19
- <a href="#gdk-pixbuf-Scaling.description" class="shortcut">Description</a>
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16
+ <td width="100%" align="left" class="shortcuts">
17
+ <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18
+ <a href="#gdk-pixbuf-Scaling.description" class="shortcut">Description</a></span>
20
19
  </td>
21
20
  <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22
21
  <td><a accesskey="u" href="rn01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
@@ -30,747 +29,886 @@
30
29
  <h2><span class="refentrytitle"><a name="gdk-pixbuf-Scaling.top_of_page"></a>Scaling</span></h2>
31
30
  <p>Scaling — Scaling pixbufs and scaling and compositing pixbufs</p>
32
31
  </td>
33
- <td valign="top" align="right"></td>
32
+ <td class="gallery_image" valign="top" align="right"></td>
34
33
  </tr></table></div>
35
- <div class="refsynopsisdiv">
36
- <a name="gdk-pixbuf-Scaling.synopsis"></a><h2>Synopsis</h2>
37
- <pre class="synopsis">
38
- #include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
39
-
40
- enum <a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType">GdkInterpType</a>;
41
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()">gdk_pixbuf_scale_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
42
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
43
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
44
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);
45
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()">gdk_pixbuf_scale</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
46
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
47
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
48
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
49
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
50
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
51
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
52
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
53
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
54
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
55
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);
56
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()">gdk_pixbuf_composite_color_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
57
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
58
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
59
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
60
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
61
- <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
62
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
63
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);
64
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()">gdk_pixbuf_composite</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
65
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
66
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
67
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
68
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
69
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
70
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
71
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
72
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
73
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
74
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
75
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>);
76
- <span class="returnvalue">void</span> <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()">gdk_pixbuf_composite_color</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
77
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
78
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
79
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
80
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
81
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
82
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
83
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
84
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
85
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
86
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
87
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
88
- <em class="parameter"><code><span class="type">int</span> check_x</code></em>,
89
- <em class="parameter"><code><span class="type">int</span> check_y</code></em>,
90
- <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
91
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
92
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);
93
- enum <a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation">GdkPixbufRotation</a>;
94
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()">gdk_pixbuf_rotate_simple</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
95
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation"><span class="type">GdkPixbufRotation</span></a> angle</code></em>);
96
- <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" title="gdk_pixbuf_flip ()">gdk_pixbuf_flip</a> (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
97
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> horizontal</code></em>);
34
+ <div class="refsect1">
35
+ <a name="gdk-pixbuf-Scaling.functions"></a><h2>Functions</h2>
36
+ <div class="informaltable"><table width="100%" border="0">
37
+ <colgroup>
38
+ <col width="150px" class="functions_return">
39
+ <col class="functions_name">
40
+ </colgroup>
41
+ <tbody>
42
+ <tr>
43
+ <td class="function_type">
44
+ <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
45
+ </td>
46
+ <td class="function_name">
47
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()">gdk_pixbuf_scale_simple</a> <span class="c_punctuation">()</span>
48
+ </td>
49
+ </tr>
50
+ <tr>
51
+ <td class="function_type">
52
+ <span class="returnvalue">void</span>
53
+ </td>
54
+ <td class="function_name">
55
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()">gdk_pixbuf_scale</a> <span class="c_punctuation">()</span>
56
+ </td>
57
+ </tr>
58
+ <tr>
59
+ <td class="function_type">
60
+ <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
61
+ </td>
62
+ <td class="function_name">
63
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()">gdk_pixbuf_composite_color_simple</a> <span class="c_punctuation">()</span>
64
+ </td>
65
+ </tr>
66
+ <tr>
67
+ <td class="function_type">
68
+ <span class="returnvalue">void</span>
69
+ </td>
70
+ <td class="function_name">
71
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()">gdk_pixbuf_composite</a> <span class="c_punctuation">()</span>
72
+ </td>
73
+ </tr>
74
+ <tr>
75
+ <td class="function_type">
76
+ <span class="returnvalue">void</span>
77
+ </td>
78
+ <td class="function_name">
79
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()">gdk_pixbuf_composite_color</a> <span class="c_punctuation">()</span>
80
+ </td>
81
+ </tr>
82
+ <tr>
83
+ <td class="function_type">
84
+ <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
85
+ </td>
86
+ <td class="function_name">
87
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()">gdk_pixbuf_rotate_simple</a> <span class="c_punctuation">()</span>
88
+ </td>
89
+ </tr>
90
+ <tr>
91
+ <td class="function_type">
92
+ <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
93
+ </td>
94
+ <td class="function_name">
95
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-flip" title="gdk_pixbuf_flip ()">gdk_pixbuf_flip</a> <span class="c_punctuation">()</span>
96
+ </td>
97
+ </tr>
98
+ </tbody>
99
+ </table></div>
100
+ </div>
101
+ <div class="refsect1">
102
+ <a name="gdk-pixbuf-Scaling.other"></a><h2>Types and Values</h2>
103
+ <div class="informaltable"><table width="100%" border="0">
104
+ <colgroup>
105
+ <col width="150px" class="name">
106
+ <col class="description">
107
+ </colgroup>
108
+ <tbody>
109
+ <tr>
110
+ <td class="datatype_keyword">enum</td>
111
+ <td class="function_name"><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType">GdkInterpType</a></td>
112
+ </tr>
113
+ <tr>
114
+ <td class="datatype_keyword">enum</td>
115
+ <td class="function_name"><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation">GdkPixbufRotation</a></td>
116
+ </tr>
117
+ </tbody>
118
+ </table></div>
119
+ </div>
120
+ <div class="refsect1">
121
+ <a name="gdk-pixbuf-Scaling.includes"></a><h2>Includes</h2>
122
+ <pre class="synopsis">#include &lt;gdk-pixbuf/gdk-pixbuf.h&gt;
98
123
  </pre>
99
124
  </div>
100
125
  <div class="refsect1">
101
126
  <a name="gdk-pixbuf-Scaling.description"></a><h2>Description</h2>
102
- <p>
103
- The GdkPixBuf contains functions to scale pixbufs, to scale
127
+ <p>The GdkPixBuf contains functions to scale pixbufs, to scale
104
128
  pixbufs and composite against an existing image, and to scale
105
129
  pixbufs and composite against a solid color or checkerboard.
106
130
  Compositing a checkerboard is a common way to show an image with
107
- an alpha channel in image-viewing and editing software.
108
- </p>
109
- <p>
110
- Since the full-featured functions (<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>,
111
- <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>, and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a>) are
131
+ an alpha channel in image-viewing and editing software.</p>
132
+ <p>Since the full-featured functions (<a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>,
133
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>, and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a>) are
112
134
  rather complex to use and have many arguments, two simple
113
- convenience functions are provided, <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> and
114
- <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> which create a new pixbuf of a
135
+ convenience functions are provided, <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> and
136
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> which create a new pixbuf of a
115
137
  given size, scale an original image to fit, and then return the
116
- new pixbuf.
117
- </p>
118
- <p>
119
- Scaling and compositing functions take advantage of MMX hardware
138
+ new pixbuf.</p>
139
+ <p>Scaling and compositing functions take advantage of MMX hardware
120
140
  acceleration on systems where MMX is supported. If gdk-pixbuf is built
121
141
  with the Sun mediaLib library, these functions are instead accelerated
122
142
  using mediaLib, which provides hardware acceleration on Intel, AMD,
123
143
  and Sparc chipsets. If desired, mediaLib support can be turned off by
124
- setting the GDK_DISABLE_MEDIALIB environment variable.
125
- </p>
126
- <p>
127
- The following example demonstrates handling an expose event by
144
+ setting the <code class="literal">GDK_DISABLE_MEDIALIB</code> environment variable. </p>
145
+ <p>The following example demonstrates handling an expose event by
128
146
  rendering the appropriate area of a source image (which is scaled
129
147
  to fit the widget) onto the widget's window. The source image is
130
148
  rendered against a checkerboard, which provides a visual
131
149
  representation of the alpha channel if the image has one. If the
132
150
  image doesn't have an alpha channel, calling
133
- <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a> function has exactly the same effect
134
- as calling <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>.
135
- </p>
136
- <p>
137
- </p>
138
- <div class="example">
139
- <a name="id-1.2.10.4.6.1"></a><p class="title"><b>Example 2. Handling an expose event.</b></p>
140
- <div class="example-contents">
141
- <p>
142
- </p>
143
- <pre class="programlisting">
144
- gboolean
145
- expose_cb (GtkWidget *widget, GdkEventExpose *event, gpointer data)
146
- {
147
- GdkPixbuf *dest;
151
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color" title="gdk_pixbuf_composite_color ()"><code class="function">gdk_pixbuf_composite_color()</code></a> function has exactly the same effect
152
+ as calling <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>.</p>
153
+ <div class="refsect3">
154
+ <a name="id-1.2.10.6.6"></a><h4>Handling an expose event</h4>
155
+ <div class="informalexample">
156
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
157
+ <tbody>
158
+ <tr>
159
+ <td class="listing_lines" align="right"><pre>1
160
+ 2
161
+ 3
162
+ 4
163
+ 5
164
+ 6
165
+ 7
166
+ 8
167
+ 9
168
+ 10
169
+ 11
170
+ 12
171
+ 13
172
+ 14
173
+ 15
174
+ 16
175
+ 17
176
+ 18
177
+ 19
178
+ 20
179
+ 21
180
+ 22
181
+ 23
182
+ 24</pre></td>
183
+ <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a></span>
184
+ <span class="function">expose_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEventExpose</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
185
+ <span class="cbracket">{</span>
186
+ <span class="normal"> </span><span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dest</span><span class="symbol">;</span>
148
187
 
149
- dest = gdk_pixbuf_new (GDK_COLORSPACE_RGB, FALSE, 8, event-&gt;area.width, event-&gt;area.height);
188
+ <span class="normal"> dest </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new">gdk_pixbuf_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GDK_COLORSPACE_RGB</span><span class="symbol">,</span><span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">8</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">height</span><span class="symbol">);</span>
150
189
 
151
- gdk_pixbuf_composite_color (pixbuf, dest,
152
- 0, 0, event-&gt;area.width, event-&gt;area.height,
153
- -event-&gt;area.x, -event-&gt;area.y,
154
- (double) widget-&gt;allocation.width / gdk_pixbuf_get_width (pixbuf),
155
- (double) widget-&gt;allocation.height / gdk_pixbuf_get_height (pixbuf),
156
- GDK_INTERP_BILINEAR, 255,
157
- event-&gt;area.x, event-&gt;area.y, 16, 0xaaaaaa, 0x555555);
190
+ <span class="normal"> </span><span class="function"><a href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color">gdk_pixbuf_composite_color</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">,</span><span class="normal"> dest</span><span class="symbol">,</span>
191
+ <span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">height</span><span class="symbol">,</span>
192
+ <span class="normal"> </span><span class="symbol">-</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">,</span>
193
+ <span class="normal"> </span><span class="symbol">(</span><span class="type">double</span><span class="symbol">)</span><span class="normal"> widget</span><span class="symbol">-&gt;</span><span class="normal">allocation</span><span class="symbol">.</span><span class="normal">width </span><span class="symbol">/</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-width">gdk_pixbuf_get_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">),</span>
194
+ <span class="normal"> </span><span class="symbol">(</span><span class="type">double</span><span class="symbol">)</span><span class="normal"> widget</span><span class="symbol">-&gt;</span><span class="normal">allocation</span><span class="symbol">.</span><span class="normal">height </span><span class="symbol">/</span><span class="normal"> </span><span class="function"><a href="gdk-pixbuf-The-GdkPixbuf-Structure.html#gdk-pixbuf-get-height">gdk_pixbuf_get_height</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">),</span>
195
+ <span class="normal"> GDK_INTERP_BILINEAR</span><span class="symbol">,</span><span class="normal"> </span><span class="number">255</span><span class="symbol">,</span>
196
+ <span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">,</span><span class="normal"> </span><span class="number">16</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0xaaaaaa</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x555555</span><span class="symbol">);</span>
158
197
 
159
- gdk_draw_pixbuf (widget-&gt;window, widget-&gt;style-&gt;fg_gc[GTK_STATE_NORMAL], dest,
160
- 0, 0, event-&gt;area.x, event-&gt;area.y,
161
- event-&gt;area.width, event-&gt;area.height,
162
- GDK_RGB_DITHER_NORMAL, event-&gt;area.x, event-&gt;area.y);
163
-
164
- gdk_pixbuf_unref (dest);
165
-
166
- return TRUE;
167
- }
168
- </pre>
169
- <p>
170
- </p>
198
+ <span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Drawing-Primitives.html#gdk-draw-pixbuf">gdk_draw_pixbuf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">-&gt;</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> widget</span><span class="symbol">-&gt;</span><span class="normal">style</span><span class="symbol">-&gt;</span><span class="normal">fg_gc</span><span class="symbol">[</span><span class="normal"><a href="http://library.gnome.org/devel/gtk3/gtk2-Standard-Enumerations.html#GTK-STATE-NORMAL:CAPS">GTK_STATE_NORMAL</a></span><span class="symbol">],</span><span class="normal"> dest</span><span class="symbol">,</span>
199
+ <span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">,</span>
200
+ <span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">width</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">height</span><span class="symbol">,</span>
201
+ <span class="normal"> <a href="http://library.gnome.org/devel/gdk3/gdk2-GdkRGB.html#GDK-RGB-DITHER-NORMAL:CAPS">GDK_RGB_DITHER_NORMAL</a></span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">x</span><span class="symbol">,</span><span class="normal"> event</span><span class="symbol">-&gt;</span><span class="normal">area</span><span class="symbol">.</span><span class="normal">y</span><span class="symbol">);</span>
202
+ <span class="normal"> </span>
203
+ <span class="normal"> </span><span class="function"><a href="gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html#gdk-pixbuf-unref">gdk_pixbuf_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dest</span><span class="symbol">);</span>
204
+ <span class="normal"> </span>
205
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
206
+ <span class="cbracket">}</span></pre></td>
207
+ </tr>
208
+ </tbody>
209
+ </table>
171
210
  </div>
211
+
212
+ <p></p>
172
213
  </div>
173
- <p><br class="example-break">
174
- </p>
175
214
  </div>
176
215
  <div class="refsect1">
177
- <a name="gdk-pixbuf-Scaling.details"></a><h2>Details</h2>
178
- <div class="refsect2">
179
- <a name="GdkInterpType"></a><h3>enum GdkInterpType</h3>
180
- <pre class="programlisting">typedef enum {
181
- GDK_INTERP_NEAREST,
182
- GDK_INTERP_TILES,
183
- GDK_INTERP_BILINEAR,
184
- GDK_INTERP_HYPER
185
- } GdkInterpType;
186
- </pre>
187
- <p>
188
- This enumeration describes the different interpolation modes that
189
- can be used with the scaling functions. <em class="parameter"><code>GDK_INTERP_NEAREST</code></em> is
190
- the fastest scaling method, but has horrible quality when
191
- scaling down. <em class="parameter"><code>GDK_INTERP_BILINEAR</code></em> is the best choice if you
192
- aren't sure what to choose, it has a good speed/quality balance.
193
- </p>
194
- <p>
195
- </p>
196
- <div class="note">
197
- <h3 class="title">Note</h3>
198
- Cubic filtering is missing from the list; hyperbolic
199
- interpolation is just as fast and results in higher quality.
200
- </div>
201
- <p>
202
- </p>
203
- <div class="variablelist"><table border="0" class="variablelist">
204
- <colgroup>
205
- <col align="left" valign="top">
206
- <col>
207
- </colgroup>
208
- <tbody>
209
- <tr>
210
- <td><p><a name="GDK-INTERP-NEAREST:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_NEAREST</code></span></p></td>
211
- <td>Nearest neighbor sampling; this is the fastest
212
- and lowest quality mode. Quality is normally unacceptable when scaling
213
- down, but may be OK when scaling up.
214
- </td>
215
- </tr>
216
- <tr>
217
- <td><p><a name="GDK-INTERP-TILES:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_TILES</code></span></p></td>
218
- <td>This is an accurate simulation of the PostScript
219
- image operator without any interpolation enabled. Each pixel is
220
- rendered as a tiny parallelogram of solid color, the edges of which
221
- are implemented with antialiasing. It resembles nearest neighbor for
222
- enlargement, and bilinear for reduction.
223
- </td>
224
- </tr>
225
- <tr>
226
- <td><p><a name="GDK-INTERP-BILINEAR:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_BILINEAR</code></span></p></td>
227
- <td>Best quality/speed balance; use this mode by
228
- default. Bilinear interpolation. For enlargement, it is
229
- equivalent to point-sampling the ideal bilinear-interpolated image.
230
- For reduction, it is equivalent to laying down small tiles and
231
- integrating over the coverage area.
232
- </td>
233
- </tr>
234
- <tr>
235
- <td><p><a name="GDK-INTERP-HYPER:CAPS"></a><span class="term"><code class="literal">GDK_INTERP_HYPER</code></span></p></td>
236
- <td>This is the slowest and highest quality
237
- reconstruction function. It is derived from the hyperbolic filters in
238
- Wolberg's "Digital Image Warping", and is formally defined as the
239
- hyperbolic-filter sampling the ideal hyperbolic-filter interpolated
240
- image (the filter is designed to be idempotent for 1:1 pixel mapping).
241
- </td>
242
- </tr>
243
- </tbody>
244
- </table></div>
245
- </div>
246
- <hr>
216
+ <a name="gdk-pixbuf-Scaling.functions_details"></a><h2>Functions</h2>
247
217
  <div class="refsect2">
248
- <a name="gdk-pixbuf-scale-simple"></a><h3>gdk_pixbuf_scale_simple ()</h3>
249
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_scale_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
250
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
251
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
252
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre>
253
- <p>
254
- Create a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing a copy of <em class="parameter"><code>src</code></em> scaled to
255
- <em class="parameter"><code>dest_width</code></em> x <em class="parameter"><code>dest_height</code></em>. Leaves <em class="parameter"><code>src</code></em> unaffected. <em class="parameter"><code>interp_type</code></em>
218
+ <a name="gdk-pixbuf-scale-simple"></a><h3>gdk_pixbuf_scale_simple ()</h3>
219
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
220
+ gdk_pixbuf_scale_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
221
+ <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
222
+ <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
223
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre>
224
+ <p>Create a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing a copy of <em class="parameter"><code>src</code></em>
225
+ scaled to
226
+ <em class="parameter"><code>dest_width</code></em>
227
+ x <em class="parameter"><code>dest_height</code></em>
228
+ . Leaves <em class="parameter"><code>src</code></em>
229
+ unaffected. <em class="parameter"><code>interp_type</code></em>
230
+
256
231
  should be <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"><span class="type">GDK_INTERP_NEAREST</span></a> if you want maximum speed (but when
257
232
  scaling down <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-NEAREST:CAPS"><span class="type">GDK_INTERP_NEAREST</span></a> is usually unusably ugly). The
258
- default <em class="parameter"><code>interp_type</code></em> should be <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-BILINEAR:CAPS"><span class="type">GDK_INTERP_BILINEAR</span></a> which offers
259
- reasonable quality and speed.
260
- </p>
261
- <p>
262
- You can scale a sub-portion of <em class="parameter"><code>src</code></em> by creating a sub-pixbuf
263
- pointing into <em class="parameter"><code>src</code></em>; see <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()"><code class="function">gdk_pixbuf_new_subpixbuf()</code></a>.
264
- </p>
265
- <p>
266
- For more complicated scaling/compositing see <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>
267
- and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>.
268
- </p>
269
- <div class="variablelist"><table border="0" class="variablelist">
233
+ default <em class="parameter"><code>interp_type</code></em>
234
+ should be <a class="link" href="gdk-pixbuf-Scaling.html#GDK-INTERP-BILINEAR:CAPS"><span class="type">GDK_INTERP_BILINEAR</span></a> which offers
235
+ reasonable quality and speed.</p>
236
+ <p>You can scale a sub-portion of <em class="parameter"><code>src</code></em>
237
+ by creating a sub-pixbuf
238
+ pointing into <em class="parameter"><code>src</code></em>
239
+ ; see <a class="link" href="gdk-pixbuf-Image-Data-in-Memory.html#gdk-pixbuf-new-subpixbuf" title="gdk_pixbuf_new_subpixbuf ()"><code class="function">gdk_pixbuf_new_subpixbuf()</code></a>.</p>
240
+ <p>For more complicated scaling/compositing see <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale" title="gdk_pixbuf_scale ()"><code class="function">gdk_pixbuf_scale()</code></a>
241
+ and <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite" title="gdk_pixbuf_composite ()"><code class="function">gdk_pixbuf_composite()</code></a>.</p>
242
+ <div class="refsect3">
243
+ <a name="id-1.2.10.7.2.7"></a><h4>Parameters</h4>
244
+ <div class="informaltable"><table width="100%" border="0">
270
245
  <colgroup>
271
- <col align="left" valign="top">
272
- <col>
246
+ <col width="150px" class="parameters_name">
247
+ <col class="parameters_description">
248
+ <col width="200px" class="parameters_annotations">
273
249
  </colgroup>
274
250
  <tbody>
275
251
  <tr>
276
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
277
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
278
- </td>
279
- </tr>
280
- <tr>
281
- <td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td>
282
- <td>the width of destination image</td>
252
+ <td class="parameter_name"><p>src</p></td>
253
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
254
+ <td class="parameter_annotations"> </td>
283
255
  </tr>
284
256
  <tr>
285
- <td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td>
286
- <td>the height of destination image</td>
257
+ <td class="parameter_name"><p>dest_width</p></td>
258
+ <td class="parameter_description"><p>the width of destination image</p></td>
259
+ <td class="parameter_annotations"> </td>
287
260
  </tr>
288
261
  <tr>
289
- <td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td>
290
- <td>the interpolation type for the transformation.</td>
262
+ <td class="parameter_name"><p>dest_height</p></td>
263
+ <td class="parameter_description"><p>the height of destination image</p></td>
264
+ <td class="parameter_annotations"> </td>
291
265
  </tr>
292
266
  <tr>
293
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
294
- <td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
295
- allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
296
- </td>
267
+ <td class="parameter_name"><p>interp_type</p></td>
268
+ <td class="parameter_description"><p>the interpolation type for the transformation.</p></td>
269
+ <td class="parameter_annotations"> </td>
297
270
  </tr>
298
271
  </tbody>
299
272
  </table></div>
300
273
  </div>
274
+ <div class="refsect3">
275
+ <a name="id-1.2.10.7.2.8"></a><h4>Returns</h4>
276
+ <p> the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
277
+ allocated for it. </p>
278
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
279
+ </div>
280
+ </div>
301
281
  <hr>
302
282
  <div class="refsect2">
303
- <a name="gdk-pixbuf-scale"></a><h3>gdk_pixbuf_scale ()</h3>
304
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_scale (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
305
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
306
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
307
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
308
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
309
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
310
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
311
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
312
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
313
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
314
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre>
315
- <p>
316
- Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by
317
- <em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>,
318
- then renders the rectangle (<em class="parameter"><code>dest_x</code></em>, <em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>,
319
- <em class="parameter"><code>dest_height</code></em>) of the resulting image onto the destination image
320
- replacing the previous contents.
321
- </p>
322
- <p>
323
- Try to use <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> first, this function is
283
+ <a name="gdk-pixbuf-scale"></a><h3>gdk_pixbuf_scale ()</h3>
284
+ <pre class="programlisting"><span class="returnvalue">void</span>
285
+ gdk_pixbuf_scale (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
286
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
287
+ <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
288
+ <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
289
+ <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
290
+ <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
291
+ <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
292
+ <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
293
+ <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
294
+ <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
295
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>);</pre>
296
+ <p>Creates a transformation of the source image <em class="parameter"><code>src</code></em>
297
+ by scaling by
298
+ <em class="parameter"><code>scale_x</code></em>
299
+ and <em class="parameter"><code>scale_y</code></em>
300
+ then translating by <em class="parameter"><code>offset_x</code></em>
301
+ and <em class="parameter"><code>offset_y</code></em>
302
+ ,
303
+ then renders the rectangle (<em class="parameter"><code>dest_x</code></em>
304
+ , <em class="parameter"><code>dest_y</code></em>
305
+ , <em class="parameter"><code>dest_width</code></em>
306
+ ,
307
+ <em class="parameter"><code>dest_height</code></em>
308
+ ) of the resulting image onto the destination image
309
+ replacing the previous contents.</p>
310
+ <p>Try to use <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> first, this function is
324
311
  the industrial-strength power tool you can fall back to if
325
- <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> isn't powerful enough.
326
- </p>
327
- <p>
328
- If the source rectangle overlaps the destination rectangle on the
312
+ <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-scale-simple" title="gdk_pixbuf_scale_simple ()"><code class="function">gdk_pixbuf_scale_simple()</code></a> isn't powerful enough.</p>
313
+ <p>If the source rectangle overlaps the destination rectangle on the
329
314
  same pixbuf, it will be overwritten during the scaling which
330
- results in rendering artifacts.
331
- </p>
332
- <div class="variablelist"><table border="0" class="variablelist">
315
+ results in rendering artifacts.</p>
316
+ <div class="refsect3">
317
+ <a name="id-1.2.10.7.3.7"></a><h4>Parameters</h4>
318
+ <div class="informaltable"><table width="100%" border="0">
333
319
  <colgroup>
334
- <col align="left" valign="top">
335
- <col>
320
+ <col width="150px" class="parameters_name">
321
+ <col class="parameters_description">
322
+ <col width="200px" class="parameters_annotations">
336
323
  </colgroup>
337
324
  <tbody>
338
325
  <tr>
339
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
340
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
341
- </td>
326
+ <td class="parameter_name"><p>src</p></td>
327
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
328
+ <td class="parameter_annotations"> </td>
342
329
  </tr>
343
330
  <tr>
344
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
345
- <td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td>
331
+ <td class="parameter_name"><p>dest</p></td>
332
+ <td class="parameter_description"><p>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</p></td>
333
+ <td class="parameter_annotations"> </td>
346
334
  </tr>
347
335
  <tr>
348
- <td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td>
349
- <td>the left coordinate for region to render</td>
336
+ <td class="parameter_name"><p>dest_x</p></td>
337
+ <td class="parameter_description"><p>the left coordinate for region to render</p></td>
338
+ <td class="parameter_annotations"> </td>
350
339
  </tr>
351
340
  <tr>
352
- <td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td>
353
- <td>the top coordinate for region to render</td>
341
+ <td class="parameter_name"><p>dest_y</p></td>
342
+ <td class="parameter_description"><p>the top coordinate for region to render</p></td>
343
+ <td class="parameter_annotations"> </td>
354
344
  </tr>
355
345
  <tr>
356
- <td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td>
357
- <td>the width of the region to render</td>
346
+ <td class="parameter_name"><p>dest_width</p></td>
347
+ <td class="parameter_description"><p>the width of the region to render</p></td>
348
+ <td class="parameter_annotations"> </td>
358
349
  </tr>
359
350
  <tr>
360
- <td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td>
361
- <td>the height of the region to render</td>
351
+ <td class="parameter_name"><p>dest_height</p></td>
352
+ <td class="parameter_description"><p>the height of the region to render</p></td>
353
+ <td class="parameter_annotations"> </td>
362
354
  </tr>
363
355
  <tr>
364
- <td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td>
365
- <td>the offset in the X direction (currently rounded to an integer)</td>
356
+ <td class="parameter_name"><p>offset_x</p></td>
357
+ <td class="parameter_description"><p>the offset in the X direction (currently rounded to an integer)</p></td>
358
+ <td class="parameter_annotations"> </td>
366
359
  </tr>
367
360
  <tr>
368
- <td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td>
369
- <td>the offset in the Y direction (currently rounded to an integer)</td>
361
+ <td class="parameter_name"><p>offset_y</p></td>
362
+ <td class="parameter_description"><p>the offset in the Y direction (currently rounded to an integer)</p></td>
363
+ <td class="parameter_annotations"> </td>
370
364
  </tr>
371
365
  <tr>
372
- <td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td>
373
- <td>the scale factor in the X direction</td>
366
+ <td class="parameter_name"><p>scale_x</p></td>
367
+ <td class="parameter_description"><p>the scale factor in the X direction</p></td>
368
+ <td class="parameter_annotations"> </td>
374
369
  </tr>
375
370
  <tr>
376
- <td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td>
377
- <td>the scale factor in the Y direction</td>
371
+ <td class="parameter_name"><p>scale_y</p></td>
372
+ <td class="parameter_description"><p>the scale factor in the Y direction</p></td>
373
+ <td class="parameter_annotations"> </td>
378
374
  </tr>
379
375
  <tr>
380
- <td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td>
381
- <td>the interpolation type for the transformation.</td>
376
+ <td class="parameter_name"><p>interp_type</p></td>
377
+ <td class="parameter_description"><p>the interpolation type for the transformation.</p></td>
378
+ <td class="parameter_annotations"> </td>
382
379
  </tr>
383
380
  </tbody>
384
381
  </table></div>
385
382
  </div>
383
+ </div>
386
384
  <hr>
387
385
  <div class="refsect2">
388
- <a name="gdk-pixbuf-composite-color-simple"></a><h3>gdk_pixbuf_composite_color_simple ()</h3>
389
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_composite_color_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
390
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
391
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
392
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
393
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
394
- <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
395
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
396
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre>
397
- <p>
398
- Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> by scaling <em class="parameter"><code>src</code></em> to <em class="parameter"><code>dest_width</code></em> x
399
- <em class="parameter"><code>dest_height</code></em> and compositing the result with a checkboard of colors
400
- <em class="parameter"><code>color1</code></em> and <em class="parameter"><code>color2</code></em>.
401
- </p>
402
- <div class="variablelist"><table border="0" class="variablelist">
386
+ <a name="gdk-pixbuf-composite-color-simple"></a><h3>gdk_pixbuf_composite_color_simple ()</h3>
387
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
388
+ gdk_pixbuf_composite_color_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
389
+ <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
390
+ <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
391
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
392
+ <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
393
+ <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
394
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
395
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre>
396
+ <p>Creates a new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> by scaling <em class="parameter"><code>src</code></em>
397
+ to <em class="parameter"><code>dest_width</code></em>
398
+ x
399
+ <em class="parameter"><code>dest_height</code></em>
400
+ and compositing the result with a checkboard of colors
401
+ <em class="parameter"><code>color1</code></em>
402
+ and <em class="parameter"><code>color2</code></em>
403
+ .</p>
404
+ <div class="refsect3">
405
+ <a name="id-1.2.10.7.4.5"></a><h4>Parameters</h4>
406
+ <div class="informaltable"><table width="100%" border="0">
403
407
  <colgroup>
404
- <col align="left" valign="top">
405
- <col>
408
+ <col width="150px" class="parameters_name">
409
+ <col class="parameters_description">
410
+ <col width="200px" class="parameters_annotations">
406
411
  </colgroup>
407
412
  <tbody>
408
413
  <tr>
409
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
410
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
411
- </td>
414
+ <td class="parameter_name"><p>src</p></td>
415
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
416
+ <td class="parameter_annotations"> </td>
412
417
  </tr>
413
418
  <tr>
414
- <td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td>
415
- <td>the width of destination image</td>
419
+ <td class="parameter_name"><p>dest_width</p></td>
420
+ <td class="parameter_description"><p>the width of destination image</p></td>
421
+ <td class="parameter_annotations"> </td>
416
422
  </tr>
417
423
  <tr>
418
- <td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td>
419
- <td>the height of destination image</td>
424
+ <td class="parameter_name"><p>dest_height</p></td>
425
+ <td class="parameter_description"><p>the height of destination image</p></td>
426
+ <td class="parameter_annotations"> </td>
420
427
  </tr>
421
428
  <tr>
422
- <td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td>
423
- <td>the interpolation type for the transformation.</td>
429
+ <td class="parameter_name"><p>interp_type</p></td>
430
+ <td class="parameter_description"><p>the interpolation type for the transformation.</p></td>
431
+ <td class="parameter_annotations"> </td>
424
432
  </tr>
425
433
  <tr>
426
- <td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td>
427
- <td>overall alpha for source image (0..255)</td>
434
+ <td class="parameter_name"><p>overall_alpha</p></td>
435
+ <td class="parameter_description"><p>overall alpha for source image (0..255)</p></td>
436
+ <td class="parameter_annotations"> </td>
428
437
  </tr>
429
438
  <tr>
430
- <td><p><span class="term"><em class="parameter"><code>check_size</code></em> :</span></p></td>
431
- <td>the size of checks in the checkboard (must be a power of two)</td>
439
+ <td class="parameter_name"><p>check_size</p></td>
440
+ <td class="parameter_description"><p>the size of checks in the checkboard (must be a power of two)</p></td>
441
+ <td class="parameter_annotations"> </td>
432
442
  </tr>
433
443
  <tr>
434
- <td><p><span class="term"><em class="parameter"><code>color1</code></em> :</span></p></td>
435
- <td>the color of check at upper left</td>
444
+ <td class="parameter_name"><p>color1</p></td>
445
+ <td class="parameter_description"><p>the color of check at upper left</p></td>
446
+ <td class="parameter_annotations"> </td>
436
447
  </tr>
437
448
  <tr>
438
- <td><p><span class="term"><em class="parameter"><code>color2</code></em> :</span></p></td>
439
- <td>the color of the other check</td>
440
- </tr>
441
- <tr>
442
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
443
- <td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
444
- allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
445
- </td>
449
+ <td class="parameter_name"><p>color2</p></td>
450
+ <td class="parameter_description"><p>the color of the other check</p></td>
451
+ <td class="parameter_annotations"> </td>
446
452
  </tr>
447
453
  </tbody>
448
454
  </table></div>
449
455
  </div>
456
+ <div class="refsect3">
457
+ <a name="id-1.2.10.7.4.6"></a><h4>Returns</h4>
458
+ <p> the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
459
+ allocated for it. </p>
460
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
461
+ </div>
462
+ </div>
450
463
  <hr>
451
464
  <div class="refsect2">
452
- <a name="gdk-pixbuf-composite"></a><h3>gdk_pixbuf_composite ()</h3>
453
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_composite (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
454
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
455
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
456
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
457
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
458
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
459
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
460
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
461
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
462
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
463
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
464
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>);</pre>
465
- <p>
466
- Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by
467
- <em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>.
465
+ <a name="gdk-pixbuf-composite"></a><h3>gdk_pixbuf_composite ()</h3>
466
+ <pre class="programlisting"><span class="returnvalue">void</span>
467
+ gdk_pixbuf_composite (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
468
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
469
+ <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
470
+ <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
471
+ <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
472
+ <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
473
+ <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
474
+ <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
475
+ <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
476
+ <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
477
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
478
+ <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>);</pre>
479
+ <p>Creates a transformation of the source image <em class="parameter"><code>src</code></em>
480
+ by scaling by
481
+ <em class="parameter"><code>scale_x</code></em>
482
+ and <em class="parameter"><code>scale_y</code></em>
483
+ then translating by <em class="parameter"><code>offset_x</code></em>
484
+ and <em class="parameter"><code>offset_y</code></em>
485
+ .
468
486
  This gives an image in the coordinates of the destination pixbuf.
469
- The rectangle (<em class="parameter"><code>dest_x</code></em>, <em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>, <em class="parameter"><code>dest_height</code></em>)
487
+ The rectangle (<em class="parameter"><code>dest_x</code></em>
488
+ , <em class="parameter"><code>dest_y</code></em>
489
+ , <em class="parameter"><code>dest_width</code></em>
490
+ , <em class="parameter"><code>dest_height</code></em>
491
+ )
470
492
  is then composited onto the corresponding rectangle of the
471
- original destination image.
472
- </p>
473
- <p>
474
- When the destination rectangle contains parts not in the source
493
+ original destination image.</p>
494
+ <p>When the destination rectangle contains parts not in the source
475
495
  image, the data at the edges of the source image is replicated
476
- to infinity.
477
- </p>
478
- <p>
479
- </p>
480
- <div class="figure">
481
- <a name="pixbuf-composite-diagram"></a><p class="title"><b>Figure 1. Compositing of pixbufs</b></p>
482
- <div class="figure-contents"><div><img src="composite.png" alt="Compositing of pixbufs"></div></div>
483
- </div>
484
- <p><br class="figure-break">
485
- </p>
486
- <div class="variablelist"><table border="0" class="variablelist">
496
+ to infinity. </p>
497
+ <p><span class="inlinemediaobject"><img src="composite.png"></span></p>
498
+ <div class="refsect3">
499
+ <a name="id-1.2.10.7.5.7"></a><h4>Parameters</h4>
500
+ <div class="informaltable"><table width="100%" border="0">
487
501
  <colgroup>
488
- <col align="left" valign="top">
489
- <col>
502
+ <col width="150px" class="parameters_name">
503
+ <col class="parameters_description">
504
+ <col width="200px" class="parameters_annotations">
490
505
  </colgroup>
491
506
  <tbody>
492
507
  <tr>
493
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
494
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
495
- </td>
508
+ <td class="parameter_name"><p>src</p></td>
509
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
510
+ <td class="parameter_annotations"> </td>
496
511
  </tr>
497
512
  <tr>
498
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
499
- <td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td>
513
+ <td class="parameter_name"><p>dest</p></td>
514
+ <td class="parameter_description"><p>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</p></td>
515
+ <td class="parameter_annotations"> </td>
500
516
  </tr>
501
517
  <tr>
502
- <td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td>
503
- <td>the left coordinate for region to render</td>
518
+ <td class="parameter_name"><p>dest_x</p></td>
519
+ <td class="parameter_description"><p>the left coordinate for region to render</p></td>
520
+ <td class="parameter_annotations"> </td>
504
521
  </tr>
505
522
  <tr>
506
- <td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td>
507
- <td>the top coordinate for region to render</td>
523
+ <td class="parameter_name"><p>dest_y</p></td>
524
+ <td class="parameter_description"><p>the top coordinate for region to render</p></td>
525
+ <td class="parameter_annotations"> </td>
508
526
  </tr>
509
527
  <tr>
510
- <td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td>
511
- <td>the width of the region to render</td>
528
+ <td class="parameter_name"><p>dest_width</p></td>
529
+ <td class="parameter_description"><p>the width of the region to render</p></td>
530
+ <td class="parameter_annotations"> </td>
512
531
  </tr>
513
532
  <tr>
514
- <td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td>
515
- <td>the height of the region to render</td>
533
+ <td class="parameter_name"><p>dest_height</p></td>
534
+ <td class="parameter_description"><p>the height of the region to render</p></td>
535
+ <td class="parameter_annotations"> </td>
516
536
  </tr>
517
537
  <tr>
518
- <td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td>
519
- <td>the offset in the X direction (currently rounded to an integer)</td>
538
+ <td class="parameter_name"><p>offset_x</p></td>
539
+ <td class="parameter_description"><p>the offset in the X direction (currently rounded to an integer)</p></td>
540
+ <td class="parameter_annotations"> </td>
520
541
  </tr>
521
542
  <tr>
522
- <td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td>
523
- <td>the offset in the Y direction (currently rounded to an integer)</td>
543
+ <td class="parameter_name"><p>offset_y</p></td>
544
+ <td class="parameter_description"><p>the offset in the Y direction (currently rounded to an integer)</p></td>
545
+ <td class="parameter_annotations"> </td>
524
546
  </tr>
525
547
  <tr>
526
- <td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td>
527
- <td>the scale factor in the X direction</td>
548
+ <td class="parameter_name"><p>scale_x</p></td>
549
+ <td class="parameter_description"><p>the scale factor in the X direction</p></td>
550
+ <td class="parameter_annotations"> </td>
528
551
  </tr>
529
552
  <tr>
530
- <td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td>
531
- <td>the scale factor in the Y direction</td>
553
+ <td class="parameter_name"><p>scale_y</p></td>
554
+ <td class="parameter_description"><p>the scale factor in the Y direction</p></td>
555
+ <td class="parameter_annotations"> </td>
532
556
  </tr>
533
557
  <tr>
534
- <td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td>
535
- <td>the interpolation type for the transformation.</td>
558
+ <td class="parameter_name"><p>interp_type</p></td>
559
+ <td class="parameter_description"><p>the interpolation type for the transformation.</p></td>
560
+ <td class="parameter_annotations"> </td>
536
561
  </tr>
537
562
  <tr>
538
- <td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td>
539
- <td>overall alpha for source image (0..255)</td>
563
+ <td class="parameter_name"><p>overall_alpha</p></td>
564
+ <td class="parameter_description"><p>overall alpha for source image (0..255)</p></td>
565
+ <td class="parameter_annotations"> </td>
540
566
  </tr>
541
567
  </tbody>
542
568
  </table></div>
543
569
  </div>
570
+ </div>
544
571
  <hr>
545
572
  <div class="refsect2">
546
- <a name="gdk-pixbuf-composite-color"></a><h3>gdk_pixbuf_composite_color ()</h3>
547
- <pre class="programlisting"><span class="returnvalue">void</span> gdk_pixbuf_composite_color (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
548
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
549
- <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
550
- <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
551
- <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
552
- <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
553
- <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
554
- <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
555
- <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
556
- <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
557
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
558
- <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
559
- <em class="parameter"><code><span class="type">int</span> check_x</code></em>,
560
- <em class="parameter"><code><span class="type">int</span> check_y</code></em>,
561
- <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
562
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
563
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre>
564
- <p>
565
- Creates a transformation of the source image <em class="parameter"><code>src</code></em> by scaling by
566
- <em class="parameter"><code>scale_x</code></em> and <em class="parameter"><code>scale_y</code></em> then translating by <em class="parameter"><code>offset_x</code></em> and <em class="parameter"><code>offset_y</code></em>,
567
- then composites the rectangle (<em class="parameter"><code>dest_x</code></em> ,<em class="parameter"><code>dest_y</code></em>, <em class="parameter"><code>dest_width</code></em>,
568
- <em class="parameter"><code>dest_height</code></em>) of the resulting image with a checkboard of the
569
- colors <em class="parameter"><code>color1</code></em> and <em class="parameter"><code>color2</code></em> and renders it onto the destination
570
- image.
571
- </p>
572
- <p>
573
- See <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> for a simpler variant of this
574
- function suitable for many tasks.
575
- </p>
576
- <div class="variablelist"><table border="0" class="variablelist">
573
+ <a name="gdk-pixbuf-composite-color"></a><h3>gdk_pixbuf_composite_color ()</h3>
574
+ <pre class="programlisting"><span class="returnvalue">void</span>
575
+ gdk_pixbuf_composite_color (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
576
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *dest</code></em>,
577
+ <em class="parameter"><code><span class="type">int</span> dest_x</code></em>,
578
+ <em class="parameter"><code><span class="type">int</span> dest_y</code></em>,
579
+ <em class="parameter"><code><span class="type">int</span> dest_width</code></em>,
580
+ <em class="parameter"><code><span class="type">int</span> dest_height</code></em>,
581
+ <em class="parameter"><code><span class="type">double</span> offset_x</code></em>,
582
+ <em class="parameter"><code><span class="type">double</span> offset_y</code></em>,
583
+ <em class="parameter"><code><span class="type">double</span> scale_x</code></em>,
584
+ <em class="parameter"><code><span class="type">double</span> scale_y</code></em>,
585
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkInterpType" title="enum GdkInterpType"><span class="type">GdkInterpType</span></a> interp_type</code></em>,
586
+ <em class="parameter"><code><span class="type">int</span> overall_alpha</code></em>,
587
+ <em class="parameter"><code><span class="type">int</span> check_x</code></em>,
588
+ <em class="parameter"><code><span class="type">int</span> check_y</code></em>,
589
+ <em class="parameter"><code><span class="type">int</span> check_size</code></em>,
590
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color1</code></em>,
591
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> color2</code></em>);</pre>
592
+ <p>Creates a transformation of the source image <em class="parameter"><code>src</code></em>
593
+ by scaling by
594
+ <em class="parameter"><code>scale_x</code></em>
595
+ and <em class="parameter"><code>scale_y</code></em>
596
+ then translating by <em class="parameter"><code>offset_x</code></em>
597
+ and <em class="parameter"><code>offset_y</code></em>
598
+ ,
599
+ then composites the rectangle (<em class="parameter"><code>dest_x</code></em>
600
+ ,<em class="parameter"><code>dest_y</code></em>
601
+ , <em class="parameter"><code>dest_width</code></em>
602
+ ,
603
+ <em class="parameter"><code>dest_height</code></em>
604
+ ) of the resulting image with a checkboard of the
605
+ colors <em class="parameter"><code>color1</code></em>
606
+ and <em class="parameter"><code>color2</code></em>
607
+ and renders it onto the destination
608
+ image.</p>
609
+ <p>See <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-composite-color-simple" title="gdk_pixbuf_composite_color_simple ()"><code class="function">gdk_pixbuf_composite_color_simple()</code></a> for a simpler variant of this
610
+ function suitable for many tasks.</p>
611
+ <div class="refsect3">
612
+ <a name="id-1.2.10.7.6.6"></a><h4>Parameters</h4>
613
+ <div class="informaltable"><table width="100%" border="0">
577
614
  <colgroup>
578
- <col align="left" valign="top">
579
- <col>
615
+ <col width="150px" class="parameters_name">
616
+ <col class="parameters_description">
617
+ <col width="200px" class="parameters_annotations">
580
618
  </colgroup>
581
619
  <tbody>
582
620
  <tr>
583
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
584
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
585
- </td>
621
+ <td class="parameter_name"><p>src</p></td>
622
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
623
+ <td class="parameter_annotations"> </td>
586
624
  </tr>
587
625
  <tr>
588
- <td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
589
- <td>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</td>
626
+ <td class="parameter_name"><p>dest</p></td>
627
+ <td class="parameter_description"><p>the <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> into which to render the results</p></td>
628
+ <td class="parameter_annotations"> </td>
590
629
  </tr>
591
630
  <tr>
592
- <td><p><span class="term"><em class="parameter"><code>dest_x</code></em> :</span></p></td>
593
- <td>the left coordinate for region to render</td>
631
+ <td class="parameter_name"><p>dest_x</p></td>
632
+ <td class="parameter_description"><p>the left coordinate for region to render</p></td>
633
+ <td class="parameter_annotations"> </td>
594
634
  </tr>
595
635
  <tr>
596
- <td><p><span class="term"><em class="parameter"><code>dest_y</code></em> :</span></p></td>
597
- <td>the top coordinate for region to render</td>
636
+ <td class="parameter_name"><p>dest_y</p></td>
637
+ <td class="parameter_description"><p>the top coordinate for region to render</p></td>
638
+ <td class="parameter_annotations"> </td>
598
639
  </tr>
599
640
  <tr>
600
- <td><p><span class="term"><em class="parameter"><code>dest_width</code></em> :</span></p></td>
601
- <td>the width of the region to render</td>
641
+ <td class="parameter_name"><p>dest_width</p></td>
642
+ <td class="parameter_description"><p>the width of the region to render</p></td>
643
+ <td class="parameter_annotations"> </td>
602
644
  </tr>
603
645
  <tr>
604
- <td><p><span class="term"><em class="parameter"><code>dest_height</code></em> :</span></p></td>
605
- <td>the height of the region to render</td>
646
+ <td class="parameter_name"><p>dest_height</p></td>
647
+ <td class="parameter_description"><p>the height of the region to render</p></td>
648
+ <td class="parameter_annotations"> </td>
606
649
  </tr>
607
650
  <tr>
608
- <td><p><span class="term"><em class="parameter"><code>offset_x</code></em> :</span></p></td>
609
- <td>the offset in the X direction (currently rounded to an integer)</td>
651
+ <td class="parameter_name"><p>offset_x</p></td>
652
+ <td class="parameter_description"><p>the offset in the X direction (currently rounded to an integer)</p></td>
653
+ <td class="parameter_annotations"> </td>
610
654
  </tr>
611
655
  <tr>
612
- <td><p><span class="term"><em class="parameter"><code>offset_y</code></em> :</span></p></td>
613
- <td>the offset in the Y direction (currently rounded to an integer)</td>
656
+ <td class="parameter_name"><p>offset_y</p></td>
657
+ <td class="parameter_description"><p>the offset in the Y direction (currently rounded to an integer)</p></td>
658
+ <td class="parameter_annotations"> </td>
614
659
  </tr>
615
660
  <tr>
616
- <td><p><span class="term"><em class="parameter"><code>scale_x</code></em> :</span></p></td>
617
- <td>the scale factor in the X direction</td>
661
+ <td class="parameter_name"><p>scale_x</p></td>
662
+ <td class="parameter_description"><p>the scale factor in the X direction</p></td>
663
+ <td class="parameter_annotations"> </td>
618
664
  </tr>
619
665
  <tr>
620
- <td><p><span class="term"><em class="parameter"><code>scale_y</code></em> :</span></p></td>
621
- <td>the scale factor in the Y direction</td>
666
+ <td class="parameter_name"><p>scale_y</p></td>
667
+ <td class="parameter_description"><p>the scale factor in the Y direction</p></td>
668
+ <td class="parameter_annotations"> </td>
622
669
  </tr>
623
670
  <tr>
624
- <td><p><span class="term"><em class="parameter"><code>interp_type</code></em> :</span></p></td>
625
- <td>the interpolation type for the transformation.</td>
671
+ <td class="parameter_name"><p>interp_type</p></td>
672
+ <td class="parameter_description"><p>the interpolation type for the transformation.</p></td>
673
+ <td class="parameter_annotations"> </td>
626
674
  </tr>
627
675
  <tr>
628
- <td><p><span class="term"><em class="parameter"><code>overall_alpha</code></em> :</span></p></td>
629
- <td>overall alpha for source image (0..255)</td>
676
+ <td class="parameter_name"><p>overall_alpha</p></td>
677
+ <td class="parameter_description"><p>overall alpha for source image (0..255)</p></td>
678
+ <td class="parameter_annotations"> </td>
630
679
  </tr>
631
680
  <tr>
632
- <td><p><span class="term"><em class="parameter"><code>check_x</code></em> :</span></p></td>
633
- <td>the X offset for the checkboard (origin of checkboard is at -<em class="parameter"><code>check_x</code></em>, -<em class="parameter"><code>check_y</code></em>)</td>
681
+ <td class="parameter_name"><p>check_x</p></td>
682
+ <td class="parameter_description"><p>the X offset for the checkboard (origin of checkboard is at -<em class="parameter"><code>check_x</code></em>
683
+ , -<em class="parameter"><code>check_y</code></em>
684
+ )</p></td>
685
+ <td class="parameter_annotations"> </td>
634
686
  </tr>
635
687
  <tr>
636
- <td><p><span class="term"><em class="parameter"><code>check_y</code></em> :</span></p></td>
637
- <td>the Y offset for the checkboard</td>
688
+ <td class="parameter_name"><p>check_y</p></td>
689
+ <td class="parameter_description"><p>the Y offset for the checkboard </p></td>
690
+ <td class="parameter_annotations"> </td>
638
691
  </tr>
639
692
  <tr>
640
- <td><p><span class="term"><em class="parameter"><code>check_size</code></em> :</span></p></td>
641
- <td>the size of checks in the checkboard (must be a power of two)</td>
693
+ <td class="parameter_name"><p>check_size</p></td>
694
+ <td class="parameter_description"><p>the size of checks in the checkboard (must be a power of two)</p></td>
695
+ <td class="parameter_annotations"> </td>
642
696
  </tr>
643
697
  <tr>
644
- <td><p><span class="term"><em class="parameter"><code>color1</code></em> :</span></p></td>
645
- <td>the color of check at upper left</td>
698
+ <td class="parameter_name"><p>color1</p></td>
699
+ <td class="parameter_description"><p>the color of check at upper left</p></td>
700
+ <td class="parameter_annotations"> </td>
646
701
  </tr>
647
702
  <tr>
648
- <td><p><span class="term"><em class="parameter"><code>color2</code></em> :</span></p></td>
649
- <td>the color of the other check</td>
703
+ <td class="parameter_name"><p>color2</p></td>
704
+ <td class="parameter_description"><p>the color of the other check</p></td>
705
+ <td class="parameter_annotations"> </td>
650
706
  </tr>
651
707
  </tbody>
652
708
  </table></div>
653
709
  </div>
710
+ </div>
654
711
  <hr>
655
712
  <div class="refsect2">
656
- <a name="GdkPixbufRotation"></a><h3>enum GdkPixbufRotation</h3>
657
- <pre class="programlisting">typedef enum {
658
- GDK_PIXBUF_ROTATE_NONE = 0,
659
- GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE = 90,
660
- GDK_PIXBUF_ROTATE_UPSIDEDOWN = 180,
661
- GDK_PIXBUF_ROTATE_CLOCKWISE = 270
662
- } GdkPixbufRotation;
663
- </pre>
664
- <p>
665
- The possible rotations which can be passed to <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()"><code class="function">gdk_pixbuf_rotate_simple()</code></a>.
666
- To make them easier to use, their numerical values are the actual degrees.
667
- </p>
668
- <div class="variablelist"><table border="0" class="variablelist">
713
+ <a name="gdk-pixbuf-rotate-simple"></a><h3>gdk_pixbuf_rotate_simple ()</h3>
714
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
715
+ gdk_pixbuf_rotate_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
716
+ <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation"><span class="type">GdkPixbufRotation</span></a> angle</code></em>);</pre>
717
+ <p>Rotates a pixbuf by a multiple of 90 degrees, and returns the
718
+ result in a new pixbuf.</p>
719
+ <div class="refsect3">
720
+ <a name="id-1.2.10.7.7.5"></a><h4>Parameters</h4>
721
+ <div class="informaltable"><table width="100%" border="0">
669
722
  <colgroup>
670
- <col align="left" valign="top">
671
- <col>
723
+ <col width="150px" class="parameters_name">
724
+ <col class="parameters_description">
725
+ <col width="200px" class="parameters_annotations">
672
726
  </colgroup>
673
727
  <tbody>
674
728
  <tr>
675
- <td><p><a name="GDK-PIXBUF-ROTATE-NONE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_NONE</code></span></p></td>
676
- <td>No rotation.
677
- </td>
729
+ <td class="parameter_name"><p>src</p></td>
730
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
731
+ <td class="parameter_annotations"> </td>
678
732
  </tr>
679
733
  <tr>
680
- <td><p><a name="GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE</code></span></p></td>
681
- <td>Rotate by 90 degrees.
682
- </td>
734
+ <td class="parameter_name"><p>angle</p></td>
735
+ <td class="parameter_description"><p>the angle to rotate by</p></td>
736
+ <td class="parameter_annotations"> </td>
683
737
  </tr>
738
+ </tbody>
739
+ </table></div>
740
+ </div>
741
+ <div class="refsect3">
742
+ <a name="id-1.2.10.7.7.6"></a><h4>Returns</h4>
743
+ <p> the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
744
+ allocated for it. </p>
745
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
746
+ </div>
747
+ <p class="since">Since 2.6</p>
748
+ </div>
749
+ <hr>
750
+ <div class="refsect2">
751
+ <a name="gdk-pixbuf-flip"></a><h3>gdk_pixbuf_flip ()</h3>
752
+ <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *
753
+ gdk_pixbuf_flip (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
754
+ <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> horizontal</code></em>);</pre>
755
+ <p>Flips a pixbuf horizontally or vertically and returns the
756
+ result in a new pixbuf.</p>
757
+ <div class="refsect3">
758
+ <a name="id-1.2.10.7.8.5"></a><h4>Parameters</h4>
759
+ <div class="informaltable"><table width="100%" border="0">
760
+ <colgroup>
761
+ <col width="150px" class="parameters_name">
762
+ <col class="parameters_description">
763
+ <col width="200px" class="parameters_annotations">
764
+ </colgroup>
765
+ <tbody>
684
766
  <tr>
685
- <td><p><a name="GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_UPSIDEDOWN</code></span></p></td>
686
- <td>Rotate by 180 degrees.
687
- </td>
767
+ <td class="parameter_name"><p>src</p></td>
768
+ <td class="parameter_description"><p>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a></p></td>
769
+ <td class="parameter_annotations"> </td>
688
770
  </tr>
689
771
  <tr>
690
- <td><p><a name="GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS"></a><span class="term"><code class="literal">GDK_PIXBUF_ROTATE_CLOCKWISE</code></span></p></td>
691
- <td>Rotate by 270 degrees.
692
- </td>
772
+ <td class="parameter_name"><p>horizontal</p></td>
773
+ <td class="parameter_description"><p><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to flip horizontally, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to flip vertically</p></td>
774
+ <td class="parameter_annotations"> </td>
693
775
  </tr>
694
776
  </tbody>
695
777
  </table></div>
696
778
  </div>
697
- <hr>
779
+ <div class="refsect3">
780
+ <a name="id-1.2.10.7.8.6"></a><h4>Returns</h4>
781
+ <p> the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
782
+ allocated for it. </p>
783
+ <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
784
+ </div>
785
+ <p class="since">Since 2.6</p>
786
+ </div>
787
+ </div>
788
+ <div class="refsect1">
789
+ <a name="gdk-pixbuf-Scaling.other_details"></a><h2>Types and Values</h2>
698
790
  <div class="refsect2">
699
- <a name="gdk-pixbuf-rotate-simple"></a><h3>gdk_pixbuf_rotate_simple ()</h3>
700
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_rotate_simple (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
701
- <em class="parameter"><code><a class="link" href="gdk-pixbuf-Scaling.html#GdkPixbufRotation" title="enum GdkPixbufRotation"><span class="type">GdkPixbufRotation</span></a> angle</code></em>);</pre>
702
- <p>
703
- Rotates a pixbuf by a multiple of 90 degrees, and returns the
704
- result in a new pixbuf.
705
- </p>
706
- <div class="variablelist"><table border="0" class="variablelist">
791
+ <a name="GdkInterpType"></a><h3>enum GdkInterpType</h3>
792
+ <p>This enumeration describes the different interpolation modes that
793
+ can be used with the scaling functions. <em class="parameter"><code>GDK_INTERP_NEAREST</code></em>
794
+ is
795
+ the fastest scaling method, but has horrible quality when
796
+ scaling down. <em class="parameter"><code>GDK_INTERP_BILINEAR</code></em>
797
+ is the best choice if you
798
+ aren't sure what to choose, it has a good speed/quality balance.</p>
799
+ <p> &lt;note&gt;
800
+ Cubic filtering is missing from the list; hyperbolic
801
+ interpolation is just as fast and results in higher quality.
802
+ &lt;/note&gt;</p>
803
+ <div class="refsect3">
804
+ <a name="id-1.2.10.8.2.5"></a><h4>Members</h4>
805
+ <div class="informaltable"><table width="100%" border="0">
707
806
  <colgroup>
708
- <col align="left" valign="top">
709
- <col>
807
+ <col width="300px" class="enum_members_name">
808
+ <col class="enum_members_description">
809
+ <col width="200px" class="enum_members_annotations">
710
810
  </colgroup>
711
811
  <tbody>
712
812
  <tr>
713
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
714
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
813
+ <td class="enum_member_name"><p><a name="GDK-INTERP-NEAREST:CAPS"></a>GDK_INTERP_NEAREST</p></td>
814
+ <td class="enum_member_description">
815
+ <p>Nearest neighbor sampling; this is the fastest
816
+ and lowest quality mode. Quality is normally unacceptable when scaling
817
+ down, but may be OK when scaling up.</p>
818
+ </td>
819
+ <td class="enum_member_annotations"> </td>
820
+ </tr>
821
+ <tr>
822
+ <td class="enum_member_name"><p><a name="GDK-INTERP-TILES:CAPS"></a>GDK_INTERP_TILES</p></td>
823
+ <td class="enum_member_description">
824
+ <p>This is an accurate simulation of the PostScript
825
+ image operator without any interpolation enabled. Each pixel is
826
+ rendered as a tiny parallelogram of solid color, the edges of which
827
+ are implemented with antialiasing. It resembles nearest neighbor for
828
+ enlargement, and bilinear for reduction.</p>
715
829
  </td>
830
+ <td class="enum_member_annotations"> </td>
716
831
  </tr>
717
832
  <tr>
718
- <td><p><span class="term"><em class="parameter"><code>angle</code></em> :</span></p></td>
719
- <td>the angle to rotate by</td>
833
+ <td class="enum_member_name"><p><a name="GDK-INTERP-BILINEAR:CAPS"></a>GDK_INTERP_BILINEAR</p></td>
834
+ <td class="enum_member_description">
835
+ <p>Best quality/speed balance; use this mode by
836
+ default. Bilinear interpolation. For enlargement, it is
837
+ equivalent to point-sampling the ideal bilinear-interpolated image.
838
+ For reduction, it is equivalent to laying down small tiles and
839
+ integrating over the coverage area.</p>
840
+ </td>
841
+ <td class="enum_member_annotations"> </td>
720
842
  </tr>
721
843
  <tr>
722
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
723
- <td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
724
- allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
844
+ <td class="enum_member_name"><p><a name="GDK-INTERP-HYPER:CAPS"></a>GDK_INTERP_HYPER</p></td>
845
+ <td class="enum_member_description">
846
+ <p>This is the slowest and highest quality
847
+ reconstruction function. It is derived from the hyperbolic filters in
848
+ Wolberg's "Digital Image Warping", and is formally defined as the
849
+ hyperbolic-filter sampling the ideal hyperbolic-filter interpolated
850
+ image (the filter is designed to be idempotent for 1:1 pixel mapping).</p>
725
851
  </td>
852
+ <td class="enum_member_annotations"> </td>
726
853
  </tr>
727
854
  </tbody>
728
855
  </table></div>
729
- <p class="since">Since 2.6</p>
856
+ </div>
730
857
  </div>
731
858
  <hr>
732
859
  <div class="refsect2">
733
- <a name="gdk-pixbuf-flip"></a><h3>gdk_pixbuf_flip ()</h3>
734
- <pre class="programlisting"><a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> * gdk_pixbuf_flip (<em class="parameter"><code>const <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *src</code></em>,
735
- <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> horizontal</code></em>);</pre>
736
- <p>
737
- Flips a pixbuf horizontally or vertically and returns the
738
- result in a new pixbuf.
739
- </p>
740
- <div class="variablelist"><table border="0" class="variablelist">
860
+ <a name="GdkPixbufRotation"></a><h3>enum GdkPixbufRotation</h3>
861
+ <p>The possible rotations which can be passed to <a class="link" href="gdk-pixbuf-Scaling.html#gdk-pixbuf-rotate-simple" title="gdk_pixbuf_rotate_simple ()"><code class="function">gdk_pixbuf_rotate_simple()</code></a>.
862
+ To make them easier to use, their numerical values are the actual degrees.</p>
863
+ <div class="refsect3">
864
+ <a name="id-1.2.10.8.3.4"></a><h4>Members</h4>
865
+ <div class="informaltable"><table width="100%" border="0">
741
866
  <colgroup>
742
- <col align="left" valign="top">
743
- <col>
867
+ <col width="300px" class="enum_members_name">
868
+ <col class="enum_members_description">
869
+ <col width="200px" class="enum_members_annotations">
744
870
  </colgroup>
745
871
  <tbody>
746
872
  <tr>
747
- <td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
748
- <td>a <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>
873
+ <td class="enum_member_name"><p><a name="GDK-PIXBUF-ROTATE-NONE:CAPS"></a>GDK_PIXBUF_ROTATE_NONE</p></td>
874
+ <td class="enum_member_description">
875
+ <p>No rotation.</p>
749
876
  </td>
877
+ <td class="enum_member_annotations"> </td>
750
878
  </tr>
751
879
  <tr>
752
- <td><p><span class="term"><em class="parameter"><code>horizontal</code></em> :</span></p></td>
753
- <td>
754
- <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to flip horizontally, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to flip vertically</td>
880
+ <td class="enum_member_name"><p><a name="GDK-PIXBUF-ROTATE-COUNTERCLOCKWISE:CAPS"></a>GDK_PIXBUF_ROTATE_COUNTERCLOCKWISE</p></td>
881
+ <td class="enum_member_description">
882
+ <p>Rotate by 90 degrees.</p>
883
+ </td>
884
+ <td class="enum_member_annotations"> </td>
755
885
  </tr>
756
886
  <tr>
757
- <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
758
- <td>the new <a class="link" href="gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not enough memory could be
759
- allocated for it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
887
+ <td class="enum_member_name"><p><a name="GDK-PIXBUF-ROTATE-UPSIDEDOWN:CAPS"></a>GDK_PIXBUF_ROTATE_UPSIDEDOWN</p></td>
888
+ <td class="enum_member_description">
889
+ <p>Rotate by 180 degrees.</p>
760
890
  </td>
891
+ <td class="enum_member_annotations"> </td>
892
+ </tr>
893
+ <tr>
894
+ <td class="enum_member_name"><p><a name="GDK-PIXBUF-ROTATE-CLOCKWISE:CAPS"></a>GDK_PIXBUF_ROTATE_CLOCKWISE</p></td>
895
+ <td class="enum_member_description">
896
+ <p>Rotate by 270 degrees.</p>
897
+ </td>
898
+ <td class="enum_member_annotations"> </td>
761
899
  </tr>
762
900
  </tbody>
763
901
  </table></div>
764
- <p class="since">Since 2.6</p>
902
+ </div>
765
903
  </div>
766
904
  </div>
767
905
  <div class="refsect1">
768
906
  <a name="gdk-pixbuf-Scaling.see-also"></a><h2>See Also</h2>
769
- GdkRGB.
907
+ <p>&lt;link linkend="gdk-GdkRGB"&gt;GdkRGB&lt;/link&gt;.</p>
770
908
  </div>
771
909
  </div>
772
910
  <div class="footer">
773
911
  <hr>
774
- Generated by GTK-Doc V1.19.1</div>
912
+ Generated by GTK-Doc V1.20.1</div>
775
913
  </body>
776
914
  </html>