ruby-vips 2.2.5 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbcb710d3c731107872917d35da6b921cae90ebdafb88d7fc917e8556bf7c2fe
-  data.tar.gz: 3e594a080fb2258609ae1b427e5df60ede8d8aee2730102ce2045c9b96f4e830
+  metadata.gz: b025e3dd6e37cb95d8b77fea2351d2c8bef1d711cb8fd600d1532fed3ce606db
+  data.tar.gz: 245512b73bdb8db46af18c499060b2e2ab39ab2976c1eabc4866f0610fc51e0a
 SHA512:
-  metadata.gz: d85ea128b1db40b818a9beb854cb2ae26ae28efd55fd6f31cbceb88a46661e804fd6ed273f78406e7e5cc781e9bfdb99c35421e9ca995c15cc8446a4e2056ae1
-  data.tar.gz: 1e47faba504bc492b279a0d4ca8760c48c15e59a5c4eb9feaf88cb6ff8b453d6f08af63dd33ee7b3ef65daabf9badf37930157a10cc98447acc71930f1419543
+  metadata.gz: 28e0163d98af345d4b01536f508a28d052a594ee84e4a171d61960dc1af09c79c92aa063557cb5ff66b38f334c36f18ed3c262c13e68dcacbe65ee8ece277bef
+  data.tar.gz: 7a84837e453159d4126bc6dded6f3a6e3d76fdc43e1725fa6aa5d72b5bb6eeceb2c9240f05c8a4c3f804b56165bff3f0a7129b16b7573805eb38ae6246d7c66c

data/.github/workflows/test.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
@@ -47,7 +47,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## master
 
+## Version 2.3.0 (2025-12-10)
+
+* move library_name out of the global namespace and into FFI [jcupitt]
+* update docs for libvips 8.18 [jcupitt]
+* add Image#get_gainmap [jcupitt]
+* version bump to 2.3
+
 ## Version 2.2.5 (2025-08-20)
 
 * improve NULL pointer handling [dloebl]

data/VERSION

@@ -1 +1 @@
-2.2.5
+2.3.0

data/example/inheritance_with_refcount.rb

@@ -21,6 +21,7 @@ end
 
 module Libc
   extend FFI::Library
+
   ffi_lib FFI::Library::LIBC
 
   attach_function :malloc, [:size_t], :pointer
@@ -29,6 +30,7 @@ end
 
 module GLib
   extend FFI::Library
+
   ffi_lib "gobject-2.0"
 
   def self.set_log_domain(_domain)
@@ -142,6 +144,7 @@ end
 
 module Vips
   extend FFI::Library
+
   ffi_lib "vips"
 
   LOG_DOMAIN = "VIPS"

data/lib/vips/foreign_keep.rb

@@ -6,6 +6,7 @@ module Vips
   # *   `:xmp` keep XMP metadata
   # *   `:iptc` keep IPTC metadata
   # *   `:icc` keep ICC profiles
+  # *   `:gainmap` keep the gainmap metadata
   # *   `:other` keep other metadata
 
   class ForeignKeep < Symbol

data/lib/vips/image.rb

@@ -50,6 +50,10 @@ module Vips
     attach_function :vips_addalpha, [:pointer, :pointer, :varargs], :int
   end
 
+  if Vips.at_least_libvips?(8, 18)
+    attach_function :vips_image_get_gainmap, [:pointer], :pointer
+  end
+
   # move these three lines to mutableimage when we finally remove set and
   # remove in this class
   attach_function :vips_image_set,
@@ -797,8 +801,33 @@ module Vips
       names
     end
 
+    # Get the gainmap (if any) from an image.
+    #
+    # After modifying the gainmap, you should write it back to the image in a
+    # mutable block, see [#mutate], in the field "gainmap".
+    #
+    # For example:
+    #
+    # ```ruby
+    # gainmap = image.get_gainmap
+    # unless gainmap.nil?
+    #   new_gainmap = gainmap.crop left, top, width, height
+    #   image = image.mutate do |x|
+    #     x.set_type! Vips::IMAGE_TYPE, "gainmap", new_gainmap
+    #   end
+    # end
+    # ```
+    #
+    # @return [Image] the gainmap image, or nil
+    def get_gainmap
+      if Vips.at_least_libvips?(8, 18)
+        vi = Vips.vips_image_get_gainmap self
+        Image.new(vi) unless vi.null?
+      end
+    end
+
     # Mutate an image with a block. Inside the block, you can call methods
-    # which modify the image, such as setting or removing metadata, or
+    # which modify the image, such as setting or removing metadata or
     # modifying pixels.
     #
     # For example:
@@ -1173,11 +1202,7 @@ module Vips
     # @return [Image] result of inequality
     def != other
       # for equality, we must allow tests against nil
-      if other.nil?
-        true
-      else
-        call_enum "relational", other, :noteq
-      end
+      other.nil? || call_enum("relational", other, :noteq)
     end
 
     # Fetch bands using a number or a range

data/lib/vips/methods.rb

@@ -6,8 +6,9 @@ module Vips
 #   @param cmd_format [String] Command to run
 #   @param opts [Hash] Set of options
 #   @option opts [Array<Image>] :im Array of input images
-#   @option opts [String] :out_format Format for output filename
 #   @option opts [String] :in_format Format for input filename
+#   @option opts [String] :out_format Format for output filename
+#   @option opts [Boolean] :cache Cache this call
 #   @option opts [Vips::Image] :out Output Output image
 #   @option opts [String] :log Output Command log
 #   @return [nil, Hash<Symbol => Object>] Hash of optional output items
@@ -1199,6 +1200,78 @@ 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.dcrawload(filename, **opts)
+#   Load raw camera files.
+#   @param filename [String] Filename to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @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.dcrawload_buffer(buffer, **opts)
+#   Load raw camera files.
+#   @param buffer [VipsBlob] Buffer to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @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.dcrawload_source(source, **opts)
+#   Load raw camera files.
+#   @param source [Vips::Source] Source to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @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.uhdrload(filename, **opts)
+#   Load a uhdr image.
+#   @param filename [String] Filename to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :shrink Shrink factor on load
+#   @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.uhdrload_buffer(buffer, **opts)
+#   Load a uhdr image.
+#   @param buffer [VipsBlob] Buffer to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :shrink Shrink factor on load
+#   @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.uhdrload_source(source, **opts)
+#   Load a uhdr image.
+#   @param source [Vips::Source] Source to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :shrink Shrink factor on load
+#   @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.pngload(filename, **opts)
 #   Load png from file.
 #   @param filename [String] Filename to load from
@@ -1411,10 +1484,12 @@ 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.niftiload(filename, **opts)
-#   Load nifti volume.
+# @!method self.jxlload(filename, **opts)
+#   Load jpeg-xl image.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @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
@@ -1422,26 +1497,12 @@ 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.niftiload_source(source, **opts)
-#   Load nifti volumes.
-#   @param source [Vips::Source] Source 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.openslideload(filename, **opts)
-#   Load file with openslide.
-#   @param filename [String] Filename to load from
+# @!method self.jxlload_buffer(buffer, **opts)
+#   Load jpeg-xl image.
+#   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :level Load this level from the file
-#   @option opts [Boolean] :autocrop Crop to image bounds
-#   @option opts [String] :associated Load this associated image
-#   @option opts [Boolean] :attach_associated Attach all associated images
-#   @option opts [Boolean] :rgb Output RGB (not RGBA)
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @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
@@ -1449,15 +1510,12 @@ 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.openslideload_source(source, **opts)
-#   Load source with openslide.
+# @!method self.jxlload_source(source, **opts)
+#   Load jpeg-xl image.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :level Load this level from the file
-#   @option opts [Boolean] :autocrop Crop to image bounds
-#   @option opts [String] :associated Load this associated image
-#   @option opts [Boolean] :attach_associated Attach all associated images
-#   @option opts [Boolean] :rgb Output RGB (not RGBA)
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @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
@@ -1510,12 +1568,17 @@ 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.jxlload(filename, **opts)
-#   Load jpeg-xl image.
+# @!method self.pdfload(filename, **opts)
+#   Load pdf from file (poppler).
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page First page to load
 #   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Float] :dpi DPI to render at
+#   @option opts [Float] :scale Factor to scale by
+#   @option opts [Array<Double>] :background Background colour
+#   @option opts [String] :password Password to decrypt with
+#   @option opts [Vips::ForeignPdfPageBox] :page_box The region of the page to render
 #   @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
@@ -1523,12 +1586,17 @@ 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.jxlload_buffer(buffer, **opts)
-#   Load jpeg-xl image.
+# @!method self.pdfload_buffer(buffer, **opts)
+#   Load pdf from buffer (poppler).
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :page First page to load
 #   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Float] :dpi DPI to render at
+#   @option opts [Float] :scale Factor to scale by
+#   @option opts [Array<Double>] :background Background colour
+#   @option opts [String] :password Password to decrypt with
+#   @option opts [Vips::ForeignPdfPageBox] :page_box The region of the page to render
 #   @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
@@ -1536,12 +1604,17 @@ 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.jxlload_source(source, **opts)
-#   Load jpeg-xl image.
+# @!method self.pdfload_source(source, **opts)
+#   Load pdf from source (poppler).
 #   @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] :n Number of pages to load, -1 for all
+#   @option opts [Float] :dpi DPI to render at
+#   @option opts [Float] :scale Factor to scale by
+#   @option opts [Array<Double>] :background Background colour
+#   @option opts [String] :password Password to decrypt with
+#   @option opts [Vips::ForeignPdfPageBox] :page_box The region of the page to render
 #   @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
@@ -1549,16 +1622,13 @@ 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.pdfload(filename, **opts)
-#   Load pdf from file.
+# @!method self.magickload(filename, **opts)
+#   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
 #   @option opts [Integer] :page First page to load
 #   @option opts [Integer] :n Number of pages to load, -1 for all
-#   @option opts [Float] :dpi DPI to render at
-#   @option opts [Float] :scale Factor to scale by
-#   @option opts [Array<Double>] :background Background colour
-#   @option opts [String] :password Password to decrypt with
 #   @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
@@ -1566,16 +1636,13 @@ 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.pdfload_buffer(buffer, **opts)
-#   Load pdf from buffer.
+# @!method self.magickload_buffer(buffer, **opts)
+#   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
 #   @option opts [Integer] :page First page to load
 #   @option opts [Integer] :n Number of pages to load, -1 for all
-#   @option opts [Float] :dpi DPI to render at
-#   @option opts [Float] :scale Factor to scale by
-#   @option opts [Array<Double>] :background Background colour
-#   @option opts [String] :password Password to decrypt with
 #   @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
@@ -1583,16 +1650,13 @@ 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.pdfload_source(source, **opts)
-#   Load pdf from source.
+# @!method self.magickload_source(source, **opts)
+#   Load source with imagemagick7.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
+#   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
 #   @option opts [Integer] :page First page to load
 #   @option opts [Integer] :n Number of pages to load, -1 for all
-#   @option opts [Float] :dpi DPI to render at
-#   @option opts [Float] :scale Factor to scale by
-#   @option opts [Array<Double>] :background Background colour
-#   @option opts [String] :password Password to decrypt with
 #   @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
@@ -1600,13 +1664,15 @@ 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.magickload(filename, **opts)
-#   Load file with imagemagick7.
+# @!method self.openslideload(filename, **opts)
+#   Load file with openslide.
 #   @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
-#   @option opts [Integer] :page First page to load
-#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Integer] :level Load this level from the file
+#   @option opts [Boolean] :autocrop Crop to image bounds
+#   @option opts [String] :associated Load this associated image
+#   @option opts [Boolean] :attach_associated Attach all associated images
+#   @option opts [Boolean] :rgb Output RGB (not RGBA)
 #   @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
@@ -1614,13 +1680,15 @@ 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.magickload_buffer(buffer, **opts)
-#   Load buffer with imagemagick7.
-#   @param buffer [VipsBlob] Buffer to load from
+# @!method self.openslideload_source(source, **opts)
+#   Load source with openslide.
+#   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
-#   @option opts [Integer] :page First page to load
-#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Integer] :level Load this level from the file
+#   @option opts [Boolean] :autocrop Crop to image bounds
+#   @option opts [String] :associated Load this associated image
+#   @option opts [Boolean] :attach_associated Attach all associated images
+#   @option opts [Boolean] :rgb Output RGB (not RGBA)
 #   @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
@@ -1827,6 +1895,38 @@ module Vips
 #   @option opts [String] :profile Filename of ICC profile to embed
 #   @return [nil] 
 
+# @!method uhdrsave(filename, **opts)
+#   Save image in ultrahdr format.
+#   @param filename [String] Filename to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :Q Q factor
+#   @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
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @return [nil] 
+
+# @!method uhdrsave_buffer(**opts)
+#   Save image in ultrahdr format.
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :Q Q factor
+#   @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
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @return [VipsBlob] Buffer to save to
+
+# @!method uhdrsave_target(target, **opts)
+#   Save image in ultrahdr format.
+#   @param target [Vips::Target] Target to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :Q Q factor
+#   @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
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @return [nil] 
+
 # @!method gifsave(filename, **opts)
 #   Save as gif.
 #   @param filename [String] Filename to save to
@@ -1957,7 +2057,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
+#   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
@@ -1974,7 +2074,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
+#   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
@@ -1992,7 +2092,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [Vips::ForeignPngFilter] :filter libspng row filter flag(s)
+#   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
@@ -2005,7 +2105,7 @@ module Vips
 #   @return [nil] 
 
 # @!method jpegsave(filename, **opts)
-#   Save image to jpeg file.
+#   Save as jpeg.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
@@ -2024,7 +2124,7 @@ module Vips
 #   @return [nil] 
 
 # @!method jpegsave_buffer(**opts)
-#   Save image to jpeg buffer.
+#   Save as jpeg.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
@@ -2042,7 +2142,7 @@ module Vips
 #   @return [VipsBlob] Buffer to save to
 
 # @!method jpegsave_target(target, **opts)
-#   Save image to jpeg target.
+#   Save as jpeg.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
@@ -2084,6 +2184,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Boolean] :exact Preserve color values from transparent pixels
 #   @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
 #   @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
 #   @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
@@ -2107,6 +2208,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Boolean] :exact Preserve color values from transparent pixels
 #   @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
 #   @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
 #   @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
@@ -2131,6 +2233,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Boolean] :exact Preserve color values from transparent pixels
 #   @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
 #   @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
 #   @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
@@ -2154,6 +2257,7 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Boolean] :exact Preserve color values from transparent pixels
 #   @option opts [Vips::ForeignWebpPreset] :preset Preset for lossy compression
 #   @option opts [Boolean] :smart_subsample Enable high quality chroma subsampling
 #   @option opts [Boolean] :near_lossless Enable preprocessing in lossless mode (uses Q)
@@ -2271,10 +2375,47 @@ module Vips
 #   @option opts [String] :profile Filename of ICC profile to embed
 #   @return [nil] 
 
-# @!method niftisave(filename, **opts)
-#   Save image to nifti file.
+# @!method jxlsave(filename, **opts)
+#   Save image in jpeg-xl format.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
+#   @option opts [Integer] :tier Decode speed tier
+#   @option opts [Float] :distance Target butteraugli distance
+#   @option opts [Integer] :effort Encoding effort
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Integer] :Q Quality factor
+#   @option opts [Integer] :bitdepth Bit depth
+#   @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
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @return [nil] 
+
+# @!method jxlsave_buffer(**opts)
+#   Save image in jpeg-xl format.
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :tier Decode speed tier
+#   @option opts [Float] :distance Target butteraugli distance
+#   @option opts [Integer] :effort Encoding effort
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Integer] :Q Quality factor
+#   @option opts [Integer] :bitdepth Bit depth
+#   @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
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @return [VipsBlob] Buffer to save to
+
+# @!method jxlsave_target(target, **opts)
+#   Save image in jpeg-xl format.
+#   @param target [Vips::Target] Target to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :tier Decode speed tier
+#   @option opts [Float] :distance Target butteraugli distance
+#   @option opts [Integer] :effort Encoding effort
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [Integer] :Q Quality factor
+#   @option opts [Integer] :bitdepth Bit depth
 #   @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
@@ -2292,6 +2433,7 @@ module Vips
 #   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
 #   @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
+#   @option opts [String] :tune Tuning parameters
 #   @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
@@ -2308,6 +2450,7 @@ module Vips
 #   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
 #   @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
+#   @option opts [String] :tune Tuning parameters
 #   @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
@@ -2325,50 +2468,7 @@ module Vips
 #   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
 #   @option opts [Vips::ForeignHeifEncoder] :encoder Select encoder to use
-#   @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
-#   @option opts [String] :profile Filename of ICC profile to embed
-#   @return [nil] 
-
-# @!method jxlsave(filename, **opts)
-#   Save image in jpeg-xl format.
-#   @param filename [String] Filename to save to
-#   @param opts [Hash] Set of options
-#   @option opts [Integer] :tier Decode speed tier
-#   @option opts [Float] :distance Target butteraugli distance
-#   @option opts [Integer] :effort Encoding effort
-#   @option opts [Boolean] :lossless Enable lossless compression
-#   @option opts [Integer] :Q Quality factor
-#   @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
-#   @option opts [String] :profile Filename of ICC profile to embed
-#   @return [nil] 
-
-# @!method jxlsave_buffer(**opts)
-#   Save image in jpeg-xl format.
-#   @param opts [Hash] Set of options
-#   @option opts [Integer] :tier Decode speed tier
-#   @option opts [Float] :distance Target butteraugli distance
-#   @option opts [Integer] :effort Encoding effort
-#   @option opts [Boolean] :lossless Enable lossless compression
-#   @option opts [Integer] :Q Quality factor
-#   @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
-#   @option opts [String] :profile Filename of ICC profile to embed
-#   @return [VipsBlob] Buffer to save to
-
-# @!method jxlsave_target(target, **opts)
-#   Save image in jpeg-xl format.
-#   @param target [Vips::Target] Target to save to
-#   @param opts [Hash] Set of options
-#   @option opts [Integer] :tier Decode speed tier
-#   @option opts [Float] :distance Target butteraugli distance
-#   @option opts [Integer] :effort Encoding effort
-#   @option opts [Boolean] :lossless Enable lossless compression
-#   @option opts [Integer] :Q Quality factor
+#   @option opts [String] :tune Tuning parameters
 #   @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
@@ -2589,6 +2689,26 @@ module Vips
 #   @option opts [Vips::Interpretation] :source_space Source color space
 #   @return [Vips::Image] Output image
 
+# @!method Oklab2Oklch(**opts)
+#   Transform oklab to oklch.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
+# @!method Oklch2Oklab(**opts)
+#   Transform oklch to oklab.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
+# @!method Oklab2XYZ(**opts)
+#   Transform oklab to xyz.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
+# @!method XYZ2Oklab(**opts)
+#   Transform xyz to oklab.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
 # @!method Lab2XYZ(**opts)
 #   Transform cielab to xyz.
 #   @param opts [Hash] Set of options
@@ -2745,6 +2865,11 @@ module Vips
 #   @option opts [Integer] :depth Output device space depth in bits
 #   @return [Vips::Image] Output image
 
+# @!method uhdr2scRGB(**opts)
+#   Transform uhdr to scrgb.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+
 # @!method dE76(right, **opts)
 #   Calculate de76.
 #   @param right [Vips::Image] Right-hand input image

data/lib/vips/mutableimage.rb

@@ -12,6 +12,7 @@ module Vips
   # {Vips::Image#mutate}.
   class MutableImage < Vips::Object
     extend Forwardable
+
     alias_method :parent_get_typeof, :get_typeof
     def_instance_delegators :@image, :width, :height, :bands, :format,
       :interpretation, :filename, :xoffset, :yoffset, :xres, :yres, :size,

data/lib/vips/version.rb

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

data/lib/vips.rb

@@ -23,13 +23,15 @@ require "logger"
 # windows:
 #   The ABI number must be included, but with a hyphen. ffi does not add a
 #   "lib" prefix or a ".dll" suffix.
-def library_name(name, abi_number)
-  if FFI::Platform.windows?
-    "lib#{name}-#{abi_number}.dll"
-  elsif FFI::Platform.mac?
-    "#{name}.#{abi_number}"
-  else
-    "#{name}.so.#{abi_number}"
+module FFI
+  def self.library_name(name, abi_number)
+    if Platform.windows?
+      "lib#{name}-#{abi_number}.dll"
+    elsif Platform.mac?
+      "#{name}.#{abi_number}"
+    else
+      "#{name}.so.#{abi_number}"
+    end
   end
 end
 
@@ -43,7 +45,7 @@ end
 module Vips
   extend FFI::Library
 
-  ffi_lib library_name("vips", 42)
+  ffi_lib FFI.library_name("vips", 42)
 
   begin
     attach_function :g_malloc, [:size_t], :pointer
@@ -67,9 +69,9 @@ module GLib
   extend FFI::Library
 
   if Vips.unified?
-    ffi_lib library_name("vips", 42)
+    ffi_lib FFI.library_name("vips", 42)
   else
-    ffi_lib library_name("glib-2.0", 0)
+    ffi_lib FFI.library_name("glib-2.0", 0)
   end
 
   attach_function :g_malloc, [:size_t], :pointer
@@ -163,9 +165,9 @@ module GObject
   extend FFI::Library
 
   if Vips.unified?
-    ffi_lib library_name("vips", 42)
+    ffi_lib FFI.library_name("vips", 42)
   else
-    ffi_lib library_name("gobject-2.0", 0)
+    ffi_lib FFI.library_name("gobject-2.0", 0)
   end
 
   # we can't just use ulong, windows has different int sizing rules

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby-vips
 version: !ruby/object:Gem::Version
-  version: 2.2.5
+  version: 2.3.0
 platform: ruby
 authors:
 - John Cupitt
 bindir: bin
 cert_chain: []
-date: 2025-08-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -240,7 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.6.7
 specification_version: 4
 summary: A fast image processing library with low memory needs
 test_files: []