gdk_pixbuf2 2.2.0-x86-mingw32 → 2.2.1-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Rakefile +1 -1
- data/lib/2.0/gdk_pixbuf2.so +0 -0
- data/vendor/local/bin/gdk-pixbuf-csource.exe +0 -0
- data/vendor/local/bin/gdk-pixbuf-pixdata.exe +0 -0
- data/vendor/local/bin/gdk-pixbuf-query-loaders.exe +0 -0
- data/vendor/local/bin/libgdk_pixbuf-2.0-0.dll +0 -0
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-core.h +15 -30
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-features.h +23 -23
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-io.h +4 -4
- data/vendor/local/include/gdk-pixbuf-2.0/gdk-pixbuf/gdk-pixbuf-loader.h +1 -1
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.a +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.dll.a +0 -0
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders/libpixbufloader-svg.la +1 -1
- data/vendor/local/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache +81 -81
- data/vendor/local/lib/girepository-1.0/GdkPixbuf-2.0.typelib +0 -0
- data/vendor/local/lib/libgdk_pixbuf-2.0.dll.a +0 -0
- data/vendor/local/lib/libgdk_pixbuf-2.0.la +2 -2
- data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc +1 -1
- data/vendor/local/share/gir-1.0/GdkPixbuf-2.0.gir +338 -185
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/GdkPixbufLoader.html +55 -54
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/api-index-full.html +2 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Animations.html +63 -63
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-Loading.html +95 -88
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-File-saving.html +84 -84
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Image-Data-in-Memory.html +18 -18
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Inline-data.html +33 -32
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Module-Interface.html +60 -60
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Reference-Counting-and-Memory-Mangement.html +9 -9
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Scaling.html +19 -19
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html +116 -82
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Utilities.html +10 -10
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-Versioning.html +23 -23
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-X-Drawables-to-Pixbufs.html +3 -3
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-XlibRGB.html +5 -5
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/index.html +1 -1
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn01.html +1 -1
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/rn02.html +1 -2
- data/vendor/local/share/gtk-doc/html/gdk-pixbuf/style.css +13 -11
- data/vendor/local/share/locale/af/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ang/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ar/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/az/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/be@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/bn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/br/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/bs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/crh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/cs/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/csb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/cy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/dz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/en@shaw/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/en_CA/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/en_GB/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ga/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/gl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/gu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/hy/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ia/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/io/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/is/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/it/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ka/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/km/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/kn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ku/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/li/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/lt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/mai/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/mi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/mk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ml/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/mn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/mr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ms/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/my/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nds/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ne/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nn/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/nso/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/or/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ps/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ro/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/si/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sq/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/tg/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/th/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/tk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/tt/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/uz/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/wa/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/xh/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/yi/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gdk-pixbuf.mo +0 -0
- data/vendor/local/share/man/man1/gdk-pixbuf-csource.1 +1 -1
- data/vendor/local/share/man/man1/gdk-pixbuf-query-loaders.1 +1 -1
- metadata +11 -13
- data/lib/1.9/gdk_pixbuf2.so +0 -0
- data/lib/2.1/gdk_pixbuf2.so +0 -0
@@ -20,7 +20,7 @@ and/or use gtk-doc annotations. -->
|
|
20
20
|
glib:get-type="gdk_colorspace_get_type"
|
21
21
|
c:type="GdkColorspace">
|
22
22
|
<doc xml:space="preserve">This enumeration defines the color spaces that are supported by
|
23
|
-
the
|
23
|
+
the gdk-pixbuf library. Currently only RGB is supported.</doc>
|
24
24
|
<member name="rgb"
|
25
25
|
value="0"
|
26
26
|
c:identifier="GDK_COLORSPACE_RGB"
|
@@ -33,9 +33,9 @@ the &gdk-pixbuf; library. Currently only RGB is supported.</doc>
|
|
33
33
|
glib:get-type="gdk_interp_type_get_type"
|
34
34
|
c:type="GdkInterpType">
|
35
35
|
<doc xml:space="preserve">This enumeration describes the different interpolation modes that
|
36
|
-
can be used with the scaling functions. @GDK_INTERP_NEAREST is
|
37
|
-
the fastest scaling method, but has horrible quality when
|
38
|
-
scaling down. @GDK_INTERP_BILINEAR is the best choice if you
|
36
|
+
can be used with the scaling functions. @GDK_INTERP_NEAREST is
|
37
|
+
the fastest scaling method, but has horrible quality when
|
38
|
+
scaling down. @GDK_INTERP_BILINEAR is the best choice if you
|
39
39
|
aren't sure what to choose, it has a good speed/quality balance.
|
40
40
|
|
41
41
|
<note>
|
@@ -46,25 +46,39 @@ the &gdk-pixbuf; library. Currently only RGB is supported.</doc>
|
|
46
46
|
value="0"
|
47
47
|
c:identifier="GDK_INTERP_NEAREST"
|
48
48
|
glib:nick="nearest">
|
49
|
-
<doc xml:space="preserve">Nearest neighbor sampling; this is the fastest
|
49
|
+
<doc xml:space="preserve">Nearest neighbor sampling; this is the fastest
|
50
|
+
and lowest quality mode. Quality is normally unacceptable when scaling
|
51
|
+
down, but may be OK when scaling up.</doc>
|
50
52
|
</member>
|
51
53
|
<member name="tiles"
|
52
54
|
value="1"
|
53
55
|
c:identifier="GDK_INTERP_TILES"
|
54
56
|
glib:nick="tiles">
|
55
|
-
<doc xml:space="preserve">This is an accurate simulation of the PostScript
|
57
|
+
<doc xml:space="preserve">This is an accurate simulation of the PostScript
|
58
|
+
image operator without any interpolation enabled. Each pixel is
|
59
|
+
rendered as a tiny parallelogram of solid color, the edges of which
|
60
|
+
are implemented with antialiasing. It resembles nearest neighbor for
|
61
|
+
enlargement, and bilinear for reduction.</doc>
|
56
62
|
</member>
|
57
63
|
<member name="bilinear"
|
58
64
|
value="2"
|
59
65
|
c:identifier="GDK_INTERP_BILINEAR"
|
60
66
|
glib:nick="bilinear">
|
61
|
-
<doc xml:space="preserve">Best quality/speed balance; use this mode by
|
67
|
+
<doc xml:space="preserve">Best quality/speed balance; use this mode by
|
68
|
+
default. Bilinear interpolation. For enlargement, it is
|
69
|
+
equivalent to point-sampling the ideal bilinear-interpolated image.
|
70
|
+
For reduction, it is equivalent to laying down small tiles and
|
71
|
+
integrating over the coverage area.</doc>
|
62
72
|
</member>
|
63
73
|
<member name="hyper"
|
64
74
|
value="3"
|
65
75
|
c:identifier="GDK_INTERP_HYPER"
|
66
76
|
glib:nick="hyper">
|
67
|
-
<doc xml:space="preserve">This is the slowest and highest quality
|
77
|
+
<doc xml:space="preserve">This is the slowest and highest quality
|
78
|
+
reconstruction function. It is derived from the hyperbolic filters in
|
79
|
+
Wolberg's "Digital Image Warping", and is formally defined as the
|
80
|
+
hyperbolic-filter sampling the ideal hyperbolic-filter interpolated
|
81
|
+
image (the filter is designed to be idempotent for 1:1 pixel mapping).</doc>
|
68
82
|
</member>
|
69
83
|
</enumeration>
|
70
84
|
<constant name="PIXBUF_FEATURES_H"
|
@@ -79,22 +93,22 @@ the &gdk-pixbuf; library. Currently only RGB is supported.</doc>
|
|
79
93
|
<type name="gint" c:type="gint"/>
|
80
94
|
</constant>
|
81
95
|
<constant name="PIXBUF_MAJOR" value="2" c:type="GDK_PIXBUF_MAJOR">
|
82
|
-
<doc xml:space="preserve">Major version of
|
83
|
-
"0.8.
|
96
|
+
<doc xml:space="preserve">Major version of gdk-pixbuf library, that is the "0" in
|
97
|
+
"0.8.2" for example.</doc>
|
84
98
|
<type name="gint" c:type="gint"/>
|
85
99
|
</constant>
|
86
|
-
<constant name="PIXBUF_MICRO" value="
|
87
|
-
<doc xml:space="preserve">Micro version of
|
88
|
-
"0.8.
|
100
|
+
<constant name="PIXBUF_MICRO" value="8" c:type="GDK_PIXBUF_MICRO">
|
101
|
+
<doc xml:space="preserve">Micro version of gdk-pixbuf library, that is the "2" in
|
102
|
+
"0.8.2" for example.</doc>
|
89
103
|
<type name="gint" c:type="gint"/>
|
90
104
|
</constant>
|
91
105
|
<constant name="PIXBUF_MINOR" value="30" c:type="GDK_PIXBUF_MINOR">
|
92
|
-
<doc xml:space="preserve">Minor version of
|
93
|
-
"0.8.
|
106
|
+
<doc xml:space="preserve">Minor version of gdk-pixbuf library, that is the "8" in
|
107
|
+
"0.8.2" for example.</doc>
|
94
108
|
<type name="gint" c:type="gint"/>
|
95
109
|
</constant>
|
96
|
-
<constant name="PIXBUF_VERSION" value="2.30.
|
97
|
-
<doc xml:space="preserve">Contains the full version of the
|
110
|
+
<constant name="PIXBUF_VERSION" value="2.30.8" c:type="GDK_PIXBUF_VERSION">
|
111
|
+
<doc xml:space="preserve">Contains the full version of the gdk-pixbuf header as a string.
|
98
112
|
This is the version being compiled against; contrast with
|
99
113
|
#gdk_pixbuf_version.</doc>
|
100
114
|
<type name="utf8" c:type="gchar*"/>
|
@@ -111,7 +125,7 @@ This is the version being compiled against; contrast with
|
|
111
125
|
parent="GObject.Object"
|
112
126
|
glib:type-name="GdkPixbuf"
|
113
127
|
glib:get-type="gdk_pixbuf_get_type">
|
114
|
-
<doc xml:space="preserve">This is the main structure in the
|
128
|
+
<doc xml:space="preserve">This is the main structure in the gdk-pixbuf library. It is
|
115
129
|
used to represent images. It contains information about the
|
116
130
|
image's pixel data, its color space, bits per sample, width and
|
117
131
|
height, and the rowstride (the number of bytes between the start of
|
@@ -119,11 +133,12 @@ one row and the start of the next).</doc>
|
|
119
133
|
<implements name="Gio.Icon"/>
|
120
134
|
<implements name="Gio.LoadableIcon"/>
|
121
135
|
<constructor name="new" c:identifier="gdk_pixbuf_new">
|
122
|
-
<doc xml:space="preserve">Creates a new #GdkPixbuf structure and allocates a buffer for it. The
|
136
|
+
<doc xml:space="preserve">Creates a new #GdkPixbuf structure and allocates a buffer for it. The
|
123
137
|
buffer has an optimal rowstride. Note that the buffer is not cleared;
|
124
138
|
you will have to fill it completely yourself.</doc>
|
125
139
|
<return-value transfer-ownership="full">
|
126
|
-
<doc xml:space="preserve">A newly-created #GdkPixbuf with a reference count of 1, or
|
140
|
+
<doc xml:space="preserve">A newly-created #GdkPixbuf with a reference count of 1, or
|
141
|
+
%NULL if not enough memory could be allocated for the image buffer.</doc>
|
127
142
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
128
143
|
</return-value>
|
129
144
|
<parameters>
|
@@ -190,10 +205,12 @@ images with 8 bits per sample are supported.</doc>
|
|
190
205
|
</parameter>
|
191
206
|
<parameter name="destroy_fn"
|
192
207
|
transfer-ownership="none"
|
208
|
+
nullable="1"
|
193
209
|
allow-none="1"
|
194
210
|
scope="async"
|
195
211
|
closure="8">
|
196
|
-
<doc xml:space="preserve">Function used to free the data when the pixbuf's reference count
|
212
|
+
<doc xml:space="preserve">Function used to free the data when the pixbuf's reference count
|
213
|
+
drops to zero, or %NULL if the data should not be freed</doc>
|
197
214
|
<type name="PixbufDestroyNotify" c:type="GdkPixbufDestroyNotify"/>
|
198
215
|
</parameter>
|
199
216
|
<parameter name="destroy_fn_data" transfer-ownership="none">
|
@@ -277,32 +294,36 @@ it, so you can pass %FALSE for @copy_pixels. (If you pass `--rle` to
|
|
277
294
|
so using this option is generally a bad idea.)
|
278
295
|
|
279
296
|
If you create a pixbuf from const inline data compiled into your
|
280
|
-
program, it's probably safe to ignore errors and disable length checks,
|
297
|
+
program, it's probably safe to ignore errors and disable length checks,
|
281
298
|
since things will always succeed:
|
282
299
|
|[
|
283
300
|
pixbuf = gdk_pixbuf_new_from_inline (-1, myimage_inline, FALSE, NULL);
|
284
301
|
]|
|
285
302
|
|
286
|
-
For non-const inline data, you could get out of memory. For untrusted
|
287
|
-
inline data located at runtime, you could have corrupt inline data in
|
303
|
+
For non-const inline data, you could get out of memory. For untrusted
|
304
|
+
inline data located at runtime, you could have corrupt inline data in
|
288
305
|
addition.</doc>
|
289
306
|
<return-value transfer-ownership="full">
|
290
|
-
<doc xml:space="preserve">A newly-created #GdkPixbuf structure with a reference,
|
307
|
+
<doc xml:space="preserve">A newly-created #GdkPixbuf structure with a reference,
|
308
|
+
count of 1, or %NULL if an error occurred.</doc>
|
291
309
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
292
310
|
</return-value>
|
293
311
|
<parameters>
|
294
312
|
<parameter name="data_length" transfer-ownership="none">
|
295
|
-
<doc xml:space="preserve">Length in bytes of the @data argument or -1 to
|
313
|
+
<doc xml:space="preserve">Length in bytes of the @data argument or -1 to
|
314
|
+
disable length checks</doc>
|
296
315
|
<type name="gint" c:type="gint"/>
|
297
316
|
</parameter>
|
298
317
|
<parameter name="data" transfer-ownership="none">
|
299
|
-
<doc xml:space="preserve">Byte data containing a
|
318
|
+
<doc xml:space="preserve">Byte data containing a
|
319
|
+
serialized #GdkPixdata structure</doc>
|
300
320
|
<array length="0" zero-terminated="0" c:type="guint8*">
|
301
321
|
<type name="guint8" c:type="guint8"/>
|
302
322
|
</array>
|
303
323
|
</parameter>
|
304
324
|
<parameter name="copy_pixels" transfer-ownership="none">
|
305
|
-
<doc xml:space="preserve">Whether to copy the pixel data, or use direct pointers
|
325
|
+
<doc xml:space="preserve">Whether to copy the pixel data, or use direct pointers
|
326
|
+
@data for the resulting pixbuf</doc>
|
306
327
|
<type name="gboolean" c:type="gboolean"/>
|
307
328
|
</parameter>
|
308
329
|
</parameters>
|
@@ -316,7 +337,10 @@ addition.</doc>
|
|
316
337
|
The file format is detected automatically. If %NULL is returned, then
|
317
338
|
@error will be set.</doc>
|
318
339
|
<return-value transfer-ownership="full">
|
319
|
-
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
340
|
+
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
341
|
+
conditions occurred: the file could not be opened, the image format is
|
342
|
+
not supported, there was not enough memory to allocate the image buffer,
|
343
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
320
344
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
321
345
|
</return-value>
|
322
346
|
<parameters>
|
@@ -344,7 +368,10 @@ exact given width. When not preserving aspect ratio, a @width or
|
|
344
368
|
|
345
369
|
The stream is not closed.</doc>
|
346
370
|
<return-value transfer-ownership="full">
|
347
|
-
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
371
|
+
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
372
|
+
conditions occurred: the file could not be opened, the image format is
|
373
|
+
not supported, there was not enough memory to allocate the image buffer,
|
374
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
348
375
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
349
376
|
</return-value>
|
350
377
|
<parameters>
|
@@ -370,17 +397,20 @@ The stream is not closed.</doc>
|
|
370
397
|
c:identifier="gdk_pixbuf_new_from_stream"
|
371
398
|
version="2.14"
|
372
399
|
throws="1">
|
373
|
-
<doc xml:space="preserve">Creates a new pixbuf by loading an image from an input stream.
|
400
|
+
<doc xml:space="preserve">Creates a new pixbuf by loading an image from an input stream.
|
374
401
|
|
375
|
-
The file format is detected automatically. If %NULL is returned, then
|
402
|
+
The file format is detected automatically. If %NULL is returned, then
|
376
403
|
@error will be set. The @cancellable can be used to abort the operation
|
377
|
-
from another thread. If the operation was cancelled, the error
|
378
|
-
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
379
|
-
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
404
|
+
from another thread. If the operation was cancelled, the error
|
405
|
+
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
406
|
+
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
380
407
|
|
381
408
|
The stream is not closed.</doc>
|
382
409
|
<return-value transfer-ownership="full">
|
383
|
-
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
410
|
+
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
411
|
+
conditions occurred: the file could not be opened, the image format is
|
412
|
+
not supported, there was not enough memory to allocate the image buffer,
|
413
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
384
414
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
385
415
|
</return-value>
|
386
416
|
<parameters>
|
@@ -390,6 +420,7 @@ The stream is not closed.</doc>
|
|
390
420
|
</parameter>
|
391
421
|
<parameter name="cancellable"
|
392
422
|
transfer-ownership="none"
|
423
|
+
nullable="1"
|
393
424
|
allow-none="1">
|
394
425
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
395
426
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
@@ -400,24 +431,32 @@ The stream is not closed.</doc>
|
|
400
431
|
c:identifier="gdk_pixbuf_new_from_stream_at_scale"
|
401
432
|
version="2.14"
|
402
433
|
throws="1">
|
403
|
-
<doc xml:space="preserve">Creates a new pixbuf by loading an image from an input stream.
|
434
|
+
<doc xml:space="preserve">Creates a new pixbuf by loading an image from an input stream.
|
404
435
|
|
405
|
-
The file format is detected automatically. If %NULL is returned, then
|
436
|
+
The file format is detected automatically. If %NULL is returned, then
|
406
437
|
@error will be set. The @cancellable can be used to abort the operation
|
407
|
-
from another thread. If the operation was cancelled, the error
|
408
|
-
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
409
|
-
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
438
|
+
from another thread. If the operation was cancelled, the error
|
439
|
+
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
440
|
+
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
410
441
|
|
411
|
-
The image will be scaled to fit in the requested size, optionally
|
412
|
-
preserving the image's aspect ratio.
|
413
|
-
|
414
|
-
|
415
|
-
exact given
|
416
|
-
|
442
|
+
The image will be scaled to fit in the requested size, optionally
|
443
|
+
preserving the image's aspect ratio.
|
444
|
+
|
445
|
+
When preserving the aspect ratio, a @width of -1 will cause the image to be
|
446
|
+
scaled to the exact given height, and a @height of -1 will cause the image
|
447
|
+
to be scaled to the exact given width. If both @width and @height are
|
448
|
+
given, this function will behave as if the smaller of the two values
|
449
|
+
is passed as -1.
|
450
|
+
|
451
|
+
When not preserving aspect ratio, a @width or @height of -1 means to not
|
452
|
+
scale the image at all in that dimension.
|
417
453
|
|
418
454
|
The stream is not closed.</doc>
|
419
455
|
<return-value transfer-ownership="full">
|
420
|
-
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
456
|
+
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
457
|
+
conditions occurred: the file could not be opened, the image format is
|
458
|
+
not supported, there was not enough memory to allocate the image buffer,
|
459
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
421
460
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
422
461
|
</return-value>
|
423
462
|
<parameters>
|
@@ -439,6 +478,7 @@ The stream is not closed.</doc>
|
|
439
478
|
</parameter>
|
440
479
|
<parameter name="cancellable"
|
441
480
|
transfer-ownership="none"
|
481
|
+
nullable="1"
|
442
482
|
allow-none="1">
|
443
483
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
444
484
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
@@ -452,7 +492,8 @@ The stream is not closed.</doc>
|
|
452
492
|
<doc xml:space="preserve">Finishes an asynchronous pixbuf creation operation started with
|
453
493
|
gdk_pixbuf_new_from_stream_async().</doc>
|
454
494
|
<return-value transfer-ownership="full">
|
455
|
-
<doc xml:space="preserve">a #GdkPixbuf or %NULL on error. Free the returned
|
495
|
+
<doc xml:space="preserve">a #GdkPixbuf or %NULL on error. Free the returned
|
496
|
+
object with g_object_unref().</doc>
|
456
497
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
457
498
|
</return-value>
|
458
499
|
<parameters>
|
@@ -495,7 +536,8 @@ newly-allocated memory; otherwise it is reused.</doc>
|
|
495
536
|
<type name="Pixdata" c:type="const GdkPixdata*"/>
|
496
537
|
</parameter>
|
497
538
|
<parameter name="copy_pixels" transfer-ownership="none">
|
498
|
-
<doc xml:space="preserve">whether to copy raw pixel data; run-length encoded
|
539
|
+
<doc xml:space="preserve">whether to copy raw pixel data; run-length encoded
|
540
|
+
pixel data is always copied.</doc>
|
499
541
|
<type name="gboolean" c:type="gboolean"/>
|
500
542
|
</parameter>
|
501
543
|
</parameters>
|
@@ -504,8 +546,11 @@ newly-allocated memory; otherwise it is reused.</doc>
|
|
504
546
|
c:identifier="gdk_pixbuf_get_file_info"
|
505
547
|
version="2.4">
|
506
548
|
<doc xml:space="preserve">Parses an image file far enough to determine its format and size.</doc>
|
507
|
-
<return-value transfer-ownership="none">
|
508
|
-
<doc xml:space="preserve">A #GdkPixbufFormat describing
|
549
|
+
<return-value transfer-ownership="none" nullable="1">
|
550
|
+
<doc xml:space="preserve">A #GdkPixbufFormat describing
|
551
|
+
the image format of the file or %NULL if the image format wasn't
|
552
|
+
recognized. The return value is owned by #GdkPixbuf and should
|
553
|
+
not be freed.</doc>
|
509
554
|
<type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
|
510
555
|
</return-value>
|
511
556
|
<parameters>
|
@@ -516,15 +561,21 @@ newly-allocated memory; otherwise it is reused.</doc>
|
|
516
561
|
<parameter name="width"
|
517
562
|
direction="out"
|
518
563
|
caller-allocates="0"
|
519
|
-
transfer-ownership="full"
|
520
|
-
|
564
|
+
transfer-ownership="full"
|
565
|
+
optional="1"
|
566
|
+
allow-none="1">
|
567
|
+
<doc xml:space="preserve">Return location for the width of the
|
568
|
+
image, or %NULL</doc>
|
521
569
|
<type name="gint" c:type="gint*"/>
|
522
570
|
</parameter>
|
523
571
|
<parameter name="height"
|
524
572
|
direction="out"
|
525
573
|
caller-allocates="0"
|
526
|
-
transfer-ownership="full"
|
527
|
-
|
574
|
+
transfer-ownership="full"
|
575
|
+
optional="1"
|
576
|
+
allow-none="1">
|
577
|
+
<doc xml:space="preserve">Return location for the height of the
|
578
|
+
image, or %NULL</doc>
|
528
579
|
<type name="gint" c:type="gint*"/>
|
529
580
|
</parameter>
|
530
581
|
</parameters>
|
@@ -535,7 +586,10 @@ newly-allocated memory; otherwise it is reused.</doc>
|
|
535
586
|
<doc xml:space="preserve">Obtains the available information about the image formats supported
|
536
587
|
by GdkPixbuf.</doc>
|
537
588
|
<return-value transfer-ownership="container">
|
538
|
-
<doc xml:space="preserve">A list of
|
589
|
+
<doc xml:space="preserve">A list of
|
590
|
+
#GdkPixbufFormats describing the supported image formats. The list should
|
591
|
+
be freed when it is no longer needed, but the structures themselves are
|
592
|
+
owned by #GdkPixbuf and should not be freed.</doc>
|
539
593
|
<type name="GLib.SList" c:type="GSList*">
|
540
594
|
<type name="PixbufFormat"/>
|
541
595
|
</type>
|
@@ -571,12 +625,14 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
|
|
571
625
|
</parameter>
|
572
626
|
<parameter name="cancellable"
|
573
627
|
transfer-ownership="none"
|
628
|
+
nullable="1"
|
574
629
|
allow-none="1">
|
575
630
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
576
631
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
577
632
|
</parameter>
|
578
633
|
<parameter name="callback"
|
579
634
|
transfer-ownership="none"
|
635
|
+
nullable="1"
|
580
636
|
allow-none="1"
|
581
637
|
scope="async"
|
582
638
|
closure="3">
|
@@ -621,12 +677,14 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
|
|
621
677
|
</parameter>
|
622
678
|
<parameter name="cancellable"
|
623
679
|
transfer-ownership="none"
|
680
|
+
nullable="1"
|
624
681
|
allow-none="1">
|
625
682
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
626
683
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
627
684
|
</parameter>
|
628
685
|
<parameter name="callback"
|
629
686
|
transfer-ownership="none"
|
687
|
+
nullable="1"
|
630
688
|
allow-none="1"
|
631
689
|
scope="async"
|
632
690
|
closure="6">
|
@@ -675,7 +733,8 @@ substitute color, all white pixels will become fully transparent.</doc>
|
|
675
733
|
<type name="Pixbuf" c:type="const GdkPixbuf*"/>
|
676
734
|
</instance-parameter>
|
677
735
|
<parameter name="substitute_color" transfer-ownership="none">
|
678
|
-
<doc xml:space="preserve">Whether to set a color to zero opacity. If this
|
736
|
+
<doc xml:space="preserve">Whether to set a color to zero opacity. If this
|
737
|
+
is %FALSE, then the (@r, @g, @b) arguments will be ignored.</doc>
|
679
738
|
<type name="gboolean" c:type="gboolean"/>
|
680
739
|
</parameter>
|
681
740
|
<parameter name="r" transfer-ownership="none">
|
@@ -696,15 +755,16 @@ substitute color, all white pixels will become fully transparent.</doc>
|
|
696
755
|
c:identifier="gdk_pixbuf_apply_embedded_orientation"
|
697
756
|
version="2.12">
|
698
757
|
<doc xml:space="preserve">Takes an existing pixbuf and checks for the presence of an
|
699
|
-
associated "orientation" option, which may be provided by the
|
700
|
-
jpeg loader (which reads the exif orientation tag) or the
|
758
|
+
associated "orientation" option, which may be provided by the
|
759
|
+
jpeg loader (which reads the exif orientation tag) or the
|
701
760
|
tiff loader (which reads the tiff orientation tag, and
|
702
|
-
compensates it for the partial transforms performed by
|
761
|
+
compensates it for the partial transforms performed by
|
703
762
|
libtiff). If an orientation option/tag is present, the
|
704
763
|
appropriate transform will be performed so that the pixbuf
|
705
764
|
is oriented correctly.</doc>
|
706
765
|
<return-value transfer-ownership="full">
|
707
|
-
<doc xml:space="preserve">A newly-created pixbuf, or a reference to the
|
766
|
+
<doc xml:space="preserve">A newly-created pixbuf, or a reference to the
|
767
|
+
input pixbuf (with an increased reference count).</doc>
|
708
768
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
709
769
|
</return-value>
|
710
770
|
<parameters>
|
@@ -722,9 +782,9 @@ The rectangle (@dest_x, @dest_y, @dest_width, @dest_height)
|
|
722
782
|
is then composited onto the corresponding rectangle of the
|
723
783
|
original destination image.
|
724
784
|
|
725
|
-
When the destination rectangle contains parts not in the source
|
785
|
+
When the destination rectangle contains parts not in the source
|
726
786
|
image, the data at the edges of the source image is replicated
|
727
|
-
to infinity.
|
787
|
+
to infinity.
|
728
788
|
|
729
789
|
</doc>
|
730
790
|
<return-value transfer-ownership="none">
|
@@ -871,7 +931,8 @@ function suitable for many tasks.</doc>
|
|
871
931
|
@dest_height and compositing the result with a checkboard of colors
|
872
932
|
@color1 and @color2.</doc>
|
873
933
|
<return-value transfer-ownership="full">
|
874
|
-
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
|
934
|
+
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
|
935
|
+
allocated for it.</doc>
|
875
936
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
876
937
|
</return-value>
|
877
938
|
<parameters>
|
@@ -913,7 +974,8 @@ function suitable for many tasks.</doc>
|
|
913
974
|
<doc xml:space="preserve">Creates a new #GdkPixbuf with a copy of the information in the specified
|
914
975
|
@pixbuf.</doc>
|
915
976
|
<return-value transfer-ownership="full">
|
916
|
-
<doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL if
|
977
|
+
<doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL if
|
978
|
+
not enough memory could be allocated.</doc>
|
917
979
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
918
980
|
</return-value>
|
919
981
|
<parameters>
|
@@ -981,7 +1043,8 @@ doesn't have an alpha channel.</doc>
|
|
981
1043
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
982
1044
|
</instance-parameter>
|
983
1045
|
<parameter name="pixel" transfer-ownership="none">
|
984
|
-
<doc xml:space="preserve">RGBA pixel to clear to
|
1046
|
+
<doc xml:space="preserve">RGBA pixel to clear to
|
1047
|
+
(0xffffffff is opaque white, 0x00000000 transparent black)</doc>
|
985
1048
|
<type name="guint32" c:type="guint32"/>
|
986
1049
|
</parameter>
|
987
1050
|
</parameters>
|
@@ -989,8 +1052,9 @@ doesn't have an alpha channel.</doc>
|
|
989
1052
|
<method name="flip" c:identifier="gdk_pixbuf_flip" version="2.6">
|
990
1053
|
<doc xml:space="preserve">Flips a pixbuf horizontally or vertically and returns the
|
991
1054
|
result in a new pixbuf.</doc>
|
992
|
-
<return-value transfer-ownership="full">
|
993
|
-
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL
|
1055
|
+
<return-value transfer-ownership="full" nullable="1">
|
1056
|
+
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL
|
1057
|
+
if not enough memory could be allocated for it.</doc>
|
994
1058
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
995
1059
|
</return-value>
|
996
1060
|
<parameters>
|
@@ -1090,14 +1154,15 @@ result in a new pixbuf.</doc>
|
|
1090
1154
|
@pixbuf when it was loaded, or that may have been attached by another
|
1091
1155
|
function using gdk_pixbuf_set_option().
|
1092
1156
|
|
1093
|
-
For instance, the ANI loader provides "Title" and "Artist" options.
|
1094
|
-
The ICO, XBM, and XPM loaders provide "x_hot" and "y_hot" hot-spot
|
1157
|
+
For instance, the ANI loader provides "Title" and "Artist" options.
|
1158
|
+
The ICO, XBM, and XPM loaders provide "x_hot" and "y_hot" hot-spot
|
1095
1159
|
options for cursor definitions. The PNG loader provides the tEXt ancillary
|
1096
1160
|
chunk key/value pairs as options. Since 2.12, the TIFF and JPEG loaders
|
1097
|
-
return an "orientation" option string that corresponds to the embedded
|
1161
|
+
return an "orientation" option string that corresponds to the embedded
|
1098
1162
|
TIFF/Exif orientation tag (if present).</doc>
|
1099
1163
|
<return-value transfer-ownership="none">
|
1100
|
-
<doc xml:space="preserve">the value associated with @key. This is a nul-terminated
|
1164
|
+
<doc xml:space="preserve">the value associated with @key. This is a nul-terminated
|
1165
|
+
string that should not be freed or %NULL if @key was not found.</doc>
|
1101
1166
|
<type name="utf8" c:type="const gchar*"/>
|
1102
1167
|
</return-value>
|
1103
1168
|
<parameters>
|
@@ -1116,7 +1181,9 @@ TIFF/Exif orientation tag (if present).</doc>
|
|
1116
1181
|
shadowed-by="get_pixels_with_length">
|
1117
1182
|
<doc xml:space="preserve">Queries a pointer to the pixel data of a pixbuf.</doc>
|
1118
1183
|
<return-value transfer-ownership="none">
|
1119
|
-
<doc xml:space="preserve">A pointer to the pixbuf's pixel data.
|
1184
|
+
<doc xml:space="preserve">A pointer to the pixbuf's pixel data.
|
1185
|
+
Please see the section on [image data](image-data) for information
|
1186
|
+
about how the pixel data is stored in memory.</doc>
|
1120
1187
|
<array zero-terminated="0" c:type="guchar*">
|
1121
1188
|
<type name="guint8" c:type="guchar"/>
|
1122
1189
|
</array>
|
@@ -1134,7 +1201,9 @@ TIFF/Exif orientation tag (if present).</doc>
|
|
1134
1201
|
version="2.26">
|
1135
1202
|
<doc xml:space="preserve">Queries a pointer to the pixel data of a pixbuf.</doc>
|
1136
1203
|
<return-value transfer-ownership="none">
|
1137
|
-
<doc xml:space="preserve">A pointer to the pixbuf's
|
1204
|
+
<doc xml:space="preserve">A pointer to the pixbuf's
|
1205
|
+
pixel data. Please see the section on [image data](image-data)
|
1206
|
+
for information about how the pixel data is stored in memory.</doc>
|
1138
1207
|
<array length="0" zero-terminated="0" c:type="guchar*">
|
1139
1208
|
<type name="guint8" c:type="guchar"/>
|
1140
1209
|
</array>
|
@@ -1217,9 +1286,10 @@ is finalized.</doc>
|
|
1217
1286
|
<method name="ref"
|
1218
1287
|
c:identifier="gdk_pixbuf_ref"
|
1219
1288
|
introspectable="0"
|
1220
|
-
deprecated="
|
1289
|
+
deprecated="1"
|
1221
1290
|
deprecated-version="2.0">
|
1222
1291
|
<doc xml:space="preserve">Adds a reference to a pixbuf.</doc>
|
1292
|
+
<doc-deprecated xml:space="preserve">Use g_object_ref().</doc-deprecated>
|
1223
1293
|
<return-value>
|
1224
1294
|
<doc xml:space="preserve">The same as the @pixbuf argument.</doc>
|
1225
1295
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
@@ -1236,8 +1306,9 @@ is finalized.</doc>
|
|
1236
1306
|
version="2.6">
|
1237
1307
|
<doc xml:space="preserve">Rotates a pixbuf by a multiple of 90 degrees, and returns the
|
1238
1308
|
result in a new pixbuf.</doc>
|
1239
|
-
<return-value transfer-ownership="full">
|
1240
|
-
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL
|
1309
|
+
<return-value transfer-ownership="full" nullable="1">
|
1310
|
+
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL
|
1311
|
+
if not enough memory could be allocated for it.</doc>
|
1241
1312
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
1242
1313
|
</return-value>
|
1243
1314
|
<parameters>
|
@@ -1289,7 +1360,7 @@ rowstride.</doc>
|
|
1289
1360
|
introspectable="0">
|
1290
1361
|
<doc xml:space="preserve">Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
|
1291
1362
|
"png", "tiff", "ico" or "bmp". This is a convenience function that uses
|
1292
|
-
gdk_pixbuf_save_to_callback() to do the real work. Note that the buffer
|
1363
|
+
gdk_pixbuf_save_to_callback() to do the real work. Note that the buffer
|
1293
1364
|
is not nul-terminated and may contain embedded nuls.
|
1294
1365
|
If @error is set, %FALSE will be returned and @buffer will be set to
|
1295
1366
|
%NULL. Possible errors include those in the #GDK_PIXBUF_ERROR
|
@@ -1309,7 +1380,8 @@ See gdk_pixbuf_save() for more details.</doc>
|
|
1309
1380
|
direction="out"
|
1310
1381
|
caller-allocates="0"
|
1311
1382
|
transfer-ownership="full">
|
1312
|
-
<doc xml:space="preserve">location to receive a pointer
|
1383
|
+
<doc xml:space="preserve">location to receive a pointer
|
1384
|
+
to the new buffer.</doc>
|
1313
1385
|
<array length="1" zero-terminated="0" c:type="gchar**">
|
1314
1386
|
<type name="guint8"/>
|
1315
1387
|
</array>
|
@@ -1325,13 +1397,16 @@ See gdk_pixbuf_save() for more details.</doc>
|
|
1325
1397
|
<doc xml:space="preserve">name of file format.</doc>
|
1326
1398
|
<type name="utf8" c:type="const char*"/>
|
1327
1399
|
</parameter>
|
1328
|
-
<parameter name="error"
|
1400
|
+
<parameter name="error"
|
1401
|
+
transfer-ownership="none"
|
1402
|
+
nullable="1"
|
1403
|
+
allow-none="1">
|
1329
1404
|
<doc xml:space="preserve">return location for error, or %NULL</doc>
|
1330
1405
|
<type name="GLib.Error" c:type="GError**"/>
|
1331
1406
|
</parameter>
|
1332
|
-
<parameter name="
|
1333
|
-
<
|
1334
|
-
|
1407
|
+
<parameter name="..." transfer-ownership="none">
|
1408
|
+
<doc xml:space="preserve">list of key-value save options</doc>
|
1409
|
+
<varargs/>
|
1335
1410
|
</parameter>
|
1336
1411
|
</parameters>
|
1337
1412
|
</method>
|
@@ -1340,7 +1415,7 @@ See gdk_pixbuf_save() for more details.</doc>
|
|
1340
1415
|
version="2.4"
|
1341
1416
|
throws="1">
|
1342
1417
|
<doc xml:space="preserve">Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
|
1343
|
-
"tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer()
|
1418
|
+
"tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer()
|
1344
1419
|
for more details.</doc>
|
1345
1420
|
<return-value transfer-ownership="none">
|
1346
1421
|
<doc xml:space="preserve">whether an error was set</doc>
|
@@ -1355,7 +1430,8 @@ for more details.</doc>
|
|
1355
1430
|
direction="out"
|
1356
1431
|
caller-allocates="0"
|
1357
1432
|
transfer-ownership="full">
|
1358
|
-
<doc xml:space="preserve">
|
1433
|
+
<doc xml:space="preserve">
|
1434
|
+
location to receive a pointer to the new buffer.</doc>
|
1359
1435
|
<array length="1" zero-terminated="0" c:type="gchar**">
|
1360
1436
|
<type name="guint8"/>
|
1361
1437
|
</array>
|
@@ -1389,9 +1465,9 @@ for more details.</doc>
|
|
1389
1465
|
c:identifier="gdk_pixbuf_save_to_callback"
|
1390
1466
|
version="2.4"
|
1391
1467
|
introspectable="0">
|
1392
|
-
<doc xml:space="preserve">Saves pixbuf in format @type by feeding the produced data to a
|
1393
|
-
callback. Can be used when you want to store the image to something
|
1394
|
-
other than a file, such as an in-memory buffer or a socket.
|
1468
|
+
<doc xml:space="preserve">Saves pixbuf in format @type by feeding the produced data to a
|
1469
|
+
callback. Can be used when you want to store the image to something
|
1470
|
+
other than a file, such as an in-memory buffer or a socket.
|
1395
1471
|
If @error is set, %FALSE will be returned. Possible errors
|
1396
1472
|
include those in the #GDK_PIXBUF_ERROR domain and whatever the save
|
1397
1473
|
function generates.
|
@@ -1410,7 +1486,8 @@ See gdk_pixbuf_save() for more details.</doc>
|
|
1410
1486
|
transfer-ownership="none"
|
1411
1487
|
scope="call"
|
1412
1488
|
closure="1">
|
1413
|
-
<doc xml:space="preserve">a function that is called to save each block of data that
|
1489
|
+
<doc xml:space="preserve">a function that is called to save each block of data that
|
1490
|
+
the save routine generates.</doc>
|
1414
1491
|
<type name="PixbufSaveFunc" c:type="GdkPixbufSaveFunc"/>
|
1415
1492
|
</parameter>
|
1416
1493
|
<parameter name="user_data" transfer-ownership="none">
|
@@ -1421,13 +1498,16 @@ See gdk_pixbuf_save() for more details.</doc>
|
|
1421
1498
|
<doc xml:space="preserve">name of file format.</doc>
|
1422
1499
|
<type name="utf8" c:type="const char*"/>
|
1423
1500
|
</parameter>
|
1424
|
-
<parameter name="error"
|
1501
|
+
<parameter name="error"
|
1502
|
+
transfer-ownership="none"
|
1503
|
+
nullable="1"
|
1504
|
+
allow-none="1">
|
1425
1505
|
<doc xml:space="preserve">return location for error, or %NULL</doc>
|
1426
1506
|
<type name="GLib.Error" c:type="GError**"/>
|
1427
1507
|
</parameter>
|
1428
|
-
<parameter name="
|
1429
|
-
<
|
1430
|
-
|
1508
|
+
<parameter name="..." transfer-ownership="none">
|
1509
|
+
<doc xml:space="preserve">list of key-value save options</doc>
|
1510
|
+
<varargs/>
|
1431
1511
|
</parameter>
|
1432
1512
|
</parameters>
|
1433
1513
|
</method>
|
@@ -1451,7 +1531,8 @@ gdk_pixbuf_save_to_callback () for more details.</doc>
|
|
1451
1531
|
transfer-ownership="none"
|
1452
1532
|
scope="call"
|
1453
1533
|
closure="1">
|
1454
|
-
<doc xml:space="preserve">a function that is called to save each block of data that
|
1534
|
+
<doc xml:space="preserve">a function that is called to save each block of data that
|
1535
|
+
the save routine generates.</doc>
|
1455
1536
|
<type name="PixbufSaveFunc" c:type="GdkPixbufSaveFunc"/>
|
1456
1537
|
</parameter>
|
1457
1538
|
<parameter name="user_data" transfer-ownership="none">
|
@@ -1482,17 +1563,18 @@ gdk_pixbuf_save_to_callback () for more details.</doc>
|
|
1482
1563
|
introspectable="0">
|
1483
1564
|
<doc xml:space="preserve">Saves @pixbuf to an output stream.
|
1484
1565
|
|
1485
|
-
Supported file formats are currently "jpeg", "tiff", "png", "ico" or
|
1566
|
+
Supported file formats are currently "jpeg", "tiff", "png", "ico" or
|
1486
1567
|
"bmp". See gdk_pixbuf_save_to_buffer() for more details.
|
1487
1568
|
|
1488
|
-
The @cancellable can be used to abort the operation from another
|
1489
|
-
thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED
|
1490
|
-
will be returned. Other possible errors are in the #GDK_PIXBUF_ERROR
|
1491
|
-
and %G_IO_ERROR domains.
|
1569
|
+
The @cancellable can be used to abort the operation from another
|
1570
|
+
thread. If the operation was cancelled, the error %G_IO_ERROR_CANCELLED
|
1571
|
+
will be returned. Other possible errors are in the #GDK_PIXBUF_ERROR
|
1572
|
+
and %G_IO_ERROR domains.
|
1492
1573
|
|
1493
1574
|
The stream is not closed.</doc>
|
1494
1575
|
<return-value transfer-ownership="none">
|
1495
|
-
<doc xml:space="preserve">%TRUE if the pixbuf was saved successfully, %FALSE if an
|
1576
|
+
<doc xml:space="preserve">%TRUE if the pixbuf was saved successfully, %FALSE if an
|
1577
|
+
error was set.</doc>
|
1496
1578
|
<type name="gboolean" c:type="gboolean"/>
|
1497
1579
|
</return-value>
|
1498
1580
|
<parameters>
|
@@ -1510,17 +1592,21 @@ The stream is not closed.</doc>
|
|
1510
1592
|
</parameter>
|
1511
1593
|
<parameter name="cancellable"
|
1512
1594
|
transfer-ownership="none"
|
1595
|
+
nullable="1"
|
1513
1596
|
allow-none="1">
|
1514
1597
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
1515
1598
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
1516
1599
|
</parameter>
|
1517
|
-
<parameter name="error"
|
1600
|
+
<parameter name="error"
|
1601
|
+
transfer-ownership="none"
|
1602
|
+
nullable="1"
|
1603
|
+
allow-none="1">
|
1518
1604
|
<doc xml:space="preserve">return location for error, or %NULL</doc>
|
1519
1605
|
<type name="GLib.Error" c:type="GError**"/>
|
1520
1606
|
</parameter>
|
1521
|
-
<parameter name="
|
1522
|
-
<
|
1523
|
-
|
1607
|
+
<parameter name="..." transfer-ownership="none">
|
1608
|
+
<doc xml:space="preserve">list of key-value save options</doc>
|
1609
|
+
<varargs/>
|
1524
1610
|
</parameter>
|
1525
1611
|
</parameters>
|
1526
1612
|
</method>
|
@@ -1553,12 +1639,14 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
|
|
1553
1639
|
</parameter>
|
1554
1640
|
<parameter name="cancellable"
|
1555
1641
|
transfer-ownership="none"
|
1642
|
+
nullable="1"
|
1556
1643
|
allow-none="1">
|
1557
1644
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
1558
1645
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
1559
1646
|
</parameter>
|
1560
1647
|
<parameter name="callback"
|
1561
1648
|
transfer-ownership="none"
|
1649
|
+
nullable="1"
|
1562
1650
|
allow-none="1"
|
1563
1651
|
scope="async"
|
1564
1652
|
closure="4">
|
@@ -1569,9 +1657,9 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
|
|
1569
1657
|
<doc xml:space="preserve">the data to pass to the callback function</doc>
|
1570
1658
|
<type name="gpointer" c:type="gpointer"/>
|
1571
1659
|
</parameter>
|
1572
|
-
<parameter name="
|
1573
|
-
<
|
1574
|
-
|
1660
|
+
<parameter name="..." transfer-ownership="none">
|
1661
|
+
<doc xml:space="preserve">list of key-value save options</doc>
|
1662
|
+
<varargs/>
|
1575
1663
|
</parameter>
|
1576
1664
|
</parameters>
|
1577
1665
|
</method>
|
@@ -1594,9 +1682,8 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
|
|
1594
1682
|
<parameter name="error" transfer-ownership="none">
|
1595
1683
|
<type name="GLib.Error" c:type="GError**"/>
|
1596
1684
|
</parameter>
|
1597
|
-
<parameter name="
|
1598
|
-
<varargs
|
1599
|
-
</varargs>
|
1685
|
+
<parameter name="..." transfer-ownership="none">
|
1686
|
+
<varargs/>
|
1600
1687
|
</parameter>
|
1601
1688
|
</parameters>
|
1602
1689
|
</method>
|
@@ -1702,7 +1789,8 @@ pointing into @src; see gdk_pixbuf_new_subpixbuf().
|
|
1702
1789
|
For more complicated scaling/compositing see gdk_pixbuf_scale()
|
1703
1790
|
and gdk_pixbuf_composite().</doc>
|
1704
1791
|
<return-value transfer-ownership="full">
|
1705
|
-
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
|
1792
|
+
<doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
|
1793
|
+
allocated for it.</doc>
|
1706
1794
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
1707
1795
|
</return-value>
|
1708
1796
|
<parameters>
|
@@ -1727,9 +1815,10 @@ and gdk_pixbuf_composite().</doc>
|
|
1727
1815
|
<method name="unref"
|
1728
1816
|
c:identifier="gdk_pixbuf_unref"
|
1729
1817
|
introspectable="0"
|
1730
|
-
deprecated="
|
1818
|
+
deprecated="1"
|
1731
1819
|
deprecated-version="2.0">
|
1732
1820
|
<doc xml:space="preserve">Removes a reference from a pixbuf.</doc>
|
1821
|
+
<doc-deprecated xml:space="preserve">Use g_object_unref().</doc-deprecated>
|
1733
1822
|
<return-value transfer-ownership="none">
|
1734
1823
|
<type name="none" c:type="void"/>
|
1735
1824
|
</return-value>
|
@@ -1744,7 +1833,7 @@ and gdk_pixbuf_composite().</doc>
|
|
1744
1833
|
writable="1"
|
1745
1834
|
construct-only="1"
|
1746
1835
|
transfer-ownership="none">
|
1747
|
-
<doc xml:space="preserve">The number of bits per sample.
|
1836
|
+
<doc xml:space="preserve">The number of bits per sample.
|
1748
1837
|
Currently only 8 bit per sample are supported.</doc>
|
1749
1838
|
<type name="gint" c:type="gint"/>
|
1750
1839
|
</property>
|
@@ -1770,7 +1859,7 @@ Currently only 8 bit per sample are supported.</doc>
|
|
1770
1859
|
writable="1"
|
1771
1860
|
construct-only="1"
|
1772
1861
|
transfer-ownership="none">
|
1773
|
-
<doc xml:space="preserve">The number of samples per pixel.
|
1862
|
+
<doc xml:space="preserve">The number of samples per pixel.
|
1774
1863
|
Currently, only 3 or 4 samples per pixel are supported.</doc>
|
1775
1864
|
<type name="gint" c:type="gint"/>
|
1776
1865
|
</property>
|
@@ -1784,7 +1873,7 @@ Currently, only 3 or 4 samples per pixel are supported.</doc>
|
|
1784
1873
|
writable="1"
|
1785
1874
|
construct-only="1"
|
1786
1875
|
transfer-ownership="none">
|
1787
|
-
<doc xml:space="preserve">The number of bytes between the start of a row and
|
1876
|
+
<doc xml:space="preserve">The number of bytes between the start of a row and
|
1788
1877
|
the start of the next row. This number must (obviously)
|
1789
1878
|
be at least as large as the width of the pixbuf.</doc>
|
1790
1879
|
<type name="gint" c:type="gint"/>
|
@@ -1812,13 +1901,17 @@ back to a bilevel clipping mask.</doc>
|
|
1812
1901
|
value="0"
|
1813
1902
|
c:identifier="GDK_PIXBUF_ALPHA_BILEVEL"
|
1814
1903
|
glib:nick="bilevel">
|
1815
|
-
<doc xml:space="preserve">A bilevel clipping mask (black and white)
|
1904
|
+
<doc xml:space="preserve">A bilevel clipping mask (black and white)
|
1905
|
+
will be created and used to draw the image. Pixels below 0.5 opacity
|
1906
|
+
will be considered fully transparent, and all others will be
|
1907
|
+
considered fully opaque.</doc>
|
1816
1908
|
</member>
|
1817
1909
|
<member name="full"
|
1818
1910
|
value="1"
|
1819
1911
|
c:identifier="GDK_PIXBUF_ALPHA_FULL"
|
1820
1912
|
glib:nick="full">
|
1821
|
-
<doc xml:space="preserve">For now falls back to #GDK_PIXBUF_ALPHA_BILEVEL.
|
1913
|
+
<doc xml:space="preserve">For now falls back to #GDK_PIXBUF_ALPHA_BILEVEL.
|
1914
|
+
In the future it will do full alpha compositing.</doc>
|
1822
1915
|
</member>
|
1823
1916
|
</enumeration>
|
1824
1917
|
<class name="PixbufAnimation"
|
@@ -1849,7 +1942,10 @@ back to a bilevel clipping mask.</doc>
|
|
1849
1942
|
The file format is detected automatically. If %NULL is returned, then
|
1850
1943
|
@error will be set.</doc>
|
1851
1944
|
<return-value transfer-ownership="full">
|
1852
|
-
<doc xml:space="preserve">A newly-created animation, or %NULL if any of several error
|
1945
|
+
<doc xml:space="preserve">A newly-created animation, or %NULL if any of several error
|
1946
|
+
conditions occurred: the file could not be opened, the image format is
|
1947
|
+
not supported, there was not enough memory to allocate the image buffer,
|
1948
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
1853
1949
|
<type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
|
1854
1950
|
</return-value>
|
1855
1951
|
<parameters>
|
@@ -1865,15 +1961,18 @@ The file format is detected automatically. If %NULL is returned, then
|
|
1865
1961
|
throws="1">
|
1866
1962
|
<doc xml:space="preserve">Creates a new animation by loading it from an input stream.
|
1867
1963
|
|
1868
|
-
The file format is detected automatically. If %NULL is returned, then
|
1964
|
+
The file format is detected automatically. If %NULL is returned, then
|
1869
1965
|
@error will be set. The @cancellable can be used to abort the operation
|
1870
|
-
from another thread. If the operation was cancelled, the error
|
1871
|
-
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
1872
|
-
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
1966
|
+
from another thread. If the operation was cancelled, the error
|
1967
|
+
%G_IO_ERROR_CANCELLED will be returned. Other possible errors are in
|
1968
|
+
the #GDK_PIXBUF_ERROR and %G_IO_ERROR domains.
|
1873
1969
|
|
1874
1970
|
The stream is not closed.</doc>
|
1875
1971
|
<return-value transfer-ownership="full">
|
1876
|
-
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
1972
|
+
<doc xml:space="preserve">A newly-created pixbuf, or %NULL if any of several error
|
1973
|
+
conditions occurred: the file could not be opened, the image format is
|
1974
|
+
not supported, there was not enough memory to allocate the image buffer,
|
1975
|
+
the stream contained invalid data, or the operation was cancelled.</doc>
|
1877
1976
|
<type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
|
1878
1977
|
</return-value>
|
1879
1978
|
<parameters>
|
@@ -1883,6 +1982,7 @@ The stream is not closed.</doc>
|
|
1883
1982
|
</parameter>
|
1884
1983
|
<parameter name="cancellable"
|
1885
1984
|
transfer-ownership="none"
|
1985
|
+
nullable="1"
|
1886
1986
|
allow-none="1">
|
1887
1987
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
1888
1988
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
@@ -1896,7 +1996,8 @@ The stream is not closed.</doc>
|
|
1896
1996
|
<doc xml:space="preserve">Finishes an asynchronous pixbuf animation creation operation started with
|
1897
1997
|
gdk_pixbuf_animation_new_from_stream_async().</doc>
|
1898
1998
|
<return-value transfer-ownership="full">
|
1899
|
-
<doc xml:space="preserve">a #GdkPixbufAnimation or %NULL on error. Free the returned
|
1999
|
+
<doc xml:space="preserve">a #GdkPixbufAnimation or %NULL on error. Free the returned
|
2000
|
+
object with g_object_unref().</doc>
|
1900
2001
|
<type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
|
1901
2002
|
</return-value>
|
1902
2003
|
<parameters>
|
@@ -1927,12 +2028,14 @@ result of the operation.</doc>
|
|
1927
2028
|
</parameter>
|
1928
2029
|
<parameter name="cancellable"
|
1929
2030
|
transfer-ownership="none"
|
2031
|
+
nullable="1"
|
1930
2032
|
allow-none="1">
|
1931
2033
|
<doc xml:space="preserve">optional #GCancellable object, %NULL to ignore</doc>
|
1932
2034
|
<type name="Gio.Cancellable" c:type="GCancellable*"/>
|
1933
2035
|
</parameter>
|
1934
2036
|
<parameter name="callback"
|
1935
2037
|
transfer-ownership="none"
|
2038
|
+
nullable="1"
|
1936
2039
|
allow-none="1"
|
1937
2040
|
scope="async"
|
1938
2041
|
closure="3">
|
@@ -2003,6 +2106,7 @@ A delay time of -1 is possible, indicating "infinite."</doc>
|
|
2003
2106
|
</instance-parameter>
|
2004
2107
|
<parameter name="start_time"
|
2005
2108
|
transfer-ownership="none"
|
2109
|
+
nullable="1"
|
2006
2110
|
allow-none="1">
|
2007
2111
|
<doc xml:space="preserve">time when the animation starts playing</doc>
|
2008
2112
|
<type name="GLib.TimeVal" c:type="const GTimeVal*"/>
|
@@ -2061,9 +2165,10 @@ the image.</doc>
|
|
2061
2165
|
<method name="ref"
|
2062
2166
|
c:identifier="gdk_pixbuf_animation_ref"
|
2063
2167
|
introspectable="0"
|
2064
|
-
deprecated="
|
2168
|
+
deprecated="1"
|
2065
2169
|
deprecated-version="2.0">
|
2066
2170
|
<doc xml:space="preserve">Adds a reference to an animation.</doc>
|
2171
|
+
<doc-deprecated xml:space="preserve">Use g_object_ref().</doc-deprecated>
|
2067
2172
|
<return-value>
|
2068
2173
|
<doc xml:space="preserve">The same as the @animation argument.</doc>
|
2069
2174
|
<type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
|
@@ -2078,9 +2183,10 @@ the image.</doc>
|
|
2078
2183
|
<method name="unref"
|
2079
2184
|
c:identifier="gdk_pixbuf_animation_unref"
|
2080
2185
|
introspectable="0"
|
2081
|
-
deprecated="
|
2186
|
+
deprecated="1"
|
2082
2187
|
deprecated-version="2.0">
|
2083
2188
|
<doc xml:space="preserve">Removes a reference from an animation.</doc>
|
2189
|
+
<doc-deprecated xml:space="preserve">Use g_object_unref().</doc-deprecated>
|
2084
2190
|
<return-value transfer-ownership="none">
|
2085
2191
|
<type name="none" c:type="void"/>
|
2086
2192
|
</return-value>
|
@@ -2131,6 +2237,7 @@ and update the display with the new pixbuf.</doc>
|
|
2131
2237
|
</instance-parameter>
|
2132
2238
|
<parameter name="current_time"
|
2133
2239
|
transfer-ownership="none"
|
2240
|
+
nullable="1"
|
2134
2241
|
allow-none="1">
|
2135
2242
|
<doc xml:space="preserve">current time</doc>
|
2136
2243
|
<type name="GLib.TimeVal" c:type="const GTimeVal*"/>
|
@@ -2158,8 +2265,8 @@ to schedule the next update.</doc>
|
|
2158
2265
|
c:identifier="gdk_pixbuf_animation_iter_get_pixbuf">
|
2159
2266
|
<doc xml:space="preserve">Gets the current pixbuf which should be displayed; the pixbuf might not
|
2160
2267
|
be the same size as the animation itself
|
2161
|
-
(gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()).
|
2162
|
-
This pixbuf should be displayed for
|
2268
|
+
(gdk_pixbuf_animation_get_width(), gdk_pixbuf_animation_get_height()).
|
2269
|
+
This pixbuf should be displayed for
|
2163
2270
|
gdk_pixbuf_animation_iter_get_delay_time() milliseconds. The caller
|
2164
2271
|
of this function does not own a reference to the returned pixbuf;
|
2165
2272
|
the returned pixbuf will become invalid when the iterator advances
|
@@ -2209,7 +2316,8 @@ when the pixbuf is finalized.</doc>
|
|
2209
2316
|
</return-value>
|
2210
2317
|
<parameters>
|
2211
2318
|
<parameter name="pixels" transfer-ownership="none">
|
2212
|
-
<doc xml:space="preserve">The pixel array of the pixbuf
|
2319
|
+
<doc xml:space="preserve">The pixel array of the pixbuf
|
2320
|
+
that is being finalized.</doc>
|
2213
2321
|
<array zero-terminated="0" c:type="guchar*">
|
2214
2322
|
<type name="guint8"/>
|
2215
2323
|
</array>
|
@@ -2225,7 +2333,7 @@ when the pixbuf is finalized.</doc>
|
|
2225
2333
|
glib:get-type="gdk_pixbuf_error_get_type"
|
2226
2334
|
c:type="GdkPixbufError"
|
2227
2335
|
glib:error-domain="gdk-pixbuf-error-quark">
|
2228
|
-
<doc xml:space="preserve">An error code in the #GDK_PIXBUF_ERROR domain. Many
|
2336
|
+
<doc xml:space="preserve">An error code in the #GDK_PIXBUF_ERROR domain. Many gdk-pixbuf
|
2229
2337
|
operations can cause errors in this domain, or in the #G_FILE_ERROR
|
2230
2338
|
domain.</doc>
|
2231
2339
|
<member name="corrupt_image"
|
@@ -2256,7 +2364,8 @@ domain.</doc>
|
|
2256
2364
|
value="4"
|
2257
2365
|
c:identifier="GDK_PIXBUF_ERROR_UNSUPPORTED_OPERATION"
|
2258
2366
|
glib:nick="unsupported-operation">
|
2259
|
-
<doc xml:space="preserve">Don't know how to perform the
|
2367
|
+
<doc xml:space="preserve">Don't know how to perform the
|
2368
|
+
given operation on the type of image at hand.</doc>
|
2260
2369
|
</member>
|
2261
2370
|
<member name="failed"
|
2262
2371
|
value="5"
|
@@ -2278,7 +2387,8 @@ domain.</doc>
|
|
2278
2387
|
<method name="copy" c:identifier="gdk_pixbuf_format_copy" version="2.22">
|
2279
2388
|
<doc xml:space="preserve">Creates a copy of @format</doc>
|
2280
2389
|
<return-value transfer-ownership="full">
|
2281
|
-
<doc xml:space="preserve">the newly allocated copy of a #GdkPixbufFormat. Use
|
2390
|
+
<doc xml:space="preserve">the newly allocated copy of a #GdkPixbufFormat. Use
|
2391
|
+
gdk_pixbuf_format_free() to free the resources when done</doc>
|
2282
2392
|
<type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
|
2283
2393
|
</return-value>
|
2284
2394
|
<parameters>
|
@@ -2319,10 +2429,11 @@ using gdk_pixbuf_format_copy()</doc>
|
|
2319
2429
|
<method name="get_extensions"
|
2320
2430
|
c:identifier="gdk_pixbuf_format_get_extensions"
|
2321
2431
|
version="2.2">
|
2322
|
-
<doc xml:space="preserve">Returns the filename extensions typically used for files in the
|
2432
|
+
<doc xml:space="preserve">Returns the filename extensions typically used for files in the
|
2323
2433
|
given format.</doc>
|
2324
2434
|
<return-value transfer-ownership="full">
|
2325
|
-
<doc xml:space="preserve">a %NULL-terminated array of filename extensions which must be
|
2435
|
+
<doc xml:space="preserve">a %NULL-terminated array of filename extensions which must be
|
2436
|
+
freed with g_strfreev() when it is no longer needed.</doc>
|
2326
2437
|
<array c:type="gchar**">
|
2327
2438
|
<type name="utf8"/>
|
2328
2439
|
</array>
|
@@ -2357,7 +2468,8 @@ string should be freed with g_free() when it's no longer needed.</doc>
|
|
2357
2468
|
version="2.2">
|
2358
2469
|
<doc xml:space="preserve">Returns the mime types supported by the format.</doc>
|
2359
2470
|
<return-value transfer-ownership="full">
|
2360
|
-
<doc xml:space="preserve">a %NULL-terminated array of mime types which must be freed with
|
2471
|
+
<doc xml:space="preserve">a %NULL-terminated array of mime types which must be freed with
|
2472
|
+
g_strfreev() when it is no longer needed.</doc>
|
2361
2473
|
<array c:type="gchar**">
|
2362
2474
|
<type name="utf8"/>
|
2363
2475
|
</array>
|
@@ -2403,9 +2515,9 @@ gdk_pixbuf_format_set_disabled().</doc>
|
|
2403
2515
|
<method name="is_scalable"
|
2404
2516
|
c:identifier="gdk_pixbuf_format_is_scalable"
|
2405
2517
|
version="2.6">
|
2406
|
-
<doc xml:space="preserve">Returns whether this image format is scalable. If a file is in a
|
2407
|
-
scalable format, it is preferable to load it at the desired size,
|
2408
|
-
rather than loading it at the default size and scaling the
|
2518
|
+
<doc xml:space="preserve">Returns whether this image format is scalable. If a file is in a
|
2519
|
+
scalable format, it is preferable to load it at the desired size,
|
2520
|
+
rather than loading it at the default size and scaling the
|
2409
2521
|
resulting pixbuf to the desired size.</doc>
|
2410
2522
|
<return-value transfer-ownership="none">
|
2411
2523
|
<doc xml:space="preserve">whether this image format is scalable.</doc>
|
@@ -2436,9 +2548,9 @@ resulting pixbuf to the desired size.</doc>
|
|
2436
2548
|
<method name="set_disabled"
|
2437
2549
|
c:identifier="gdk_pixbuf_format_set_disabled"
|
2438
2550
|
version="2.6">
|
2439
|
-
<doc xml:space="preserve">Disables or enables an image format. If a format is disabled,
|
2440
|
-
gdk-pixbuf won't use the image loader for this format to load
|
2441
|
-
images. Applications can use this to avoid using image loaders
|
2551
|
+
<doc xml:space="preserve">Disables or enables an image format. If a format is disabled,
|
2552
|
+
gdk-pixbuf won't use the image loader for this format to load
|
2553
|
+
images. Applications can use this to avoid using image loaders
|
2442
2554
|
with an inappropriate license, see gdk_pixbuf_format_get_license().</doc>
|
2443
2555
|
<return-value transfer-ownership="none">
|
2444
2556
|
<type name="none" c:type="void"/>
|
@@ -2462,7 +2574,7 @@ with an inappropriate license, see gdk_pixbuf_format_get_license().</doc>
|
|
2462
2574
|
glib:type-name="GdkPixbufLoader"
|
2463
2575
|
glib:get-type="gdk_pixbuf_loader_get_type"
|
2464
2576
|
glib:type-struct="PixbufLoaderClass">
|
2465
|
-
<doc xml:space="preserve">The
|
2577
|
+
<doc xml:space="preserve">The GdkPixbufLoader struct contains only private
|
2466
2578
|
fields.</doc>
|
2467
2579
|
<constructor name="new" c:identifier="gdk_pixbuf_loader_new">
|
2468
2580
|
<doc xml:space="preserve">Creates a new pixbuf loader object.</doc>
|
@@ -2483,10 +2595,10 @@ that can't be reliably identified by looking at the data, or if
|
|
2483
2595
|
the user manually forces a specific mime type.
|
2484
2596
|
|
2485
2597
|
The list of supported mime types depends on what image loaders
|
2486
|
-
are installed, but typically "image/png", "image/jpeg", "image/gif",
|
2487
|
-
"image/tiff" and "image/x-xpixmap" are among the supported mime types.
|
2488
|
-
To obtain the full list of supported mime types, call
|
2489
|
-
gdk_pixbuf_format_get_mime_types() on each of the #GdkPixbufFormat
|
2598
|
+
are installed, but typically "image/png", "image/jpeg", "image/gif",
|
2599
|
+
"image/tiff" and "image/x-xpixmap" are among the supported mime types.
|
2600
|
+
To obtain the full list of supported mime types, call
|
2601
|
+
gdk_pixbuf_format_get_mime_types() on each of the #GdkPixbufFormat
|
2490
2602
|
structs returned by gdk_pixbuf_get_formats().</doc>
|
2491
2603
|
<return-value transfer-ownership="full">
|
2492
2604
|
<doc xml:space="preserve">A newly-created pixbuf loader.</doc>
|
@@ -2510,9 +2622,9 @@ that can't be reliably identified by looking at the data, or if
|
|
2510
2622
|
the user manually forces a specific type.
|
2511
2623
|
|
2512
2624
|
The list of supported image formats depends on what image loaders
|
2513
|
-
are installed, but typically "png", "jpeg", "gif", "tiff" and
|
2625
|
+
are installed, but typically "png", "jpeg", "gif", "tiff" and
|
2514
2626
|
"xpm" are among the supported formats. To obtain the full list of
|
2515
|
-
supported image formats, call gdk_pixbuf_format_get_name() on each
|
2627
|
+
supported image formats, call gdk_pixbuf_format_get_name() on each
|
2516
2628
|
of the #GdkPixbufFormat structs returned by gdk_pixbuf_get_formats().</doc>
|
2517
2629
|
<return-value transfer-ownership="full">
|
2518
2630
|
<doc xml:space="preserve">A newly-created pixbuf loader.</doc>
|
@@ -2597,7 +2709,8 @@ reasonable.
|
|
2597
2709
|
Remember that this does not unref the loader, so if you plan not to
|
2598
2710
|
use it anymore, please g_object_unref() it.</doc>
|
2599
2711
|
<return-value transfer-ownership="none">
|
2600
|
-
<doc xml:space="preserve">%TRUE if all image data written so far was successfully
|
2712
|
+
<doc xml:space="preserve">%TRUE if all image data written so far was successfully
|
2713
|
+
passed out via the update_area signal</doc>
|
2601
2714
|
<type name="gboolean" c:type="gboolean"/>
|
2602
2715
|
</return-value>
|
2603
2716
|
<parameters>
|
@@ -2612,10 +2725,11 @@ use it anymore, please g_object_unref() it.</doc>
|
|
2612
2725
|
<doc xml:space="preserve">Queries the #GdkPixbufAnimation that a pixbuf loader is currently creating.
|
2613
2726
|
In general it only makes sense to call this function after the "area-prepared"
|
2614
2727
|
signal has been emitted by the loader. If the loader doesn't have enough
|
2615
|
-
bytes yet (hasn't emitted the "area-prepared" signal) this function will
|
2728
|
+
bytes yet (hasn't emitted the "area-prepared" signal) this function will
|
2616
2729
|
return %NULL.</doc>
|
2617
2730
|
<return-value transfer-ownership="none">
|
2618
|
-
<doc xml:space="preserve">The #GdkPixbufAnimation that the loader is loading, or %NULL if
|
2731
|
+
<doc xml:space="preserve">The #GdkPixbufAnimation that the loader is loading, or %NULL if
|
2732
|
+
not enough data has been read to determine the information.</doc>
|
2619
2733
|
<type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
|
2620
2734
|
</return-value>
|
2621
2735
|
<parameters>
|
@@ -2628,10 +2742,12 @@ return %NULL.</doc>
|
|
2628
2742
|
<method name="get_format"
|
2629
2743
|
c:identifier="gdk_pixbuf_loader_get_format"
|
2630
2744
|
version="2.2">
|
2631
|
-
<doc xml:space="preserve">Obtains the available information about the format of the
|
2745
|
+
<doc xml:space="preserve">Obtains the available information about the format of the
|
2632
2746
|
currently loading image file.</doc>
|
2633
|
-
<return-value transfer-ownership="none">
|
2634
|
-
<doc xml:space="preserve">A #GdkPixbufFormat or
|
2747
|
+
<return-value transfer-ownership="none" nullable="1">
|
2748
|
+
<doc xml:space="preserve">A #GdkPixbufFormat or
|
2749
|
+
%NULL. The return value is owned by GdkPixbuf and should not be
|
2750
|
+
freed.</doc>
|
2635
2751
|
<type name="PixbufFormat" c:type="GdkPixbufFormat*"/>
|
2636
2752
|
</return-value>
|
2637
2753
|
<parameters>
|
@@ -2654,7 +2770,8 @@ using it. Additionally, if the loader is an animation, it will
|
|
2654
2770
|
return the "static image" of the animation
|
2655
2771
|
(see gdk_pixbuf_animation_get_static_image()).</doc>
|
2656
2772
|
<return-value transfer-ownership="none">
|
2657
|
-
<doc xml:space="preserve">The #GdkPixbuf that the loader is creating, or %NULL if not
|
2773
|
+
<doc xml:space="preserve">The #GdkPixbuf that the loader is creating, or %NULL if not
|
2774
|
+
enough data has been read to determine how to create the image buffer.</doc>
|
2658
2775
|
<type name="Pixbuf" c:type="GdkPixbuf*"/>
|
2659
2776
|
</return-value>
|
2660
2777
|
<parameters>
|
@@ -2672,7 +2789,7 @@ image size can be determined relative to the original size of
|
|
2672
2789
|
the image by calling gdk_pixbuf_loader_set_size() from a
|
2673
2790
|
signal handler for the ::size-prepared signal.
|
2674
2791
|
|
2675
|
-
Attempts to set the desired image size are ignored after the
|
2792
|
+
Attempts to set the desired image size are ignored after the
|
2676
2793
|
emission of the ::size-prepared signal.</doc>
|
2677
2794
|
<return-value transfer-ownership="none">
|
2678
2795
|
<type name="none" c:type="void"/>
|
@@ -2700,7 +2817,8 @@ will be closed, and will not accept further writes. If %FALSE is
|
|
2700
2817
|
returned, @error will be set to an error from the #GDK_PIXBUF_ERROR
|
2701
2818
|
or #G_FILE_ERROR domains.</doc>
|
2702
2819
|
<return-value transfer-ownership="none">
|
2703
|
-
<doc xml:space="preserve">%TRUE if the write was successful, or %FALSE if the loader
|
2820
|
+
<doc xml:space="preserve">%TRUE if the write was successful, or %FALSE if the loader
|
2821
|
+
cannot parse the buffer.</doc>
|
2704
2822
|
<type name="gboolean" c:type="gboolean"/>
|
2705
2823
|
</return-value>
|
2706
2824
|
<parameters>
|
@@ -2733,7 +2851,8 @@ or #G_FILE_ERROR domains.
|
|
2733
2851
|
|
2734
2852
|
See also: gdk_pixbuf_loader_write()</doc>
|
2735
2853
|
<return-value transfer-ownership="none">
|
2736
|
-
<doc xml:space="preserve">%TRUE if the write was successful, or %FALSE if the loader
|
2854
|
+
<doc xml:space="preserve">%TRUE if the write was successful, or %FALSE if the loader
|
2855
|
+
cannot parse the buffer.</doc>
|
2737
2856
|
<type name="gboolean" c:type="gboolean"/>
|
2738
2857
|
</return-value>
|
2739
2858
|
<parameters>
|
@@ -2754,9 +2873,9 @@ See also: gdk_pixbuf_loader_write()</doc>
|
|
2754
2873
|
<type name="gpointer" c:type="gpointer"/>
|
2755
2874
|
</field>
|
2756
2875
|
<glib:signal name="area-prepared" when="last">
|
2757
|
-
<doc xml:space="preserve">This signal is emitted when the pixbuf loader has allocated the
|
2758
|
-
pixbuf in the desired size. After this signal is emitted,
|
2759
|
-
applications can call gdk_pixbuf_loader_get_pixbuf() to fetch
|
2876
|
+
<doc xml:space="preserve">This signal is emitted when the pixbuf loader has allocated the
|
2877
|
+
pixbuf in the desired size. After this signal is emitted,
|
2878
|
+
applications can call gdk_pixbuf_loader_get_pixbuf() to fetch
|
2760
2879
|
the partially-loaded pixbuf.</doc>
|
2761
2880
|
<return-value transfer-ownership="none">
|
2762
2881
|
<type name="none" c:type="void"/>
|
@@ -2802,7 +2921,7 @@ drives it.</doc>
|
|
2802
2921
|
<glib:signal name="size-prepared" when="last">
|
2803
2922
|
<doc xml:space="preserve">This signal is emitted when the pixbuf loader has been fed the
|
2804
2923
|
initial amount of data that is required to figure out the size
|
2805
|
-
of the image that it will create. Applications can call
|
2924
|
+
of the image that it will create. Applications can call
|
2806
2925
|
gdk_pixbuf_loader_set_size() in response to this signal to set
|
2807
2926
|
the desired size to which the image should be scaled.</doc>
|
2808
2927
|
<return-value transfer-ownership="none">
|
@@ -2994,7 +3113,7 @@ will fail with the same error.</doc>
|
|
2994
3113
|
c:identifier="gdk_pixbuf_simple_anim_add_frame"
|
2995
3114
|
version="2.8">
|
2996
3115
|
<doc xml:space="preserve">Adds a new frame to @animation. The @pixbuf must
|
2997
|
-
have the dimensions specified when the animation
|
3116
|
+
have the dimensions specified when the animation
|
2998
3117
|
was constructed.</doc>
|
2999
3118
|
<return-value transfer-ownership="none">
|
3000
3119
|
<type name="none" c:type="void"/>
|
@@ -3063,27 +3182,38 @@ was constructed.</doc>
|
|
3063
3182
|
glib:get-type="gdk_pixbuf_simple_anim_iter_get_type">
|
3064
3183
|
</class>
|
3065
3184
|
<record name="Pixdata" c:type="GdkPixdata">
|
3066
|
-
<doc xml:space="preserve">A #GdkPixdata contains pixbuf information in a form suitable for
|
3185
|
+
<doc xml:space="preserve">A #GdkPixdata contains pixbuf information in a form suitable for
|
3067
3186
|
serialization and streaming.</doc>
|
3068
3187
|
<field name="magic" writable="1">
|
3188
|
+
<doc xml:space="preserve">magic number. A valid #GdkPixdata structure must have
|
3189
|
+
#GDK_PIXBUF_MAGIC_NUMBER here.</doc>
|
3069
3190
|
<type name="guint32" c:type="guint32"/>
|
3070
3191
|
</field>
|
3071
3192
|
<field name="length" writable="1">
|
3193
|
+
<doc xml:space="preserve">less than 1 to disable length checks, otherwise
|
3194
|
+
#GDK_PIXDATA_HEADER_LENGTH + length of @pixel_data.</doc>
|
3072
3195
|
<type name="gint32" c:type="gint32"/>
|
3073
3196
|
</field>
|
3074
3197
|
<field name="pixdata_type" writable="1">
|
3198
|
+
<doc xml:space="preserve">information about colorspace, sample width and
|
3199
|
+
encoding, in a #GdkPixdataType.</doc>
|
3075
3200
|
<type name="guint32" c:type="guint32"/>
|
3076
3201
|
</field>
|
3077
3202
|
<field name="rowstride" writable="1">
|
3203
|
+
<doc xml:space="preserve">Distance in bytes between rows.</doc>
|
3078
3204
|
<type name="guint32" c:type="guint32"/>
|
3079
3205
|
</field>
|
3080
3206
|
<field name="width" writable="1">
|
3207
|
+
<doc xml:space="preserve">Width of the image in pixels.</doc>
|
3081
3208
|
<type name="guint32" c:type="guint32"/>
|
3082
3209
|
</field>
|
3083
3210
|
<field name="height" writable="1">
|
3211
|
+
<doc xml:space="preserve">Height of the image in pixels.</doc>
|
3084
3212
|
<type name="guint32" c:type="guint32"/>
|
3085
3213
|
</field>
|
3086
3214
|
<field name="pixel_data" writable="1">
|
3215
|
+
<doc xml:space="preserve">@width x @height pixels, encoded according to @pixdata_type
|
3216
|
+
and @rowstride.</doc>
|
3087
3217
|
<array zero-terminated="0" c:type="guint8*">
|
3088
3218
|
<type name="guint8"/>
|
3089
3219
|
</array>
|
@@ -3099,7 +3229,8 @@ The @pixdata contents are reconstructed byte by byte and are checked
|
|
3099
3229
|
for validity. This function may fail with %GDK_PIXBUF_ERROR_CORRUPT_IMAGE
|
3100
3230
|
or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE.</doc>
|
3101
3231
|
<return-value transfer-ownership="none">
|
3102
|
-
<doc xml:space="preserve">Upon successful deserialization %TRUE is returned,
|
3232
|
+
<doc xml:space="preserve">Upon successful deserialization %TRUE is returned,
|
3233
|
+
%FALSE otherwise.</doc>
|
3103
3234
|
<type name="gboolean" c:type="gboolean"/>
|
3104
3235
|
</return-value>
|
3105
3236
|
<parameters>
|
@@ -3112,7 +3243,8 @@ or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE.</doc>
|
|
3112
3243
|
<type name="guint" c:type="guint"/>
|
3113
3244
|
</parameter>
|
3114
3245
|
<parameter name="stream" transfer-ownership="none">
|
3115
|
-
<doc xml:space="preserve">stream of bytes containing a
|
3246
|
+
<doc xml:space="preserve">stream of bytes containing a
|
3247
|
+
serialized #GdkPixdata structure.</doc>
|
3116
3248
|
<array length="0" zero-terminated="0" c:type="guint8*">
|
3117
3249
|
<type name="guint8" c:type="guint8"/>
|
3118
3250
|
</array>
|
@@ -3123,10 +3255,12 @@ or %GDK_PIXBUF_ERROR_UNKNOWN_TYPE.</doc>
|
|
3123
3255
|
c:identifier="gdk_pixdata_from_pixbuf"
|
3124
3256
|
introspectable="0">
|
3125
3257
|
<doc xml:space="preserve">Converts a #GdkPixbuf to a #GdkPixdata. If @use_rle is %TRUE, the
|
3126
|
-
pixel data is run-length encoded into newly-allocated memory and a
|
3258
|
+
pixel data is run-length encoded into newly-allocated memory and a
|
3127
3259
|
pointer to that memory is returned.</doc>
|
3128
|
-
<return-value>
|
3129
|
-
<doc xml:space="preserve">If @
|
3260
|
+
<return-value nullable="1">
|
3261
|
+
<doc xml:space="preserve">If @use_rle is %TRUE, a pointer to the
|
3262
|
+
newly-allocated memory for the run-length encoded pixel data,
|
3263
|
+
otherwise %NULL.</doc>
|
3130
3264
|
<type name="gpointer" c:type="gpointer"/>
|
3131
3265
|
</return-value>
|
3132
3266
|
<parameters>
|
@@ -3150,7 +3284,9 @@ The byte stream consists of a straightforward writeout of the
|
|
3150
3284
|
#GdkPixdata fields in network byte order, plus the @pixel_data
|
3151
3285
|
bytes the structure points to.</doc>
|
3152
3286
|
<return-value transfer-ownership="full">
|
3153
|
-
<doc xml:space="preserve">A
|
3287
|
+
<doc xml:space="preserve">A
|
3288
|
+
newly-allocated string containing the serialized #GdkPixdata
|
3289
|
+
structure.</doc>
|
3154
3290
|
<array length="0" zero-terminated="0" c:type="guint8*">
|
3155
3291
|
<type name="guint8" c:type="guint8"/>
|
3156
3292
|
</array>
|
@@ -3170,14 +3306,15 @@ bytes the structure points to.</doc>
|
|
3170
3306
|
</parameters>
|
3171
3307
|
</method>
|
3172
3308
|
<method name="to_csource" c:identifier="gdk_pixdata_to_csource">
|
3173
|
-
<doc xml:space="preserve">Generates C source code suitable for compiling images directly
|
3174
|
-
into programs.
|
3309
|
+
<doc xml:space="preserve">Generates C source code suitable for compiling images directly
|
3310
|
+
into programs.
|
3175
3311
|
|
3176
3312
|
gdk-pixbuf ships with a program called
|
3177
3313
|
[gdk-pixbuf-csource][gdk-pixbuf-csource], which offers a command
|
3178
3314
|
line interface to this function.</doc>
|
3179
3315
|
<return-value transfer-ownership="full">
|
3180
|
-
<doc xml:space="preserve">a newly-allocated string containing the C source form
|
3316
|
+
<doc xml:space="preserve">a newly-allocated string containing the C source form
|
3317
|
+
of @pixdata.</doc>
|
3181
3318
|
<type name="GLib.String" c:type="GString*"/>
|
3182
3319
|
</return-value>
|
3183
3320
|
<parameters>
|
@@ -3190,7 +3327,8 @@ line interface to this function.</doc>
|
|
3190
3327
|
<type name="utf8" c:type="const gchar*"/>
|
3191
3328
|
</parameter>
|
3192
3329
|
<parameter name="dump_type" transfer-ownership="none">
|
3193
|
-
<doc xml:space="preserve">a #GdkPixdataDumpType determining the kind of C
|
3330
|
+
<doc xml:space="preserve">a #GdkPixdataDumpType determining the kind of C
|
3331
|
+
source to be generated.</doc>
|
3194
3332
|
<type name="PixdataDumpType" c:type="GdkPixdataDumpType"/>
|
3195
3333
|
</parameter>
|
3196
3334
|
</parameters>
|
@@ -3206,21 +3344,30 @@ elements are optional flags that can be freely added.</doc>
|
|
3206
3344
|
<member name="pixdata_stream"
|
3207
3345
|
value="0"
|
3208
3346
|
c:identifier="GDK_PIXDATA_DUMP_PIXDATA_STREAM">
|
3209
|
-
<doc xml:space="preserve">Generate pixbuf data stream (a single
|
3347
|
+
<doc xml:space="preserve">Generate pixbuf data stream (a single
|
3348
|
+
string containing a serialized #GdkPixdata structure in network byte
|
3349
|
+
order).</doc>
|
3210
3350
|
</member>
|
3211
3351
|
<member name="pixdata_struct"
|
3212
3352
|
value="1"
|
3213
3353
|
c:identifier="GDK_PIXDATA_DUMP_PIXDATA_STRUCT">
|
3214
|
-
<doc xml:space="preserve">Generate #GdkPixdata structure (needs
|
3354
|
+
<doc xml:space="preserve">Generate #GdkPixdata structure (needs
|
3355
|
+
the #GdkPixdata structure definition from gdk-pixdata.h).</doc>
|
3215
3356
|
</member>
|
3216
3357
|
<member name="macros" value="2" c:identifier="GDK_PIXDATA_DUMP_MACROS">
|
3217
|
-
<doc xml:space="preserve">Generate <function>*_ROWSTRIDE</function>,
|
3358
|
+
<doc xml:space="preserve">Generate <function>*_ROWSTRIDE</function>,
|
3359
|
+
<function>*_WIDTH</function>, <function>*_HEIGHT</function>,
|
3360
|
+
<function>*_BYTES_PER_PIXEL</function> and
|
3361
|
+
<function>*_RLE_PIXEL_DATA</function> or <function>*_PIXEL_DATA</function>
|
3362
|
+
macro definitions for the image.</doc>
|
3218
3363
|
</member>
|
3219
3364
|
<member name="gtypes" value="0" c:identifier="GDK_PIXDATA_DUMP_GTYPES">
|
3220
|
-
<doc xml:space="preserve">Generate GLib data types instead of
|
3365
|
+
<doc xml:space="preserve">Generate GLib data types instead of
|
3366
|
+
standard C data types.</doc>
|
3221
3367
|
</member>
|
3222
3368
|
<member name="ctypes" value="256" c:identifier="GDK_PIXDATA_DUMP_CTYPES">
|
3223
|
-
<doc xml:space="preserve">Generate standard C data types instead of
|
3369
|
+
<doc xml:space="preserve">Generate standard C data types instead of
|
3370
|
+
GLib data types.</doc>
|
3224
3371
|
</member>
|
3225
3372
|
<member name="static" value="512" c:identifier="GDK_PIXDATA_DUMP_STATIC">
|
3226
3373
|
<doc xml:space="preserve">Generate static symbols.</doc>
|
@@ -3231,12 +3378,13 @@ elements are optional flags that can be freely added.</doc>
|
|
3231
3378
|
<member name="rle_decoder"
|
3232
3379
|
value="65536"
|
3233
3380
|
c:identifier="GDK_PIXDATA_DUMP_RLE_DECODER">
|
3234
|
-
<doc xml:space="preserve">Provide a <function>*_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp)</function>
|
3381
|
+
<doc xml:space="preserve">Provide a <function>*_RUN_LENGTH_DECODE(image_buf, rle_data, size, bpp)</function>
|
3382
|
+
macro definition to decode run-length encoded image data.</doc>
|
3235
3383
|
</member>
|
3236
3384
|
</bitfield>
|
3237
3385
|
<bitfield name="PixdataType" c:type="GdkPixdataType">
|
3238
|
-
<doc xml:space="preserve">An enumeration containing three sets of flags for a #GdkPixdata struct:
|
3239
|
-
one for the used colorspace, one for the width of the samples and one
|
3386
|
+
<doc xml:space="preserve">An enumeration containing three sets of flags for a #GdkPixdata struct:
|
3387
|
+
one for the used colorspace, one for the width of the samples and one
|
3240
3388
|
for the encoding of the pixel data.</doc>
|
3241
3389
|
<member name="color_type_rgb"
|
3242
3390
|
value="1"
|
@@ -3246,7 +3394,8 @@ for the encoding of the pixel data.</doc>
|
|
3246
3394
|
<member name="color_type_rgba"
|
3247
3395
|
value="2"
|
3248
3396
|
c:identifier="GDK_PIXDATA_COLOR_TYPE_RGBA">
|
3249
|
-
<doc xml:space="preserve">each pixel has red, green and blue samples
|
3397
|
+
<doc xml:space="preserve">each pixel has red, green and blue samples
|
3398
|
+
and an alpha value.</doc>
|
3250
3399
|
</member>
|
3251
3400
|
<member name="color_type_mask"
|
3252
3401
|
value="255"
|
@@ -3271,7 +3420,11 @@ for the encoding of the pixel data.</doc>
|
|
3271
3420
|
<member name="encoding_rle"
|
3272
3421
|
value="33554432"
|
3273
3422
|
c:identifier="GDK_PIXDATA_ENCODING_RLE">
|
3274
|
-
<doc xml:space="preserve">the pixel data is run-length encoded. Runs may
|
3423
|
+
<doc xml:space="preserve">the pixel data is run-length encoded. Runs may
|
3424
|
+
be up to 127 bytes long; their length is stored in a single byte
|
3425
|
+
preceding the pixel data for the run. If a run is constant, its length
|
3426
|
+
byte has the high bit set and the pixel data consists of a single pixel
|
3427
|
+
which must be repeated.</doc>
|
3275
3428
|
</member>
|
3276
3429
|
<member name="encoding_mask"
|
3277
3430
|
value="251658240"
|