RubyGems - ruby-vips - Versions diffs - 2.1.3 → 2.2.0 - Mend

ruby-vips 2.1.3 → 2.2.0

Files changed (14) hide show

data/lib/vips/methods.rb CHANGED Viewed

@@ -39,7 +39,7 @@ module Vips
 # @!method relational(right, relational, **opts)
 #   Relational operation on two images.
 #   @param right [Vips::Image] Right-hand image argument
-#   @param relational [Vips::OperationRelational] relational to perform
+#   @param relational [Vips::OperationRelational] Relational to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -52,21 +52,21 @@ module Vips
 # @!method boolean(right, boolean, **opts)
 #   Boolean operation on two images.
 #   @param right [Vips::Image] Right-hand image argument
-#   @param boolean [Vips::OperationBoolean] boolean to perform
+#   @param boolean [Vips::OperationBoolean] Boolean to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method math2(right, math2, **opts)
 #   Binary math operations.
 #   @param right [Vips::Image] Right-hand image argument
-#   @param math2 [Vips::OperationMath2] math to perform
+#   @param math2 [Vips::OperationMath2] Math to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method complex2(right, cmplx, **opts)
 #   Complex binary operations on two images.
 #   @param right [Vips::Image] Right-hand image argument
-#   @param cmplx [Vips::OperationComplex2] binary complex operation to perform
+#   @param cmplx [Vips::OperationComplex2] Binary complex operation to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -97,7 +97,7 @@ module Vips
 # @!method math(math, **opts)
 #   Apply a math operation to an image.
-#   @param math [Vips::OperationMath] math to perform
+#   @param math [Vips::OperationMath] Math to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -113,13 +113,13 @@ module Vips
 # @!method round(round, **opts)
 #   Perform a round function on an image.
-#   @param round [Vips::OperationRound] rounding operation to perform
+#   @param round [Vips::OperationRound] Rounding operation to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method relational_const(relational, c, **opts)
 #   Relational operations against a constant.
-#   @param relational [Vips::OperationRelational] relational to perform
+#   @param relational [Vips::OperationRelational] Relational to perform
 #   @param c [Array<Double>] Array of constants
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -132,27 +132,27 @@ module Vips
 # @!method boolean_const(boolean, c, **opts)
 #   Boolean operations against a constant.
-#   @param boolean [Vips::OperationBoolean] boolean to perform
+#   @param boolean [Vips::OperationBoolean] Boolean to perform
 #   @param c [Array<Double>] Array of constants
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method math2_const(math2, c, **opts)
 #   Binary math operations with a constant.
-#   @param math2 [Vips::OperationMath2] math to perform
+#   @param math2 [Vips::OperationMath2] Math to perform
 #   @param c [Array<Double>] Array of constants
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method complex(cmplx, **opts)
 #   Perform a complex operation on an image.
-#   @param cmplx [Vips::OperationComplex] complex to perform
+#   @param cmplx [Vips::OperationComplex] Complex to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
 # @!method complexget(get, **opts)
 #   Get a component from a complex image.
-#   @param get [Vips::OperationComplexget] complex to perform
+#   @param get [Vips::OperationComplexget] Complex to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -215,7 +215,7 @@ module Vips
 # @!method hough_line(**opts)
 #   Find hough line transform.
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :width horizontal size of parameter space
+#   @option opts [Integer] :width Horizontal size of parameter space
 #   @option opts [Integer] :height Vertical size of parameter space
 #   @return [Vips::Image] Output image
@@ -260,12 +260,12 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Float] :threshold Object threshold
 #   @option opts [Array<Double>] :background Color for background pixels
+#   @option opts [Boolean] :line_art Enable line art mode
 #   @return [Array<Integer, Integer, Integer, Integer>] Left edge of image, Top edge of extract area, Width of extract area, Height of extract area
 # @!method copy(**opts)
 #   Copy an image.
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :swap Swap bytes in image between little and big-endian
 #   @option opts [Integer] :width Image width in pixels
 #   @option opts [Integer] :height Image height in pixels
 #   @option opts [Integer] :bands Number of bands in image
@@ -301,9 +301,7 @@ module Vips
 # @!method sequential(**opts)
 #   Check sequential access.
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :trace trace pixel requests
 #   @option opts [Integer] :tile_height Tile height in pixels
-#   @option opts [Vips::Access] :access Expected access pattern
 #   @return [Vips::Image] Output image
 # @!method cache(**opts)
@@ -327,7 +325,7 @@ module Vips
 # @!method gravity(direction, width, height, **opts)
 #   Place an image within a larger image with a certain gravity.
-#   @param direction [Vips::CompassDirection] direction to place image within width/height
+#   @param direction [Vips::CompassDirection] Direction to place image within width/height
 #   @param width [Integer] Image width in pixels
 #   @param height [Integer] Image height in pixels
 #   @param opts [Hash] Set of options
@@ -399,7 +397,10 @@ module Vips
 #   @param height [Integer] Height of extract area
 #   @param opts [Hash] Set of options
 #   @option opts [Vips::Interesting] :interesting How to measure interestingness
-#   @return [Vips::Image] Output image
+#   @option opts [Boolean] :premultiplied Input image already has premultiplied alpha
+#   @option opts [Integer] :attention_x Output Horizontal position of attention centre
+#   @option opts [Integer] :attention_y Output Vertical position of attention centre
+#   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
 # @!method extract_band(band, **opts)
 #   Extract band from an image.
@@ -428,7 +429,7 @@ module Vips
 # @!method bandbool(boolean, **opts)
 #   Boolean operation across image bands.
-#   @param boolean [Vips::OperationBoolean] boolean to perform
+#   @param boolean [Vips::OperationBoolean] Boolean to perform
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -467,7 +468,7 @@ module Vips
 # @!method recomb(m, **opts)
 #   Linear recombination with matrix.
-#   @param m [Vips::Image] matrix of coefficients
+#   @param m [Vips::Image] Matrix of coefficients
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -505,9 +506,9 @@ module Vips
 # @!method grid(tile_height, across, down, **opts)
 #   Grid an image.
-#   @param tile_height [Integer] chop into tiles this high
-#   @param across [Integer] number of tiles across
-#   @param down [Integer] number of tiles down
+#   @param tile_height [Integer] Chop into tiles this high
+#   @param across [Integer] Number of tiles across
+#   @param down [Integer] Number of tiles down
 #   @param opts [Hash] Set of options
 #   @return [Vips::Image] Output image
@@ -606,17 +607,15 @@ module Vips
 #   @param min_ampl [Float] Minimum amplitude of Gaussian
 #   @param opts [Hash] Set of options
 #   @option opts [Boolean] :separable Generate separable Gaussian
-#   @option opts [Boolean] :integer Generate integer Gaussian
 #   @option opts [Vips::Precision] :precision Generate with this precision
 #   @return [Vips::Image] Output image
 # @!method self.logmat(sigma, min_ampl, **opts)
 #   Make a laplacian of gaussian image.
-#   @param sigma [Float] Radius of Logmatian
-#   @param min_ampl [Float] Minimum amplitude of Logmatian
+#   @param sigma [Float] Radius of Gaussian
+#   @param min_ampl [Float] Minimum amplitude of Gaussian
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :separable Generate separable Logmatian
-#   @option opts [Boolean] :integer Generate integer Logmatian
+#   @option opts [Boolean] :separable Generate separable Gaussian
 #   @option opts [Vips::Precision] :precision Generate with this precision
 #   @return [Vips::Image] Output image
@@ -628,11 +627,12 @@ module Vips
 #   @option opts [Integer] :width Maximum image width in pixels
 #   @option opts [Integer] :height Maximum image height in pixels
 #   @option opts [Vips::Align] :align Align on the low, centre or high edge
-#   @option opts [Boolean] :rgba Enable RGBA output
-#   @option opts [Integer] :dpi DPI to render at
 #   @option opts [Boolean] :justify Justify lines
+#   @option opts [Integer] :dpi DPI to render at
 #   @option opts [Integer] :spacing Line spacing
 #   @option opts [String] :fontfile Load this font file
+#   @option opts [Boolean] :rgba Enable RGBA output
+#   @option opts [Vips::TextWrap] :wrap Wrap lines on word or character boundaries
 #   @option opts [Integer] :autofit_dpi Output DPI selected by autofit
 #   @return [Vips::Image, Hash<Symbol => Object>] Output image, Hash of optional output items
@@ -702,7 +702,7 @@ module Vips
 #   @param height [Integer] Image height in pixels
 #   @param frequency_cutoff_x [Float] Frequency cutoff x
 #   @param frequency_cutoff_y [Float] Frequency cutoff y
-#   @param radius [Float] radius of circle
+#   @param radius [Float] Radius of circle
 #   @param opts [Hash] Set of options
 #   @option opts [Boolean] :uchar Output an unsigned char image
 #   @option opts [Boolean] :nodc Remove DC component
@@ -746,7 +746,7 @@ module Vips
 #   @param order [Float] Filter order
 #   @param frequency_cutoff_x [Float] Frequency cutoff x
 #   @param frequency_cutoff_y [Float] Frequency cutoff y
-#   @param radius [Float] radius of circle
+#   @param radius [Float] Radius of circle
 #   @param amplitude_cutoff [Float] Amplitude cutoff
 #   @param opts [Hash] Set of options
 #   @option opts [Boolean] :uchar Output an unsigned char image
@@ -788,7 +788,7 @@ module Vips
 #   @param height [Integer] Image height in pixels
 #   @param frequency_cutoff_x [Float] Frequency cutoff x
 #   @param frequency_cutoff_y [Float] Frequency cutoff y
-#   @param radius [Float] radius of circle
+#   @param radius [Float] Radius of circle
 #   @param amplitude_cutoff [Float] Amplitude cutoff
 #   @param opts [Hash] Set of options
 #   @option opts [Boolean] :uchar Output an unsigned char image
@@ -886,9 +886,8 @@ module Vips
 #   @option opts [String] :separator Set of separator characters
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -902,9 +901,8 @@ module Vips
 #   @option opts [String] :separator Set of separator characters
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -914,9 +912,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -926,9 +923,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -944,9 +940,8 @@ module Vips
 #   @option opts [Vips::Interpretation] :interpretation Pixel interpretation
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -956,9 +951,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -968,9 +962,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -980,9 +973,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -992,9 +984,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1004,9 +995,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1016,9 +1006,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1028,9 +1017,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1040,9 +1028,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1055,9 +1042,8 @@ module Vips
 #   @option opts [Boolean] :unlimited Allow SVG of any size
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1070,9 +1056,8 @@ module Vips
 #   @option opts [Boolean] :unlimited Allow SVG of any size
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1085,45 +1070,8 @@ module Vips
 #   @option opts [Boolean] :unlimited Allow SVG of any size
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
-#   @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.
-#   @param filename [String] Filename 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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
-#   @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.
-#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
-#   @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.
-#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1134,9 +1082,8 @@ module Vips
 #   @option opts [Integer] :page Load this page from the image
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1147,9 +1094,8 @@ module Vips
 #   @option opts [Integer] :page Load this page from the image
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1160,9 +1106,8 @@ module Vips
 #   @option opts [Integer] :page Load this page from the image
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1170,13 +1115,12 @@ module Vips
 #   Load gif with libnsgif.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Integer] :page Load this page from the file
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Integer] :page First page to load
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1184,13 +1128,12 @@ module Vips
 #   Load gif with libnsgif.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Integer] :page Load this page from the file
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Integer] :page First page to load
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1198,13 +1141,12 @@ module Vips
 #   Load gif from source.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Integer] :page Load this page from the file
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Integer] :page First page to load
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1212,11 +1154,11 @@ module Vips
 #   Load png from file.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1224,11 +1166,11 @@ module Vips
 #   Load png from buffer.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1236,11 +1178,11 @@ module Vips
 #   Load png from source.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1250,9 +1192,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1262,11 +1203,11 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :shrink Shrink factor on load
 #   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1276,11 +1217,11 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :shrink Shrink factor on load
 #   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1290,11 +1231,11 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :shrink Shrink factor on load
 #   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1302,15 +1243,13 @@ module Vips
 #   Load webp from file.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :scale Scale factor on load
-#   @option opts [Integer] :shrink Shrink factor on load
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Float] :scale Factor to scale by
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1318,15 +1257,13 @@ module Vips
 #   Load webp from buffer.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :scale Scale factor on load
-#   @option opts [Integer] :shrink Shrink factor on load
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Float] :scale Factor to scale by
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1334,15 +1271,13 @@ module Vips
 #   Load webp from source.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :scale Scale factor on load
-#   @option opts [Integer] :shrink Shrink factor on load
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
+#   @option opts [Float] :scale Factor to scale by
 #   @option opts [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1350,15 +1285,14 @@ module Vips
 #   Load tiff from file.
 #   @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 [Integer] :subifd Select subifd index
-#   @option opts [Integer] :n Load this many pages
+#   @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 [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1366,15 +1300,14 @@ module Vips
 #   Load tiff from buffer.
 #   @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 [Integer] :subifd Select subifd index
-#   @option opts [Integer] :n Load this many pages
+#   @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 [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1382,15 +1315,14 @@ module Vips
 #   Load tiff from source.
 #   @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 [Integer] :subifd Select subifd index
-#   @option opts [Integer] :n Load this many pages
+#   @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 [Boolean] :memory Force open via memory
 #   @option opts [Vips::Access] :access Required access pattern for this file
-#   @option opts [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1400,9 +1332,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1412,9 +1343,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1424,9 +1354,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1436,9 +1365,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1448,9 +1376,8 @@ module Vips
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1458,15 +1385,15 @@ module Vips
 #   Load file with openslide.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :attach_associated Attach all associated images
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1474,15 +1401,15 @@ module Vips
 #   Load source with openslide.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :attach_associated Attach all associated images
 #   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1490,15 +1417,14 @@ module Vips
 #   Load a heif image.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :thumbnail Fetch thumbnail image
-#   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1506,15 +1432,14 @@ module Vips
 #   Load a heif image.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :thumbnail Fetch thumbnail image
-#   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1522,15 +1447,47 @@ module Vips
 #   Load a heif image.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
+#   @option opts [Integer] :page First page to load
+#   @option opts [Integer] :n Number of pages to load, -1 for all
 #   @option opts [Boolean] :thumbnail Fetch thumbnail image
-#   @option opts [Boolean] :autorotate Rotate image using exif orientation
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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.jxlload(filename, **opts)
+#   Load jpeg-xl image.
+#   @param filename [String] Filename 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.jxlload_buffer(buffer, **opts)
+#   Load jpeg-xl image.
+#   @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.jxlload_source(source, **opts)
+#   Load jpeg-xl image.
+#   @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
@@ -1538,16 +1495,16 @@ module Vips
 #   Load pdf from file.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :dpi Render at this DPI
-#   @option opts [Float] :scale Scale output by this factor
-#   @option opts [Array<Double>] :background Background value
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1555,16 +1512,16 @@ module Vips
 #   Load pdf from buffer.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :dpi Render at this DPI
-#   @option opts [Float] :scale Scale output by this factor
-#   @option opts [Array<Double>] :background Background value
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1572,16 +1529,16 @@ module Vips
 #   Load pdf from source.
 #   @param source [Vips::Source] Source to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
-#   @option opts [Float] :dpi Render at this DPI
-#   @option opts [Float] :scale Scale output by this factor
-#   @option opts [Array<Double>] :background Background value
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1589,15 +1546,13 @@ module Vips
 #   Load file with imagemagick.
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :all_frames Read all frames from an image
 #   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1605,15 +1560,13 @@ module Vips
 #   Load buffer with imagemagick.
 #   @param buffer [VipsBlob] Buffer to load from
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :all_frames Read all frames from an image
 #   @option opts [String] :density Canvas resolution for rendering vector formats like SVG
-#   @option opts [Integer] :page Load this page from the file
-#   @option opts [Integer] :n Load this many pages
+#   @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 [Boolean] :sequential Sequential read only
-#   @option opts [Boolean] :fail Fail on first error
-#   @option opts [Boolean] :disc Open to disc
+#   @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
@@ -1621,8 +1574,9 @@ module Vips
 #   Save image to csv.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [String] :separator Separator characters
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -1631,8 +1585,9 @@ module Vips
 #   Save image to csv.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [String] :separator Separator characters
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -1641,7 +1596,8 @@ module Vips
 #   Save image to matrix.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1650,7 +1606,8 @@ module Vips
 #   Save image to matrix.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1658,7 +1615,8 @@ module Vips
 # @!method matrixprint(**opts)
 #   Print matrix.
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1667,7 +1625,8 @@ module Vips
 #   Save image to raw file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1676,7 +1635,8 @@ module Vips
 #   Write raw image to file descriptor.
 #   @param fd [Integer] File descriptor to write to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1685,7 +1645,8 @@ module Vips
 #   Save image to file in vips format.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1694,7 +1655,8 @@ module Vips
 #   Save image to target in vips format.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1703,10 +1665,11 @@ module Vips
 #   Save image to ppm file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :ascii save as ascii
-#   @option opts [Boolean] :squash save as one bit
-#   @option opts [Integer] :bitdepth set to 1 to write as a 1 bit image
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Vips::ForeignPpmFormat] :format Format to save in
+#   @option opts [Boolean] :ascii Save as ascii
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :bitdepth Set to 1 to write as a 1 bit image
+#   @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
 #   @return [nil]
@@ -1715,10 +1678,11 @@ module Vips
 #   Save to ppm.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :ascii save as ascii
-#   @option opts [Boolean] :squash save as one bit
-#   @option opts [Integer] :bitdepth set to 1 to write as a 1 bit image
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Vips::ForeignPpmFormat] :format Format to save in
+#   @option opts [Boolean] :ascii Save as ascii
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :bitdepth Set to 1 to write as a 1 bit image
+#   @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
 #   @return [nil]
@@ -1727,7 +1691,8 @@ module Vips
 #   Save image to radiance file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1735,7 +1700,8 @@ module Vips
 # @!method radsave_buffer(**opts)
 #   Save image to radiance buffer.
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -1744,48 +1710,8 @@ module Vips
 #   Save image to radiance target.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
-#   @option opts [Array<Double>] :background Background value
-#   @option opts [Integer] :page_height Set page height for multipage save
-#   @return [nil]
-# @!method jxlsave(filename, **opts)
-#   Save image in jpeg-xl format.
-#   @param filename [String] Filename to load from
-#   @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 [Boolean] :strip Strip all metadata from image
-#   @option opts [Array<Double>] :background Background value
-#   @option opts [Integer] :page_height Set page height for multipage save
-#   @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 [Boolean] :strip Strip all metadata from image
-#   @option opts [Array<Double>] :background Background value
-#   @option opts [Integer] :page_height Set page height for multipage save
-#   @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 [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -1795,11 +1721,12 @@ module Vips
 #   @param filename [String] Filename to load from
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Integer] :tile_height Tile height in pixels
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -1808,11 +1735,12 @@ module Vips
 #   Save image in jpeg2000 format.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Integer] :tile_height Tile height in pixels
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -1822,11 +1750,62 @@ module Vips
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Integer] :tile_height Tile height in pixels
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
+#   @return [nil]
+# @!method gifsave(filename, **opts)
+#   Save as gif.
+#   @param filename [String] Filename to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Float] :dither Amount of dithering
+#   @option opts [Integer] :effort Quantisation effort
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
+#   @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 [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
+#   @return [nil]
+# @!method gifsave_buffer(**opts)
+#   Save as gif.
+#   @param opts [Hash] Set of options
+#   @option opts [Float] :dither Amount of dithering
+#   @option opts [Integer] :effort Quantisation effort
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
+#   @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 [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
+#   @return [VipsBlob] Buffer to save to
+# @!method gifsave_target(target, **opts)
+#   Save as gif.
+#   @param target [Vips::Target] Target to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Float] :dither Amount of dithering
+#   @option opts [Integer] :effort Quantisation effort
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [Float] :interframe_maxerror Maximum inter-frame error for transparency
+#   @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 [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
 #   @return [nil]
@@ -1835,25 +1814,22 @@ module Vips
 #   Save image to deepzoom file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [String] :dirname Directory name to save to
-#   @option opts [String] :basename Base name to save to
+#   @option opts [String] :imagename Image name
 #   @option opts [Vips::ForeignDzLayout] :layout Directory layout
 #   @option opts [String] :suffix Filename suffix for tiles
 #   @option opts [Integer] :overlap Tile overlap in pixels
 #   @option opts [Integer] :tile_size Tile size in pixels
-#   @option opts [Integer] :tile_height Tile height in pixels
-#   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :centre Center image in tile
 #   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
 #   @option opts [Vips::Angle] :angle Rotate image during save
 #   @option opts [Vips::ForeignDzContainer] :container Pyramid container type
-#   @option opts [Boolean] :properties Write a properties file to the output directory
 #   @option opts [Integer] :compression ZIP deflate compression level
 #   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
 #   @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
-#   @option opts [Boolean] :no_strip Don't strip tile metadata
 #   @option opts [String] :id Resource ID
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -1861,43 +1837,64 @@ module Vips
 # @!method dzsave_buffer(**opts)
 #   Save image to dz buffer.
 #   @param opts [Hash] Set of options
-#   @option opts [String] :dirname Directory name to save to
-#   @option opts [String] :basename Base name to save to
+#   @option opts [String] :imagename Image name
 #   @option opts [Vips::ForeignDzLayout] :layout Directory layout
 #   @option opts [String] :suffix Filename suffix for tiles
 #   @option opts [Integer] :overlap Tile overlap in pixels
 #   @option opts [Integer] :tile_size Tile size in pixels
-#   @option opts [Integer] :tile_height Tile height in pixels
-#   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :centre Center image in tile
 #   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
 #   @option opts [Vips::Angle] :angle Rotate image during save
 #   @option opts [Vips::ForeignDzContainer] :container Pyramid container type
-#   @option opts [Boolean] :properties Write a properties file to the output directory
 #   @option opts [Integer] :compression ZIP deflate compression level
 #   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
 #   @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
-#   @option opts [Boolean] :no_strip Don't strip tile metadata
 #   @option opts [String] :id Resource ID
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [VipsBlob] Buffer to save to
+# @!method dzsave_target(target, **opts)
+#   Save image to deepzoom target.
+#   @param target [Vips::Target] Target to save to
+#   @param opts [Hash] Set of options
+#   @option opts [String] :imagename Image name
+#   @option opts [Vips::ForeignDzLayout] :layout Directory layout
+#   @option opts [String] :suffix Filename suffix for tiles
+#   @option opts [Integer] :overlap Tile overlap in pixels
+#   @option opts [Integer] :tile_size Tile size in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Boolean] :centre Center image in tile
+#   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
+#   @option opts [Vips::Angle] :angle Rotate image during save
+#   @option opts [Vips::ForeignDzContainer] :container Pyramid container type
+#   @option opts [Integer] :compression ZIP deflate compression level
+#   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
+#   @option opts [Integer] :skip_blanks Skip tiles which are nearly equal to the background
+#   @option opts [String] :id Resource ID
+#   @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
+#   @return [nil]
 # @!method pngsave(filename, **opts)
 #   Save image to png file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
-#   @option opts [Integer] :colours Max number of palette colours
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
-#   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
+#   @option opts [Integer] :effort Quantisation CPU effort
+#   @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
 #   @return [nil]
@@ -1907,14 +1904,14 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
-#   @option opts [Integer] :colours Max number of palette colours
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
-#   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
+#   @option opts [Integer] :effort Quantisation CPU effort
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -1925,14 +1922,14 @@ module Vips
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :compression Compression factor
 #   @option opts [Boolean] :interlace Interlace image
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Vips::ForeignPngFilter] :filter libpng row filter flag(s)
 #   @option opts [Boolean] :palette Quantise to 8bpp palette
-#   @option opts [Integer] :colours Max number of palette colours
 #   @option opts [Integer] :Q Quantisation quality
 #   @option opts [Float] :dither Amount of dithering
-#   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :bitdepth Write as a 1, 2, 4, 8 or 16 bit image
+#   @option opts [Integer] :effort Quantisation CPU effort
+#   @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
 #   @return [nil]
@@ -1942,16 +1939,16 @@ module Vips
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
-#   @option opts [Boolean] :no_subsample Disable chroma subsample
 #   @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
 #   @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
 #   @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
 #   @option opts [Integer] :quant_table Use predefined quantization table with given index
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
+#   @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
 #   @return [nil]
@@ -1960,16 +1957,16 @@ module Vips
 #   Save image to jpeg buffer.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
-#   @option opts [Boolean] :no_subsample Disable chroma subsample
 #   @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
 #   @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
 #   @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
 #   @option opts [Integer] :quant_table Use predefined quantization table with given index
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -1979,16 +1976,16 @@ module Vips
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
-#   @option opts [Boolean] :no_subsample Disable chroma subsample
 #   @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
 #   @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
 #   @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
 #   @option opts [Integer] :quant_table Use predefined quantization table with given index
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
+#   @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
 #   @return [nil]
@@ -1997,75 +1994,98 @@ module Vips
 #   Save image to jpeg mime.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [String] :profile ICC profile to embed
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :optimize_coding Compute optimal Huffman coding tables
 #   @option opts [Boolean] :interlace Generate an interlaced (progressive) jpeg
-#   @option opts [Boolean] :no_subsample Disable chroma subsample
 #   @option opts [Boolean] :trellis_quant Apply trellis quantisation to each 8x8 block
 #   @option opts [Boolean] :overshoot_deringing Apply overshooting to samples with extreme values
 #   @option opts [Boolean] :optimize_scans Split spectrum of DCT coefficients into separate scans
 #   @option opts [Integer] :quant_table Use predefined quantization table with given index
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :restart_interval Add restart markers every specified number of mcu
+#   @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
 #   @return [nil]
 # @!method webpsave(filename, **opts)
-#   Save image to webp file.
+#   Save as webp.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [Boolean] :lossless enable lossless compression
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @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)
 #   @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
-#   @option opts [Boolean] :min_size Optimise for minium size
+#   @option opts [Boolean] :min_size Optimise for minimum size
 #   @option opts [Integer] :kmin Minimum number of frames between key frames
 #   @option opts [Integer] :kmax Maximum number of frames between key frames
-#   @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
-#   @option opts [String] :profile ICC profile to embed
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :effort Level of CPU effort to reduce file size
+#   @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
+#   @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
 #   @return [nil]
 # @!method webpsave_buffer(**opts)
-#   Save image to webp buffer.
+#   Save as webp.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [Boolean] :lossless enable lossless compression
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @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)
 #   @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
-#   @option opts [Boolean] :min_size Optimise for minium size
+#   @option opts [Boolean] :min_size Optimise for minimum size
 #   @option opts [Integer] :kmin Minimum number of frames between key frames
 #   @option opts [Integer] :kmax Maximum number of frames between key frames
-#   @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
-#   @option opts [String] :profile ICC profile to embed
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :effort Level of CPU effort to reduce file size
+#   @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
+#   @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
 #   @return [VipsBlob] Buffer to save to
 # @!method webpsave_target(target, **opts)
-#   Save image to webp target.
+#   Save as webp.
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
-#   @option opts [Boolean] :lossless enable lossless compression
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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)
+#   @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
+#   @option opts [Boolean] :min_size Optimise for minimum size
+#   @option opts [Integer] :kmin Minimum number of frames between key frames
+#   @option opts [Integer] :kmax Maximum number of frames between key frames
+#   @option opts [Integer] :effort Level of CPU effort to reduce file size
+#   @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
+#   @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
+#   @return [nil]
+# @!method webpsave_mime(**opts)
+#   Save image to webp mime.
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :Q Q factor
+#   @option opts [Boolean] :lossless Enable lossless compression
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @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)
 #   @option opts [Integer] :alpha_q Change alpha plane fidelity for lossy compression
-#   @option opts [Boolean] :min_size Optimise for minium size
+#   @option opts [Boolean] :min_size Optimise for minimum size
 #   @option opts [Integer] :kmin Minimum number of frames between key frames
 #   @option opts [Integer] :kmax Maximum number of frames between key frames
-#   @option opts [Integer] :reduction_effort Level of CPU effort to reduce file size
-#   @option opts [String] :profile ICC profile to embed
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :effort Level of CPU effort to reduce file size
+#   @option opts [Boolean] :mixed Allow mixed encoding (might reduce file size)
+#   @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
 #   @return [nil]
@@ -2077,19 +2097,17 @@ module Vips
 #   @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
-#   @option opts [String] :profile ICC profile to embed
 #   @option opts [Boolean] :tile Write a tiled tiff
 #   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Integer] :tile_height Tile height in pixels
 #   @option opts [Boolean] :pyramid Write a pyramidal tiff
-#   @option opts [Boolean] :squash Squash images down to 1 bit
 #   @option opts [Boolean] :miniswhite Use 0 for white in 1-bit images
 #   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
 #   @option opts [Vips::ForeignTiffResunit] :resunit Resolution unit
 #   @option opts [Float] :xres Horizontal resolution in pixels/mm
 #   @option opts [Float] :yres Vertical resolution in pixels/mm
 #   @option opts [Boolean] :bigtiff Write a bigtiff image
-#   @option opts [Boolean] :rgbjpeg Output RGB JPEG rather than YCbCr
 #   @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
 #   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
 #   @option opts [Integer] :level ZSTD compression level
@@ -2097,7 +2115,7 @@ module Vips
 #   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
 #   @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
 #   @option opts [Boolean] :premultiply Save with premultiplied alpha
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -2108,19 +2126,17 @@ module Vips
 #   @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
 #   @option opts [Integer] :Q Q factor
 #   @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
-#   @option opts [String] :profile ICC profile to embed
 #   @option opts [Boolean] :tile Write a tiled tiff
 #   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Integer] :tile_height Tile height in pixels
 #   @option opts [Boolean] :pyramid Write a pyramidal tiff
-#   @option opts [Boolean] :squash Squash images down to 1 bit
 #   @option opts [Boolean] :miniswhite Use 0 for white in 1-bit images
 #   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
 #   @option opts [Vips::ForeignTiffResunit] :resunit Resolution unit
 #   @option opts [Float] :xres Horizontal resolution in pixels/mm
 #   @option opts [Float] :yres Vertical resolution in pixels/mm
 #   @option opts [Boolean] :bigtiff Write a bigtiff image
-#   @option opts [Boolean] :rgbjpeg Output RGB JPEG rather than YCbCr
 #   @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
 #   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
 #   @option opts [Integer] :level ZSTD compression level
@@ -2128,16 +2144,47 @@ module Vips
 #   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
 #   @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
 #   @option opts [Boolean] :premultiply Save with premultiplied alpha
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [VipsBlob] Buffer to save to
+# @!method tiffsave_target(target, **opts)
+#   Save image to tiff target.
+#   @param target [Vips::Target] Target to save to
+#   @param opts [Hash] Set of options
+#   @option opts [Vips::ForeignTiffCompression] :compression Compression for this file
+#   @option opts [Integer] :Q Q factor
+#   @option opts [Vips::ForeignTiffPredictor] :predictor Compression prediction
+#   @option opts [Boolean] :tile Write a tiled tiff
+#   @option opts [Integer] :tile_width Tile width in pixels
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @option opts [Integer] :tile_height Tile height in pixels
+#   @option opts [Boolean] :pyramid Write a pyramidal tiff
+#   @option opts [Boolean] :miniswhite Use 0 for white in 1-bit images
+#   @option opts [Integer] :bitdepth Write as a 1, 2, 4 or 8 bit image
+#   @option opts [Vips::ForeignTiffResunit] :resunit Resolution unit
+#   @option opts [Float] :xres Horizontal resolution in pixels/mm
+#   @option opts [Float] :yres Vertical resolution in pixels/mm
+#   @option opts [Boolean] :bigtiff Write a bigtiff image
+#   @option opts [Boolean] :properties Write a properties document to IMAGEDESCRIPTION
+#   @option opts [Vips::RegionShrink] :region_shrink Method to shrink regions
+#   @option opts [Integer] :level ZSTD compression level
+#   @option opts [Boolean] :lossless Enable WEBP lossless mode
+#   @option opts [Vips::ForeignDzDepth] :depth Pyramid depth
+#   @option opts [Boolean] :subifd Save pyr layers as sub-IFDs
+#   @option opts [Boolean] :premultiply Save with premultiplied alpha
+#   @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
+#   @return [nil]
 # @!method fitssave(filename, **opts)
 #   Save image to fits file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -2146,7 +2193,8 @@ module Vips
 #   Save image to nifti file.
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -2156,11 +2204,14 @@ module Vips
 #   @param filename [String] Filename to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Vips::ForeignHeifCompression] :compression Compression format
-#   @option opts [Integer] :speed CPU effort
+#   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [nil]
@@ -2169,11 +2220,14 @@ module Vips
 #   Save image in heif format.
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Vips::ForeignHeifCompression] :compression Compression format
-#   @option opts [Integer] :speed CPU effort
+#   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -2183,11 +2237,58 @@ module Vips
 #   @param target [Vips::Target] Target to save to
 #   @param opts [Hash] Set of options
 #   @option opts [Integer] :Q Q factor
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [String] :profile Filename of ICC profile to embed
 #   @option opts [Boolean] :lossless Enable lossless compression
 #   @option opts [Vips::ForeignHeifCompression] :compression Compression format
-#   @option opts [Integer] :speed CPU effort
+#   @option opts [Integer] :effort CPU effort
 #   @option opts [Vips::ForeignSubsample] :subsample_mode Select chroma subsample operation mode
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @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
+#   @return [nil]
+# @!method jxlsave(filename, **opts)
+#   Save image in jpeg-xl format.
+#   @param filename [String] Filename to load from
+#   @param opts [Hash] Set of options
+#   @option opts [Integer] :tier Decode speed tier
+#   @option opts [Float] :distance Target butteraugli distance
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
+#   @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 [String] :profile Filename of ICC profile to embed
+#   @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
+#   @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 [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -2200,7 +2301,9 @@ module Vips
 #   @option opts [Integer] :quality Quality to use
 #   @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
 #   @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [nil]
@@ -2212,7 +2315,9 @@ module Vips
 #   @option opts [Integer] :quality Quality to use
 #   @option opts [Boolean] :optimize_gif_frames Apply GIF frames optimization
 #   @option opts [Boolean] :optimize_gif_transparency Apply GIF transparency optimization
-#   @option opts [Boolean] :strip Strip all metadata from image
+#   @option opts [Integer] :bitdepth Number of bits per pixel
+#   @option opts [String] :profile Filename of ICC profile to embed
+#   @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
 #   @return [VipsBlob] Buffer to save to
@@ -2230,7 +2335,7 @@ module Vips
 #   @option opts [String] :import_profile Fallback import profile
 #   @option opts [String] :export_profile Fallback export profile
 #   @option opts [Vips::Intent] :intent Rendering intent
-#   @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
+#   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
 # @!method self.thumbnail_buffer(buffer, width, **opts)
@@ -2247,7 +2352,7 @@ module Vips
 #   @option opts [String] :import_profile Fallback import profile
 #   @option opts [String] :export_profile Fallback export profile
 #   @option opts [Vips::Intent] :intent Rendering intent
-#   @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
+#   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
 # @!method thumbnail_image(width, **opts)
@@ -2262,7 +2367,7 @@ module Vips
 #   @option opts [String] :import_profile Fallback import profile
 #   @option opts [String] :export_profile Fallback export profile
 #   @option opts [Vips::Intent] :intent Rendering intent
-#   @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
+#   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
 # @!method self.thumbnail_source(source, width, **opts)
@@ -2279,7 +2384,7 @@ module Vips
 #   @option opts [String] :import_profile Fallback import profile
 #   @option opts [String] :export_profile Fallback export profile
 #   @option opts [Vips::Intent] :intent Rendering intent
-#   @option opts [Boolean] :auto_rotate Use orientation tags to rotate image upright
+#   @option opts [Vips::FailOn] :fail_on Error level to fail on
 #   @return [Vips::Image] Output image
 # @!method mapim(index, **opts)
@@ -2287,6 +2392,9 @@ module Vips
 #   @param index [Vips::Image] Index pixels with this
 #   @param opts [Hash] Set of options
 #   @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
+#   @option opts [Array<Double>] :background Background value
+#   @option opts [Boolean] :premultiplied Images have premultiplied alpha
+#   @option opts [Vips::Extend] :extend How to generate the extra pixels
 #   @return [Vips::Image] Output image
 # @!method shrink(hshrink, vshrink, **opts)
@@ -2294,40 +2402,37 @@ module Vips
 #   @param hshrink [Float] Horizontal shrink factor
 #   @param vshrink [Float] Vertical shrink factor
 #   @param opts [Hash] Set of options
-#   @option opts [Float] :xshrink Horizontal shrink factor
-#   @option opts [Float] :yshrink Vertical shrink factor
+#   @option opts [Boolean] :ceil Round-up output dimensions
 #   @return [Vips::Image] Output image
 # @!method shrinkh(hshrink, **opts)
 #   Shrink an image horizontally.
 #   @param hshrink [Integer] Horizontal shrink factor
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :xshrink Horizontal shrink factor
+#   @option opts [Boolean] :ceil Round-up output dimensions
 #   @return [Vips::Image] Output image
 # @!method shrinkv(vshrink, **opts)
 #   Shrink an image vertically.
 #   @param vshrink [Integer] Vertical shrink factor
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :yshrink Vertical shrink factor
+#   @option opts [Boolean] :ceil Round-up output dimensions
 #   @return [Vips::Image] Output image
 # @!method reduceh(hshrink, **opts)
 #   Shrink an image horizontally.
 #   @param hshrink [Float] Horizontal shrink factor
 #   @param opts [Hash] Set of options
-#   @option opts [Float] :xshrink Horizontal shrink factor
 #   @option opts [Vips::Kernel] :kernel Resampling kernel
-#   @option opts [Boolean] :centre Use centre sampling convention
+#   @option opts [Float] :gap Reducing gap
 #   @return [Vips::Image] Output image
 # @!method reducev(vshrink, **opts)
 #   Shrink an image vertically.
 #   @param vshrink [Float] Vertical shrink factor
 #   @param opts [Hash] Set of options
-#   @option opts [Float] :yshrink Vertical shrink factor
 #   @option opts [Vips::Kernel] :kernel Resampling kernel
-#   @option opts [Boolean] :centre Use centre sampling convention
+#   @option opts [Float] :gap Reducing gap
 #   @return [Vips::Image] Output image
 # @!method reduce(hshrink, vshrink, **opts)
@@ -2336,9 +2441,7 @@ module Vips
 #   @param vshrink [Float] Vertical shrink factor
 #   @param opts [Hash] Set of options
 #   @option opts [Vips::Kernel] :kernel Resampling kernel
-#   @option opts [Boolean] :centre Use centre sampling convention
-#   @option opts [Float] :xshrink Horizontal shrink factor
-#   @option opts [Float] :yshrink Vertical shrink factor
+#   @option opts [Float] :gap Reducing gap
 #   @return [Vips::Image] Output image
 # @!method quadratic(coeff, **opts)
@@ -2392,12 +2495,9 @@ module Vips
 #   Resize an image.
 #   @param scale [Float] Scale image by this factor
 #   @param opts [Hash] Set of options
-#   @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
 #   @option opts [Vips::Kernel] :kernel Resampling kernel
-#   @option opts [Boolean] :centre Use centre sampling convention
+#   @option opts [Float] :gap Reducing gap
 #   @option opts [Float] :vscale Vertical scale image by this factor
-#   @option opts [Float] :idx Horizontal input displacement
-#   @option opts [Float] :idy Vertical input displacement
 #   @return [Vips::Image] Output image
 # @!method colourspace(space, **opts)
@@ -2449,16 +2549,6 @@ 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
@@ -2569,12 +2659,22 @@ 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 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
@@ -2601,7 +2701,7 @@ module Vips
 #   Map an image though a lut.
 #   @param lut [Vips::Image] Look-up table image
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :band apply one-band lut to this band of in
+#   @option opts [Integer] :band Apply one-band lut to this band of in
 #   @return [Vips::Image] Output image
 # @!method case(cases, **opts)
@@ -2714,7 +2814,7 @@ module Vips
 #   @return [Vips::Image] Output image
 # @!method convsep(mask, **opts)
-#   Seperable convolution operation.
+#   Separable convolution operation.
 #   @param mask [Vips::Image] Input matrix image
 #   @param opts [Hash] Set of options
 #   @option opts [Vips::Precision] :precision Convolve with this precision
@@ -2744,7 +2844,6 @@ module Vips
 # @!method sharpen(**opts)
 #   Unsharp masking for print.
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :radius radius of Gaussian
 #   @option opts [Float] :sigma Sigma of Gaussian
 #   @option opts [Float] :x1 Flat/jaggy threshold
 #   @option opts [Float] :y2 Maximum brightening
@@ -2761,6 +2860,21 @@ module Vips
 #   @option opts [Vips::Precision] :precision Convolve with this precision
 #   @return [Vips::Image] Output image
+# @!method sobel(**opts)
+#   Sobel edge detector.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+# @!method scharr(**opts)
+#   Scharr edge detector.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
+# @!method prewitt(**opts)
+#   Prewitt edge detector.
+#   @param opts [Hash] Set of options
+#   @return [Vips::Image] Output image
 # @!method canny(**opts)
 #   Canny edge detector.
 #   @param opts [Hash] Set of options
@@ -2768,11 +2882,6 @@ module Vips
 #   @option opts [Vips::Precision] :precision Convolve with this precision
 #   @return [Vips::Image] Output image
-# @!method sobel(**opts)
-#   Sobel edge detector.
-#   @param opts [Hash] Set of options
-#   @return [Vips::Image] Output image
 # @!method fwfft(**opts)
 #   Forward fft.
 #   @param opts [Hash] Set of options
@@ -2825,7 +2934,7 @@ module Vips
 # @!method labelregions(**opts)
 #   Label regions in an image.
 #   @param opts [Hash] Set of options
-#   @option opts [Integer] :segments Output Number of discrete contigious regions
+#   @option opts [Integer] :segments Output Number of discrete contiguous regions
 #   @return [Vips::Image, Hash<Symbol => Object>] Mask of region labels, Hash of optional output items
 # @!method fill_nearest(**opts)
@@ -2883,9 +2992,9 @@ module Vips
 #   @option opts [Vips::Image] :test Test pixels in this image
 #   @option opts [Boolean] :equal DrawFlood while equal to edge
 #   @option opts [Integer] :left Output Left edge of modified area
-#   @option opts [Integer] :top Output top edge of modified area
-#   @option opts [Integer] :width Output width of modified area
-#   @option opts [Integer] :height Output height of modified area
+#   @option opts [Integer] :top Output Top edge of modified area
+#   @option opts [Integer] :width Output Width of modified area
+#   @option opts [Integer] :height Output Height of modified area
 #   @return [Vips::Image, Hash<Symbol => Object>] Image to draw on, Hash of optional output items
 # @!method draw_image(sub, x, y, **opts)
@@ -2955,7 +3064,6 @@ module Vips
 #   @option opts [Boolean] :search Search to improve tie-points
 #   @option opts [Vips::Interpolate] :interpolate Interpolate pixels with this
 #   @option opts [Integer] :mblend Maximum blend size
-#   @option opts [Integer] :bandno Band to search for features on
 #   @return [Vips::Image] Output image
 # @!method matrixinvert(**opts)