ruby-vips 2.2.3 → 2.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94d18bf3b8d377111af5d5b537deeb0bc391bf92968e5d757607f393d35eff59
-  data.tar.gz: c83b03c317e3717aa21fdeecbd940890351c5be5290a6dd4cafbd3efd8ab3da7
+  metadata.gz: cbcb710d3c731107872917d35da6b921cae90ebdafb88d7fc917e8556bf7c2fe
+  data.tar.gz: 3e594a080fb2258609ae1b427e5df60ede8d8aee2730102ce2045c9b96f4e830
 SHA512:
-  metadata.gz: d3dfb006f74d11ca1af36bd423185a5336849bf34d63966f02ed6f5d9a14ab5f89ddf8b86d029569b5d609a393dec0dfbe21843fa0514a8d179026bb706cc3de
-  data.tar.gz: cdb4469a96a362af3cf1377bb64d50e1327c4711cc0aa2b6222e6d0b08e1f38541bc4fb2e9adc42e3ded39316d6ec87f6a08fa9ff8752a023a1da4c684497213
+  metadata.gz: d85ea128b1db40b818a9beb854cb2ae26ae28efd55fd6f31cbceb88a46661e804fd6ed273f78406e7e5cc781e9bfdb99c35421e9ca995c15cc8446a4e2056ae1
+  data.tar.gz: 1e47faba504bc492b279a0d4ca8760c48c15e59a5c4eb9feaf88cb6ff8b453d6f08af63dd33ee7b3ef65daabf9badf37930157a10cc98447acc71930f1419543

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## master
 
+## Version 2.2.5 (2025-08-20)
+
+* improve NULL pointer handling [dloebl]
+* improve GFlags argument handling [jcupitt]
+* add missing flag and enum docs [jcupitt]
+
+## Version 2.2.4 (2025-06-05)
+
+* fix write to target test with libvips 8.17 [jcupitt]
+* update docs for libvips 8.17 [jcupitt]
+
 ## Version 2.2.3 (2025-02-06)
 
 * fix `Image#add_alpha()` with libvips 8.16 [kleisauke]
@@ -13,8 +24,8 @@
 
 ## Version 2.2.1 (2024-02-21)
 
-* add `Vips.block_untrusted` method to block all untrusted operations. Only for libvips >= 8.13. [Docs](https://www.libvips.org/API/current/libvips-vips.html#vips-block-untrusted-set). [#382](https://github.com/libvips/ruby-vips/pull/382) [aglushkov](https://github.com/aglushkov)
-* add `Vips.block` method to block specific operation. Only for libvips >= 8.13. [Docs](https://www.libvips.org/API/current/VipsOperation.html#vips-operation-block-set). [#382](https://github.com/libvips/ruby-vips/pull/382) [aglushkov](https://github.com/aglushkov)
+* add `Vips.block_untrusted` method to block all untrusted operations. Only for libvips >= 8.13. [Docs](https://www.libvips.org/API/current/func.block_untrusted_set.html). [#382](https://github.com/libvips/ruby-vips/pull/382) [aglushkov](https://github.com/aglushkov)
+* add `Vips.block` method to block specific operation. Only for libvips >= 8.13. [Docs](https://www.libvips.org/API/current/type_func.Operation.block_set.html). [#382](https://github.com/libvips/ruby-vips/pull/382) [aglushkov](https://github.com/aglushkov)
 * `new_from_source` keeps a ref to the source object [taylorthurlow]
 * some fixes to object references system
 

data/README.md

@@ -52,7 +52,7 @@ im = Vips::Image.new_from_file filename
 # put im at position (100, 100) in a 3000 x 3000 pixel image, 
 # make the other pixels in the image by mirroring im up / down / 
 # left / right, see
-# https://libvips.github.io/libvips/API/current/libvips-conversion.html#vips-embed
+# https://www.libvips.org/API/current/method.Image.embed.html
 im = im.embed 100, 100, 3000, 3000, extend: :mirror
 
 # multiply the green (middle) band by 2, leave the other two alone
@@ -80,7 +80,7 @@ should always work.
 See the `Vips` section in the docs for a [tutorial introduction with
 examples](https://www.rubydoc.info/gems/ruby-vips/Vips).
 
-The [libvips reference manual](https://libvips.github.io/libvips/API/current/)
+The [libvips reference manual](https://www.libvips.org/API/current/)
 has a complete explanation of every method.
 
 The [`example/`](https://github.com/libvips/ruby-vips/tree/master/example)

data/VERSION

@@ -1 +1 @@
-2.2.3
+2.2.5

data/lib/vips/combine.rb

@@ -0,0 +1,10 @@
+module Vips
+  # How to combine values, see for example {Image#compass}.
+  #
+  # * `:max` take the maximum of the possible values
+  # * `:sum` sum all the values
+  # * `:min` take the minimum value
+
+  class Combine < Symbol
+  end
+end

data/lib/vips/fail_on.rb

@@ -0,0 +1,15 @@
+module Vips
+  # How sensitive loaders are to errors, from never stop (very insensitive),
+  # to stop on the smallest warning (very sensitive).
+  #
+  # Each implies the ones before it, so `:error` implies `:truncated`, for
+  # example.
+  #
+  # *   `:none` never stop
+  # *   `:truncated` stop on image truncated, nothing else
+  # *   `:error` stop on serious error or truncation
+  # *   `:warning` stop on anything, even warnings
+
+  class FailOn < Symbol
+  end
+end

data/lib/vips/foreign_dz_container.rb

@@ -0,0 +1,10 @@
+module Vips
+  # The container format to use
+  #
+  # *   `:fs` write tiles to the filesystem
+  # *   `:zip` write tiles to a zip file
+  # *   `:szi` write to a szi file
+
+  class ForeignDzContainer < Symbol
+  end
+end

data/lib/vips/foreign_dz_depth.rb

@@ -0,0 +1,10 @@
+module Vips
+  # How many pyramid layers to create.
+  #
+  # *   `:onepixel` create layers down to 1x1 pixel
+  # *   `:onetile` create layers down to 1x1 tile
+  # *   `:one` only create a single layer
+
+  class ForeignDzDepth < Symbol
+  end
+end

data/lib/vips/foreign_dz_layout.rb

@@ -0,0 +1,12 @@
+module Vips
+  # What directory layout and metadata standard to use.
+  #
+  # *   `:dz` use DeepZoom directory layout
+  # *   `:zoomify` use Zoomify directory layout
+  # *   `:google` use Google maps directory layout
+  # *   `:iiif` use IIIF v2 directory layout
+  # *   `:iiif3` use IIIF v3 directory layout
+
+  class ForeignDzLayout < Symbol
+  end
+end

data/lib/vips/foreign_heif_compression.rb

@@ -0,0 +1,11 @@
+module Vips
+  # The compression format to use inside a HEIF container
+  #
+  # *   `:hevc` x265
+  # *   `:avc` x264
+  # *   `:jpeg` jpeg
+  # *   `:av1` aom
+
+  class ForeignHeifCompression < Symbol
+  end
+end

data/lib/vips/foreign_heif_encoder.rb

@@ -0,0 +1,11 @@
+module Vips
+  # The selected encoder to use.
+  #
+  # *   `:auto` auto
+  # *   `:rav1e` RAV1E
+  # *   `:svt` SVT-AV1
+  # *   `:x265` x265
+
+  class ForeignHeifEncoder < Symbol
+  end
+end

data/lib/vips/foreign_keep.rb

@@ -0,0 +1,13 @@
+module Vips
+  # Savers can be given a set of metadata items to keep.
+  #
+  # *   `:none` remove all metadata
+  # *   `:exif` keep EXIF metadata
+  # *   `:xmp` keep XMP metadata
+  # *   `:iptc` keep IPTC metadata
+  # *   `:icc` keep ICC profiles
+  # *   `:other` keep other metadata
+
+  class ForeignKeep < Symbol
+  end
+end

data/lib/vips/foreign_png_filter.rb

@@ -0,0 +1,13 @@
+module Vips
+  # The set of filters for PNG save. See http://www.w3.org/TR/PNG-Filters.html
+  #
+  # *   `:none` no filtering
+  # *   `:sub` difference to the left
+  # *   `:up` difference up
+  # *   `:avg` average of left and up
+  # *   `:paeth` pick best neighbor predictor automatically
+  # *   `:all` adaptive
+
+  class ForeignPngFilter < Symbol
+  end
+end

data/lib/vips/foreign_ppm_format.rb

@@ -0,0 +1,12 @@
+module Vips
+  # The netpbm file format to save as.
+  #
+  # *   `:pbm` portable bitmap
+  # *   `:pgm` portable greymap
+  # *   `:ppm` portable pixmap
+  # *   `:pfm` portable float map
+  # *   `:pnm` portable anymap
+
+  class ForeignPpmFormat < Symbol
+  end
+end

data/lib/vips/foreign_subsample.rb

@@ -0,0 +1,10 @@
+module Vips
+  # Set subsampling mode.
+  #
+  # *   `:auto` prevent subsampling when quality >= 90
+  # *   `:on` always perform subsampling
+  # *   `:off` never perform subsampling
+
+  class ForeignSubsample < Symbol
+  end
+end

data/lib/vips/foreign_tiff_compression.rb

@@ -0,0 +1,16 @@
+module Vips
+  # The compression types supported by the tiff writer.
+  #
+  # *   `:none` no compression
+  # *   `:jpeg` jpeg compression
+  # *   `:deflate` deflate (zip) compression
+  # *   `:packbits` packbits compression
+  # *   `:ccittfax4` fax4 compression
+  # *   `:lzw` LZW compression
+  # *   `:webp` WEBP compression
+  # *   `:zstd` ZSTD compression
+  # *   `:jp2k` JP2K compression
+
+  class ForeignTiffCompression < Symbol
+  end
+end

data/lib/vips/foreign_tiff_predictor.rb

@@ -0,0 +1,10 @@
+module Vips
+  # The predictor can help deflate and lzw compression.
+  #
+  # *   `:none` no prediction
+  # *   `:horizontal` horizontal differencing
+  # *   `:float` float predictor
+
+  class ForeignTiffPredictor < Symbol
+  end
+end

data/lib/vips/foreign_tiff_resunit.rb

@@ -0,0 +1,9 @@
+module Vips
+  # Use inches or centimeters as the resolution unit for a tiff file.
+  #
+  # *   `:cm` use centimeters
+  # *   `:inch` use inches
+
+  class ForeignTiffResunit < Symbol
+  end
+end

data/lib/vips/foreign_webp_preset.rb

@@ -0,0 +1,13 @@
+module Vips
+  # Tune lossy encoder settings for different image types.
+  #
+  # *   `:default` default preset
+  # *   `:picture` digital picture, like portrait, inner shot
+  # *   `:photo` outdoor photograph, with natural lighting
+  # *   `:drawing` hand or line drawing, with high-contrast details
+  # *   `:icon` small-sized colorful images
+  # *   `:text` text-like
+
+  class ForeignWebpPreset < Symbol
+  end
+end

data/lib/vips/gvalue.rb

@@ -25,7 +25,7 @@ module GObject
       :data, [:ulong_long, 2]
 
     # convert an enum value (str/symb/int) into an int ready for libvips
-    def self.from_nick(gtype, value)
+    def self.enum_from_nick(gtype, value)
       value = value.to_s if value.is_a? Symbol
 
       if value.is_a? String
@@ -40,6 +40,43 @@ module GObject
       value
     end
 
+    # compatibility ... we used to call it this, perhaps someone has used this
+    # internal method
+    def self.from_nick(gtype, value)
+      GValue.enum_from_nick(gtype, value)
+    end
+
+    # convert an flags value (array[str/symb/int] | str/symb/int) into an
+    # int ready for libvips
+    def self.flags_from_nick(gtype, value)
+      if value.is_a? String
+        # libvips will parse strings like "sub|up" etc.
+        name = value.tr("_", "-")
+        value = Vips.vips_flags_from_nick "ruby-vips", gtype, name
+      else
+        value = [value] if !value.is_a? Array
+
+        # convert each item to a set of bits, OR them together
+        result = 0
+        value.map do |item|
+          item = item.to_s if item.is_a? Symbol
+          if item.is_a? String
+            name = item.tr("_", "-")
+            item = Vips.vips_flags_from_nick "ruby-vips", gtype, name
+            if item == -1
+              raise Vips::Error
+            end
+          end
+
+          result |= item
+        end
+
+        value = result
+      end
+
+      value
+    end
+
     # convert an int enum back into a symbol
     def self.to_nick(gtype, enum_value)
       enum_name = Vips.vips_enum_nick gtype, enum_value
@@ -148,10 +185,11 @@ module GObject
       else
         case fundamental
         when GFLAGS_TYPE
-          ::GObject.g_value_set_flags self, value
+          flags_value = GValue.flags_from_nick(self[:gtype], value)
+          ::GObject.g_value_set_flags self, flags_value
 
         when GENUM_TYPE
-          enum_value = GValue.from_nick(self[:gtype], value)
+          enum_value = GValue.enum_from_nick(self[:gtype], value)
           ::GObject.g_value_set_enum self, enum_value
 
         when GOBJECT_TYPE

data/lib/vips/image.rb

@@ -114,12 +114,12 @@ module Vips
     end
 
     def self.complex? format
-      format_number = GObject::GValue.from_nick BAND_FORMAT_TYPE, format
+      format_number = GObject::GValue.enum_from_nick BAND_FORMAT_TYPE, format
       Vips.vips_band_format_iscomplex(format_number) != 0
     end
 
     def self.float? format
-      format_number = GObject::GValue.from_nick BAND_FORMAT_TYPE, format
+      format_number = GObject::GValue.enum_from_nick BAND_FORMAT_TYPE, format
       Vips.vips_band_format_isfloat(format_number) != 0
     end
 
@@ -380,7 +380,7 @@ module Vips
         size = data.bytesize
       end
 
-      format_number = GObject::GValue.from_nick BAND_FORMAT_TYPE, format
+      format_number = GObject::GValue.enum_from_nick BAND_FORMAT_TYPE, format
       vi = Vips.vips_image_new_from_memory data, size,
         width, height, bands, format_number
       raise Vips::Error if vi.null?
@@ -405,7 +405,7 @@ module Vips
     # @param format [Symbol] band format
     # @return [Image] the loaded image
     def self.new_from_memory_copy data, width, height, bands, format
-      format_number = GObject::GValue.from_nick BAND_FORMAT_TYPE, format
+      format_number = GObject::GValue.enum_from_nick BAND_FORMAT_TYPE, format
 
       if data.is_a?(FFI::Pointer)
         if data.size == UNKNOWN_POINTER_SIZE
@@ -471,9 +471,10 @@ module Vips
     def self.matrix_from_array width, height, array
       ptr = FFI::MemoryPointer.new :double, array.length
       ptr.write_array_of_double array
-      image = Vips.vips_image_new_matrix_from_array width, height,
+      img_ptr = Vips.vips_image_new_matrix_from_array width, height,
         ptr, array.length
-      Vips::Image.new image
+      raise Vips::Error if img_ptr.null?
+      Vips::Image.new img_ptr
     end
 
     # Create a new Image from a 1D or 2D array. A 1D array becomes an
@@ -534,7 +535,6 @@ module Vips
       end
 
       image = Vips::Image.matrix_from_array width, height, array
-      raise Vips::Error if image.nil?
 
       image.mutate do |mutable|
         # be careful to set them as double
@@ -700,7 +700,7 @@ module Vips
     def write_to_memory
       len = Vips::SizeStruct.new
       ptr = Vips.vips_image_write_to_memory self, len
-      raise Vips::Error if ptr.nil?
+      raise Vips::Error if ptr.null?
 
       # wrap up as an autopointer
       ptr = FFI::AutoPointer.new(ptr, GLib::G_FREE)
@@ -1319,7 +1319,7 @@ module Vips
       end
 
       mode = mode.map do |x|
-        GObject::GValue.from_nick Vips::BLEND_MODE_TYPE, x
+        GObject::GValue.enum_from_nick Vips::BLEND_MODE_TYPE, x
       end
 
       Vips::Image.composite([self] + overlay, mode, **opts)

data/lib/vips/intent.rb

@@ -0,0 +1,12 @@
+module Vips
+  # The rendering intent.
+  #
+  # * `:perceptual` perceptual rendering intent
+  # * `:relative` relative colorimetric rendering intent
+  # * `:saturation` saturation rendering intent
+  # * `:absolute` absolute colorimetric rendering intent
+  # * `:auto` the rendering intent that the profile suggests
+
+  class Intent < Symbol
+  end
+end

data/lib/vips/interpolate.rb

@@ -50,7 +50,7 @@ module Vips
     def initialize name
       name = name.to_s if name.is_a? Symbol
       pointer = Vips.vips_interpolate_new name
-      raise Vips::Error if pointer.nil?
+      raise Vips::Error if pointer.null?
 
       super(pointer)
     end

data/lib/vips/interpretation.rb

@@ -6,7 +6,6 @@ module Vips
   # * `:multiband` generic many-band image
   # * `:b_w` some kind of single-band image
   # * `:histogram` a 1D image, eg. histogram or lookup table
-  # * `:fourier` image is in fourier space
   # * `:xyz` the first three bands are CIE XYZ
   # * `:lab` pixels are in CIE Lab space
   # * `:cmyk` the first four bands are in CMYK space
@@ -16,12 +15,14 @@ module Vips
   # * `:lch` pixels are in CIE LCh space
   # * `:labs` CIE LAB coded as three signed 16-bit values
   # * `:srgb` pixels are sRGB
-  # * `:hsv` pixels are HSV
-  # * `:scrgb` pixels are scRGB
   # * `:yxy` pixels are CIE Yxy
+  # * `:fourier` image is in fourier space
   # * `:rgb16` generic 16-bit RGB
   # * `:grey16` generic 16-bit mono
   # * `:matrix` a matrix
+  # * `:scrgb` pixels are scRGB
+  # * `:hsv` pixels are HSV
+
   class Interpretation < Symbol
   end
 end

data/lib/vips/kernel.rb

@@ -4,16 +4,19 @@ module Vips
   #
   # At least these should be available:
   #
-  # *   `:nearest` Nearest-neighbour interpolation.
-  # *   `:linear` Linear interpolation.
-  # *   `:cubic` Cubic interpolation.
-  # *   `:lanczos2` Two-lobe Lanczos
-  # *   `:lanczos3` Three-lobe Lanczos
+  # *   `:nearest` nearest-neighbour interpolation
+  # *   `:linear` linear interpolation
+  # *   `:cubic` cubic interpolation
+  # *   `:mitchell` Mitchell interpolation
+  # *   `:lanczos2` two-lobe Lanczos
+  # *   `:lanczos3` three-lobe Lanczos
+  # *   `:mks2013` convolve with Magic Kernel Sharp 2013
+  # *   `:mks2021` convolve with Magic Kernel Sharp 2021
   #
   #  For example:
   #
   #  ```ruby
-  #  im = im.resize 3, :kernel => :lanczos2
+  #  im = im.resize 3, kernel: :lanczos2
   #  ```
 
   class Kernel < Symbol

data/lib/vips/methods.rb

@@ -1018,8 +1018,19 @@ module Vips
 #   @option opts [Vips::ForeignFlags] :flags Output Flags for this file
 #   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
 
+# @!method self.ppmload_buffer(buffer, **opts)
+#   Load ppm from buffer.
+#   @param buffer [VipsBlob] Buffer to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Boolean] :memory Force open via memory
+#   @option opts [Vips::Access] :access Required access pattern for this file
+#   @option opts [Vips::FailOn] :fail_on Error level to fail on
+#   @option opts [Boolean] :revalidate Don't use a cached result for this operation
+#   @option opts [Vips::ForeignFlags] :flags Output Flags for this file
+#   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
+
 # @!method self.ppmload_source(source, **opts)
-#   Load ppm base class.
+#   Load ppm from source.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Boolean] :memory Force open via memory
@@ -1069,6 +1080,8 @@ module Vips
 #   @option opts [Float] :dpi Render at this DPI
 #   @option opts [Float] :scale Scale output by this factor
 #   @option opts [Boolean] :unlimited Allow SVG of any size
+#   @option opts [String] :stylesheet Custom CSS
+#   @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1083,6 +1096,8 @@ module Vips
 #   @option opts [Float] :dpi Render at this DPI
 #   @option opts [Float] :scale Scale output by this factor
 #   @option opts [Boolean] :unlimited Allow SVG of any size
+#   @option opts [String] :stylesheet Custom CSS
+#   @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1097,6 +1112,8 @@ module Vips
 #   @option opts [Float] :dpi Render at this DPI
 #   @option opts [Float] :scale Scale output by this factor
 #   @option opts [Boolean] :unlimited Allow SVG of any size
+#   @option opts [String] :stylesheet Custom CSS
+#   @option opts [Boolean] :high_bitdepth Enable scRGB 128-bit output (32-bit per channel)
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1109,6 +1126,7 @@ module Vips
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page Load this page from the image
+#   @option opts [Boolean] :oneshot Load images a frame at a time
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1121,6 +1139,7 @@ module Vips
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page Load this page from the image
+#   @option opts [Boolean] :oneshot Load images a frame at a time
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1133,6 +1152,7 @@ module Vips
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page Load this page from the image
+#   @option opts [Boolean] :oneshot Load images a frame at a time
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1315,9 +1335,10 @@ module Vips
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page First page to load
-#   @option opts [Integer] :subifd Subifd index
 #   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :autorotate Rotate image using orientation tag
+#   @option opts [Integer] :subifd Subifd index
+#   @option opts [Boolean] :unlimited Remove all denial of service limits
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1330,9 +1351,10 @@ module Vips
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page First page to load
-#   @option opts [Integer] :subifd Subifd index
 #   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :autorotate Rotate image using orientation tag
+#   @option opts [Integer] :subifd Subifd index
+#   @option opts [Boolean] :unlimited Remove all denial of service limits
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1345,9 +1367,10 @@ module Vips
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page First page to load
-#   @option opts [Integer] :subifd Subifd index
 #   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :autorotate Rotate image using orientation tag
+#   @option opts [Integer] :subifd Subifd index
+#   @option opts [Boolean] :unlimited Remove all denial of service limits
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
@@ -1578,7 +1601,7 @@ module Vips
 #   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
 
 # @!method self.magickload(filename, **opts)
-#   Load file with imagemagick.
+#   Load file with imagemagick7.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
 #   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
@@ -1592,7 +1615,7 @@ module Vips
 #   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
 
 # @!method self.magickload_buffer(buffer, **opts)
-#   Load buffer with imagemagick.
+#   Load buffer with imagemagick7.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
 #   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
@@ -1815,6 +1838,7 @@ module Vips
 #   @option opts [Boolean] :reuse Reuse palette from input
 #   @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
+#   @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
 #   @option opts [Vips::ForeignKeep] :keep Which metadata to retain
 #   @option opts [Array<Double>] :background Background value
 #   @option opts [Integer] :page_height Set page height for multipage save
@@ -1831,6 +1855,7 @@ module Vips
 #   @option opts [Boolean] :reuse Reuse palette from input
 #   @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
+#   @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
 #   @option opts [Vips::ForeignKeep] :keep Which metadata to retain
 #   @option opts [Array<Double>] :background Background value
 #   @option opts [Integer] :page_height Set page height for multipage save
@@ -1848,6 +1873,7 @@ module Vips
 #   @option opts [Boolean] :reuse Reuse palette from input
 #   @option opts [Float] :interpalette_maxerror Maximum inter-palette error for palette reusage
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) GIF
+#   @option opts [Boolean] :keep_duplicate_frames Keep duplicate frames in the output instead of combining them
 #   @option opts [Vips::ForeignKeep] :keep Which metadata to retain
 #   @option opts [Array<Double>] :background Background value
 #   @option opts [Integer] :page_height Set page height for multipage save
@@ -2388,8 +2414,8 @@ module Vips
 #   @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
 #   @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
 #   @option opts [Boolean] :linear Reduce in linear light
-#   @option opts [String] :import_profile Fallback import profile
-#   @option opts [String] :export_profile Fallback export profile
+#   @option opts [String] :input_profile Fallback input profile
+#   @option opts [String] :output_profile Fallback output profile
 #   @option opts [Vips::Intent] :intent Rendering intent
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
@@ -2405,8 +2431,8 @@ module Vips
 #   @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
 #   @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
 #   @option opts [Boolean] :linear Reduce in linear light
-#   @option opts [String] :import_profile Fallback import profile
-#   @option opts [String] :export_profile Fallback export profile
+#   @option opts [String] :input_profile Fallback input profile
+#   @option opts [String] :output_profile Fallback output profile
 #   @option opts [Vips::Intent] :intent Rendering intent
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
@@ -2420,8 +2446,8 @@ module Vips
 #   @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
 #   @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
 #   @option opts [Boolean] :linear Reduce in linear light
-#   @option opts [String] :import_profile Fallback import profile
-#   @option opts [String] :export_profile Fallback export profile
+#   @option opts [String] :input_profile Fallback input profile
+#   @option opts [String] :output_profile Fallback output profile
 #   @option opts [Vips::Intent] :intent Rendering intent
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
@@ -2437,8 +2463,8 @@ module Vips
 #   @option opts [Boolean] :no_rotate Don't use orientation tags to rotate image upright
 #   @option opts [Vips::Interesting] :crop Reduce to fill target rectangle, then crop
 #   @option opts [Boolean] :linear Reduce in linear light
-#   @option opts [String] :import_profile Fallback import profile
-#   @option opts [String] :export_profile Fallback export profile
+#   @option opts [String] :input_profile Fallback input profile
+#   @option opts [String] :output_profile Fallback output profile
 #   @option opts [Vips::Intent] :intent Rendering intent
 #   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
@@ -2605,6 +2631,16 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 
+# @!method scRGB2XYZ(**opts)
+#   Transform scrgb to xyz.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
+# @!method XYZ2scRGB(**opts)
+#   Transform xyz to scrgb.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
 # @!method LabQ2Lab(**opts)
 #   Unpack a labq image to float lab.
 #   @param opts [Hash] Set of options
@@ -2650,6 +2686,17 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 
+# @!method sRGB2scRGB(**opts)
+#   Convert an srgb image to scrgb.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
+# @!method scRGB2BW(**opts)
+#   Convert scrgb to bw.
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :depth Output device space depth in bits
+#   @return [Vips::Image] Output image
+
 # @!method sRGB2HSV(**opts)
 #   Transform srgb to hsv.
 #   @param opts [Hash] Set of options
@@ -2660,6 +2707,12 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 
+# @!method scRGB2sRGB(**opts)
+#   Convert scrgb to srgb.
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :depth Output device space depth in bits
+#   @return [Vips::Image] Output image
+
 # @!method icc_import(**opts)
 #   Import from device with icc profile.
 #   @param opts [Hash] Set of options
@@ -2710,33 +2763,6 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 
-# @!method sRGB2scRGB(**opts)
-#   Convert an srgb image to scrgb.
-#   @param opts [Hash] Set of options
-#   @return [Vips::Image] Output image
-
-# @!method scRGB2XYZ(**opts)
-#   Transform scrgb to xyz.
-#   @param opts [Hash] Set of options
-#   @return [Vips::Image] Output image
-
-# @!method scRGB2BW(**opts)
-#   Convert scrgb to bw.
-#   @param opts [Hash] Set of options
-#   @option opts [Integer] :depth Output device space depth in bits
-#   @return [Vips::Image] Output image
-
-# @!method XYZ2scRGB(**opts)
-#   Transform xyz to scrgb.
-#   @param opts [Hash] Set of options
-#   @return [Vips::Image] Output image
-
-# @!method scRGB2sRGB(**opts)
-#   Convert an scrgb image to srgb.
-#   @param opts [Hash] Set of options
-#   @option opts [Integer] :depth Output device space depth in bits
-#   @return [Vips::Image] Output image
-
 # @!method CMYK2XYZ(**opts)
 #   Transform cmyk to xyz.
 #   @param opts [Hash] Set of options
@@ -3123,7 +3149,13 @@ module Vips
 #   @return [Vips::Image] Output image
 
 # @!method matrixinvert(**opts)
-#   Invert an matrix.
+#   Invert a matrix.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output matrix
+
+# @!method matrixmultiply(right, **opts)
+#   Multiply two matrices.
+#   @param right [Vips::Image] Second matrix to multiply
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output matrix
 
@@ -3150,6 +3182,13 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Float] :gamma Image gamma
 #   @option opts [Boolean] :int_output Integer output
+#   @return [Vips::Image] Output image
+
+# @!method remosaic(old_str, new_str, **opts)
+#   Rebuild an mosaiced image.
+#   @param old_str [String] Search for this string
+#   @param new_str [String] And swap for this string
+#   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 
   end

data/lib/vips/object.rb

@@ -125,6 +125,7 @@ module Vips
 
   attach_function :vips_enum_from_nick, [:string, :GType, :string], :int
   attach_function :vips_enum_nick, [:GType, :int], :string
+  attach_function :vips_flags_from_nick, [:string, :GType, :string], :int
 
   attach_function :vips_value_set_ref_string,
     [GObject::GValue.ptr, :string], :void

data/lib/vips/operation_morphology.rb

@@ -0,0 +1,9 @@
+module Vips
+  # Pick a morphological operator.
+  #
+  # *   `:erode`  true if all set
+  # *   `:dilate` true if any set
+
+  class OperationMorphology < Symbol
+  end
+end

data/lib/vips/pcs.rb

@@ -0,0 +1,10 @@
+module Vips
+  # Pick a Profile Connection Space for {Image#icc_import} and
+  # {Image#icc_export}`.
+  #
+  # *   `:lab` use CIELAB D65 as the Profile Connection Space
+  # *   `:xyz` use XYZ as the Profile Connection Space
+
+  class PCS < Symbol
+  end
+end

data/lib/vips/precision.rb

@@ -0,0 +1,10 @@
+module Vips
+  # How accurate an operation should be.
+  #
+  # *   `:integer` int everywhere
+  # *   `:float` float everywhere
+  # *   `:approximate` approximate integer output
+
+  class Precision < Symbol
+  end
+end

data/lib/vips/region_shrink.rb

@@ -0,0 +1,13 @@
+module Vips
+  # ow to calculate the output pixels when shrinking a 2x2 region.
+  #
+  # *   `:mean` use the average
+  # *   `:median` use the median
+  # *   `:mode` use the mode
+  # *   `:max` use the maximum
+  # *   `:min` use the minimum
+  # *   `:nearest` use the top-left pixel
+
+  class RegionShrink < Symbol
+  end
+end

data/lib/vips/sdf_shape.rb

@@ -0,0 +1,11 @@
+module Vips
+  # The SDF to generate, see {Image.sdf}.
+  #
+  # *   `:circle` a circle at @a, radius @r
+  # *   `:box` a box from @a to @b
+  # *   `:rounded_box` a box with rounded @corners from @a to @b
+  # *   `:line` a line from @a to @b
+
+  class SdfShape < Symbol
+  end
+end

data/lib/vips/text_wrap.rb

@@ -0,0 +1,11 @@
+module Vips
+  # Sets the word wrapping style for {Image#text} when used with a
+  # maximum width.
+  #
+  # *   `:char` wrap at character boundaries
+  # *   `:word_char` wrap at word boundaries, but fall back to character boundaries if there is not enough space for a full word
+  # *   `:none` no wrapping
+
+  class TextWrap < Symbol
+  end
+end

data/lib/vips/version.rb

@@ -1,3 +1,3 @@
 module Vips
-  VERSION = "2.2.3"
+  VERSION = "2.2.5"
 end

data/lib/vips.rb

@@ -443,7 +443,7 @@ require "vips/gvalue"
 # It examines libvips and writes a summary of each operation and the arguments
 # and options that that operation expects.
 #
-# Use the [C API # docs](https://libvips.github.io/libvips/API/current)
+# Use the [C API docs](https://www.libvips.org/API/current/)
 # for more detail.
 #
 # # Enums
@@ -452,6 +452,19 @@ require "vips/gvalue"
 # like `:uchar`. They are documented as a set of classes for convenience, see
 # {Vips::BandFormat}, for example.
 #
+# # Flags
+#
+# Some operations take a set of flags as an argument, for example
+# {Image#pngsave} can be given a set of filters to use. These are documented
+# as a set of classes, see {Vips::ForeignPngFilter}, for
+# example.
+#
+# You can set flag arguments with an array of symbols, perhaps:
+#
+# ```ruby
+# image.pngsave "x.png", filter: [:sub, :up]
+# ```
+#
 # # Draw operations
 #
 # There are two ways of calling the libvips draw operations, like

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby-vips
 version: !ruby/object:Gem::Version
-  version: 2.2.3
+  version: 2.2.5
 platform: ruby
 authors:
 - John Cupitt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-06 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -164,13 +163,29 @@ files:
 - lib/vips/bandformat.rb
 - lib/vips/blend_mode.rb
 - lib/vips/coding.rb
+- lib/vips/combine.rb
 - lib/vips/compass_direction.rb
 - lib/vips/connection.rb
 - lib/vips/direction.rb
 - lib/vips/extend.rb
+- lib/vips/fail_on.rb
+- lib/vips/foreign_dz_container.rb
+- lib/vips/foreign_dz_depth.rb
+- lib/vips/foreign_dz_layout.rb
+- lib/vips/foreign_heif_compression.rb
+- lib/vips/foreign_heif_encoder.rb
+- lib/vips/foreign_keep.rb
+- lib/vips/foreign_png_filter.rb
+- lib/vips/foreign_ppm_format.rb
+- lib/vips/foreign_subsample.rb
+- lib/vips/foreign_tiff_compression.rb
+- lib/vips/foreign_tiff_predictor.rb
+- lib/vips/foreign_tiff_resunit.rb
+- lib/vips/foreign_webp_preset.rb
 - lib/vips/gobject.rb
 - lib/vips/gvalue.rb
 - lib/vips/image.rb
+- lib/vips/intent.rb
 - lib/vips/interesting.rb
 - lib/vips/interpolate.rb
 - lib/vips/interpretation.rb
@@ -179,6 +194,7 @@ files:
 - lib/vips/mutableimage.rb
 - lib/vips/object.rb
 - lib/vips/operation.rb
+- lib/vips/operation_morphology.rb
 - lib/vips/operationboolean.rb
 - lib/vips/operationcomplex.rb
 - lib/vips/operationcomplex2.rb
@@ -187,12 +203,17 @@ files:
 - lib/vips/operationmath2.rb
 - lib/vips/operationrelational.rb
 - lib/vips/operationround.rb
+- lib/vips/pcs.rb
+- lib/vips/precision.rb
 - lib/vips/region.rb
+- lib/vips/region_shrink.rb
+- lib/vips/sdf_shape.rb
 - lib/vips/size.rb
 - lib/vips/source.rb
 - lib/vips/sourcecustom.rb
 - lib/vips/target.rb
 - lib/vips/targetcustom.rb
+- lib/vips/text_wrap.rb
 - lib/vips/version.rb
 - ruby-vips.gemspec
 homepage: http://github.com/libvips/ruby-vips
@@ -205,7 +226,6 @@ metadata:
   homepage_uri: http://github.com/libvips/ruby-vips
   source_code_uri: https://github.com/libvips/ruby-vips
   msys2_mingw_dependencies: libvips
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -220,8 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.6.3
 specification_version: 4
 summary: A fast image processing library with low memory needs
 test_files: []