gdk_pixbuf2 3.1.0-x86-mingw32 → 3.1.1-x86-mingw32

data/vendor/local/lib/libgdk_pixbuf-2.0.la

@@ -25,7 +25,7 @@ weak_library_names=''
 # Version information for libgdk_pixbuf-2.0.
 current=3600
 age=3600
-revision=0
+revision=4
 
 # Is this an already installed library?
 installed=yes

data/vendor/local/lib/pkgconfig/gdk-pixbuf-2.0.pc

@@ -10,7 +10,7 @@ gdk_pixbuf_cache_file=${gdk_pixbuf_binarydir}/loaders.cache
 
 Name: GdkPixbuf
 Description: Image loading and scaling
-Version: 2.36.0
+Version: 2.36.4
 Requires: gobject-2.0
 Requires.private: gmodule-no-export-2.0 libpng16
 Libs: -L${libdir} -lgdk_pixbuf-2.0

data/vendor/local/share/gir-1.0/GdkPixbuf-2.0.gir

@@ -97,7 +97,7 @@ the gdk-pixbuf library.  Currently only RGB is supported.</doc>
 "0.8.2" for example.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="PIXBUF_MICRO" value="0" c:type="GDK_PIXBUF_MICRO">
+    <constant name="PIXBUF_MICRO" value="4" c:type="GDK_PIXBUF_MICRO">
       <doc xml:space="preserve">Micro version of gdk-pixbuf library, that is the "2" in
 "0.8.2" for example.</doc>
       <type name="gint" c:type="gint"/>
@@ -107,7 +107,7 @@ the gdk-pixbuf library.  Currently only RGB is supported.</doc>
 "0.8.2" for example.</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="PIXBUF_VERSION" value="2.36.0" c:type="GDK_PIXBUF_VERSION">
+    <constant name="PIXBUF_VERSION" value="2.36.4" c:type="GDK_PIXBUF_VERSION">
       <doc xml:space="preserve">Contains the full version of the gdk-pixbuf header as a string.
 This is the version being compiled against; contrast with
 #gdk_pixbuf_version.</doc>
@@ -271,41 +271,160 @@ drops to zero, or %NULL if the data should not be freed</doc>
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_file"
+                   c:identifier="gdk_pixbuf_new_from_file"
+                   throws="1">
+        <doc xml:space="preserve">Creates a new pixbuf by loading an image from a file.  The file format is
+detected automatically. If %NULL is returned, then @error will be set.
+Possible errors are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL if
+any of several error conditions occurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
+          <type name="Pixbuf" c:type="GdkPixbuf*"/>
+        </return-value>
+        <parameters>
+          <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+        </parameters>
+      </constructor>
+      <constructor name="new_from_file_at_scale"
+                   c:identifier="gdk_pixbuf_new_from_file_at_scale"
+                   version="2.6"
+                   throws="1">
+        <doc xml:space="preserve">Creates a new pixbuf by loading an image from a file.  The file format is
+detected automatically. If %NULL is returned, then @error will be set.
+Possible errors are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains.
+The image will be scaled to fit in the requested size, optionally preserving
+the image's aspect ratio.
+
+When preserving the aspect ratio, a @width of -1 will cause the image
+to be scaled to the exact given height, and a @height of -1 will cause
+the image to be scaled to the exact given width. When not preserving
+aspect ratio, a @width or @height of -1 means to not scale the image
+at all in that dimension. Negative values for @width and @height are
+allowed since 2.8.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL
+if any of several error conditions occurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
+          <type name="Pixbuf" c:type="GdkPixbuf*"/>
+        </return-value>
+        <parameters>
+          <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="width" transfer-ownership="none">
+            <doc xml:space="preserve">The width the image should have or -1 to not constrain the width</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+          <parameter name="height" transfer-ownership="none">
+            <doc xml:space="preserve">The height the image should have or -1 to not constrain the height</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+          <parameter name="preserve_aspect_ratio" transfer-ownership="none">
+            <doc xml:space="preserve">%TRUE to preserve the image's aspect ratio</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_file_at_scale_utf8"
                    c:identifier="gdk_pixbuf_new_from_file_at_scale_utf8"
+                   version="2.6"
                    throws="1">
+        <doc xml:space="preserve">Same as gdk_pixbuf_new_from_file_at_scale().</doc>
         <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL
+if any of several error conditions occurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
           <type name="Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
           <parameter name="width" transfer-ownership="none">
+            <doc xml:space="preserve">The width the image should have or -1 to not constrain the width</doc>
             <type name="gint" c:type="int"/>
           </parameter>
           <parameter name="height" transfer-ownership="none">
+            <doc xml:space="preserve">The height the image should have or -1 to not constrain the height</doc>
             <type name="gint" c:type="int"/>
           </parameter>
           <parameter name="preserve_aspect_ratio" transfer-ownership="none">
+            <doc xml:space="preserve">%TRUE to preserve the image's aspect ratio</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
         </parameters>
       </constructor>
+      <constructor name="new_from_file_at_size"
+                   c:identifier="gdk_pixbuf_new_from_file_at_size"
+                   version="2.4"
+                   throws="1">
+        <doc xml:space="preserve">Creates a new pixbuf by loading an image from a file.
+The file format is detected automatically. If %NULL is returned, then
+@error will be set. Possible errors are in the #GDK_PIXBUF_ERROR and
+#G_FILE_ERROR domains.
+
+The image will be scaled to fit in the requested size, preserving
+the image's aspect ratio. Note that the returned pixbuf may be smaller
+than @width x @height, if the aspect ratio requires it. To load
+and image at the requested size, regardless of aspect ratio, use
+gdk_pixbuf_new_from_file_at_scale().</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or
+%NULL if any of several error conditions occurred:  the file could not
+be opened, there was no loader for the file's format, there was not
+enough memory to allocate the image buffer, or the image file contained
+invalid data.</doc>
+          <type name="Pixbuf" c:type="GdkPixbuf*"/>
+        </return-value>
+        <parameters>
+          <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="width" transfer-ownership="none">
+            <doc xml:space="preserve">The width the image should have or -1 to not constrain the width</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+          <parameter name="height" transfer-ownership="none">
+            <doc xml:space="preserve">The height the image should have or -1 to not constrain the height</doc>
+            <type name="gint" c:type="int"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_file_at_size_utf8"
                    c:identifier="gdk_pixbuf_new_from_file_at_size_utf8"
+                   version="2.4"
                    throws="1">
+        <doc xml:space="preserve">Same as gdk_pixbuf_new_from_file_at_size()</doc>
         <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or
+%NULL if any of several error conditions occurred:  the file could not
+be opened, there was no loader for the file's format, there was not
+enough memory to allocate the image buffer, or the image file contained
+invalid data.</doc>
           <type name="Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
           <parameter name="width" transfer-ownership="none">
+            <doc xml:space="preserve">The width the image should have or -1 to not constrain the width</doc>
             <type name="gint" c:type="int"/>
           </parameter>
           <parameter name="height" transfer-ownership="none">
+            <doc xml:space="preserve">The height the image should have or -1 to not constrain the height</doc>
             <type name="gint" c:type="int"/>
           </parameter>
         </parameters>
@@ -313,11 +432,17 @@ drops to zero, or %NULL if the data should not be freed</doc>
       <constructor name="new_from_file_utf8"
                    c:identifier="gdk_pixbuf_new_from_file_utf8"
                    throws="1">
+        <doc xml:space="preserve">Same as gdk_pixbuf_new_from_file()</doc>
         <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created pixbuf with a reference count of 1, or %NULL if
+any of several error conditions occurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
           <type name="Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
         </parameters>
@@ -671,7 +796,7 @@ get the result of the operation.</doc>
                      allow-none="1"
                      scope="async"
                      closure="3">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the file info is available</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -763,7 +888,7 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
                      allow-none="1"
                      scope="async"
                      closure="3">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the pixbuf is loaded</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -818,7 +943,7 @@ You can then call gdk_pixbuf_new_from_stream_finish() to get the result of the o
                      allow-none="1"
                      scope="async"
                      closure="6">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the pixbuf is loaded</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -896,7 +1021,8 @@ libtiff). If an orientation option/tag is present, the
 appropriate transform will be performed so that the pixbuf
 is oriented correctly.</doc>
         <return-value transfer-ownership="full">
-          <doc xml:space="preserve">A newly-created pixbuf, or a reference to the
+          <doc xml:space="preserve">A newly-created pixbuf, %NULL if
+not enough memory could be allocated for it, or a reference to the
 input pixbuf (with an increased reference count).</doc>
           <type name="Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
@@ -912,7 +1038,7 @@ input pixbuf (with an increased reference count).</doc>
 @scale_x and @scale_y then translating by @offset_x and @offset_y.
 This gives an image in the coordinates of the destination pixbuf.
 The rectangle (@dest_x, @dest_y, @dest_width, @dest_height)
-is then composited onto the corresponding rectangle of the
+is then alpha blended onto the corresponding rectangle of the
 original destination image.
 
 When the destination rectangle contains parts not in the source
@@ -977,11 +1103,14 @@ to infinity.
       <method name="composite_color" c:identifier="gdk_pixbuf_composite_color">
         <doc xml:space="preserve">Creates a transformation of the source image @src by scaling by
 @scale_x and @scale_y then translating by @offset_x and @offset_y,
-then composites the rectangle (@dest_x ,@dest_y, @dest_width,
+then alpha blends the rectangle (@dest_x ,@dest_y, @dest_width,
 @dest_height) of the resulting image with a checkboard of the
 colors @color1 and @color2 and renders it onto the destination
 image.
 
+If the source image has no alpha channel, and @overall_alpha is 255, a fast
+path is used which omits the alpha blending and just performs the scaling.
+
 See gdk_pixbuf_composite_color_simple() for a simpler variant of this
 function suitable for many tasks.</doc>
         <return-value transfer-ownership="none">
@@ -1061,7 +1190,7 @@ function suitable for many tasks.</doc>
       <method name="composite_color_simple"
               c:identifier="gdk_pixbuf_composite_color_simple">
         <doc xml:space="preserve">Creates a new #GdkPixbuf by scaling @src to @dest_width x
-@dest_height and compositing the result with a checkboard of colors
+@dest_height and alpha blending the result with a checkboard of colors
 @color1 and @color2.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
@@ -1547,7 +1676,9 @@ pixbuf.</doc>
               c:identifier="gdk_pixbuf_rotate_simple"
               version="2.6">
         <doc xml:space="preserve">Rotates a pixbuf by a multiple of 90 degrees, and returns the
-result in a new pixbuf.</doc>
+result in a new pixbuf.
+
+If @angle is 0, a copy of @src is returned, avoiding any rotation.</doc>
         <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the new #GdkPixbuf, or %NULL
 if not enough memory could be allocated for it.</doc>
@@ -1898,7 +2029,7 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
                      allow-none="1"
                      scope="async"
                      closure="4">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the pixbuf is saved</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -2012,7 +2143,7 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
                      allow-none="1"
                      scope="async"
                      closure="6">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the pixbuf is saved</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"
@@ -2048,27 +2179,73 @@ You can then call gdk_pixbuf_save_to_stream_finish() to get the result of the op
           </parameter>
         </parameters>
       </method>
+      <method name="savev" c:identifier="gdk_pixbuf_savev" throws="1">
+        <doc xml:space="preserve">Saves pixbuf to a file in @type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
+If @error is set, %FALSE will be returned.
+See gdk_pixbuf_save () for more details.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether an error was set</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="pixbuf" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkPixbuf.</doc>
+            <type name="Pixbuf" c:type="GdkPixbuf*"/>
+          </instance-parameter>
+          <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">name of file to save.</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="type" transfer-ownership="none">
+            <doc xml:space="preserve">name of file format.</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+          <parameter name="option_keys" transfer-ownership="none">
+            <doc xml:space="preserve">name of options to set, %NULL-terminated</doc>
+            <array c:type="char**">
+              <type name="utf8" c:type="char*"/>
+            </array>
+          </parameter>
+          <parameter name="option_values" transfer-ownership="none">
+            <doc xml:space="preserve">values for named options</doc>
+            <array c:type="char**">
+              <type name="utf8" c:type="char*"/>
+            </array>
+          </parameter>
+        </parameters>
+      </method>
       <method name="savev_utf8"
               c:identifier="gdk_pixbuf_savev_utf8"
               throws="1">
+        <doc xml:space="preserve">Same as gdk_pixbuf_savev()</doc>
         <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether an error was set</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="pixbuf" transfer-ownership="none">
+            <doc xml:space="preserve">a #GdkPixbuf.</doc>
             <type name="Pixbuf" c:type="GdkPixbuf*"/>
           </instance-parameter>
           <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">name of file to save.</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
           <parameter name="type" transfer-ownership="none">
+            <doc xml:space="preserve">name of file format.</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
           <parameter name="option_keys" transfer-ownership="none">
-            <type name="utf8" c:type="char**"/>
+            <doc xml:space="preserve">name of options to set, %NULL-terminated</doc>
+            <array c:type="char**">
+              <type name="utf8" c:type="char*"/>
+            </array>
           </parameter>
           <parameter name="option_values" transfer-ownership="none">
-            <type name="utf8" c:type="char**"/>
+            <doc xml:space="preserve">values for named options</doc>
+            <array c:type="char**">
+              <type name="utf8" c:type="char*"/>
+            </array>
           </parameter>
         </parameters>
       </method>
@@ -2147,7 +2324,10 @@ reasonable quality and speed.
 You can scale a sub-portion of @src by creating a sub-pixbuf
 pointing into @src; see gdk_pixbuf_new_subpixbuf().
 
-For more complicated scaling/compositing see gdk_pixbuf_scale()
+If @dest_width and @dest_height are equal to the @src width and height, a
+copy of @src is returned, avoiding any scaling.
+
+For more complicated scaling/alpha blending see gdk_pixbuf_scale()
 and gdk_pixbuf_composite().</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the new #GdkPixbuf, or %NULL if not enough memory could be
@@ -2282,7 +2462,7 @@ be at least as large as the width of the pixbuf.</doc>
                  glib:get-type="gdk_pixbuf_alpha_mode_get_type"
                  c:type="GdkPixbufAlphaMode">
       <doc xml:space="preserve">These values can be passed to
-gdk_pixbuf_render_to_drawable_alpha() to control how the alpha
+gdk_pixbuf_xlib_render_to_drawable_alpha() to control how the alpha
 channel of an image should be handled.  This function can create a
 bilevel clipping mask (black and white) and use it while painting
 the image.  In the future, when the X Window System gets an alpha
@@ -2313,14 +2493,41 @@ back to a bilevel clipping mask.</doc>
            glib:type-name="GdkPixbufAnimation"
            glib:get-type="gdk_pixbuf_animation_get_type">
       <doc xml:space="preserve">An opaque struct representing an animation.</doc>
+      <constructor name="new_from_file"
+                   c:identifier="gdk_pixbuf_animation_new_from_file"
+                   throws="1">
+        <doc xml:space="preserve">Creates a new animation by loading it from a file. The file format is
+detected automatically. If the file's format does not support multi-frame
+images, then an animation with a single frame will be created. Possible errors
+are in the #GDK_PIXBUF_ERROR and #G_FILE_ERROR domains.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created animation with a reference count of 1, or %NULL
+if any of several error conditions ocurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
+          <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
+        </return-value>
+        <parameters>
+          <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
+            <type name="utf8" c:type="const char*"/>
+          </parameter>
+        </parameters>
+      </constructor>
       <constructor name="new_from_file_utf8"
                    c:identifier="gdk_pixbuf_animation_new_from_file_utf8"
                    throws="1">
+        <doc xml:space="preserve">Same as gdk_pixbuf_animation_new_from_file()</doc>
         <return-value transfer-ownership="full">
+          <doc xml:space="preserve">A newly-created animation with a reference count of 1, or %NULL
+if any of several error conditions ocurred:  the file could not be opened,
+there was no loader for the file's format, there was not enough memory to
+allocate the image buffer, or the image file contained invalid data.</doc>
           <type name="PixbufAnimation" c:type="GdkPixbufAnimation*"/>
         </return-value>
         <parameters>
           <parameter name="filename" transfer-ownership="none">
+            <doc xml:space="preserve">Name of file to load, in the GLib file name encoding</doc>
             <type name="utf8" c:type="const char*"/>
           </parameter>
         </parameters>
@@ -2431,7 +2638,7 @@ result of the operation.</doc>
                      allow-none="1"
                      scope="async"
                      closure="3">
-            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the the pixbuf is loaded</doc>
+            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the pixbuf is loaded</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
           <parameter name="user_data"