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

ruby-vips 2.1.3 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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)