@img/sharp-libvips-dev 1.2.4-rc.0 → 1.3.0-rc.0

package/include/vips/VError8.h

@@ -32,7 +32,7 @@
 
 #include <cstring>
 #include <ostream>
-#include <exception>
+#include <stdexcept>
 
 #include <vips/vips.h>
 
@@ -42,36 +42,39 @@ VIPS_NAMESPACE_START
  * The libvips error class. It holds a single string containing an
  * internationalized error message in utf-8 encoding.
  */
-class VIPS_CPLUSPLUS_API VError : public std::exception {
-	std::string _what;
-
+class VIPS_CPLUSPLUS_API VError : public std::runtime_error {
 public:
-	/**
-	 * Construct a VError, setting the error message.
-	 */
-	VError(const std::string &what) : _what(what) {}
+	using std::runtime_error::runtime_error;
 
 	/**
 	 * Construct a VError, fetching the error message from the libvips
 	 * error buffer.
 	 */
-	VError() : _what(vips_error_buffer()) {}
-
-	virtual ~VError() throw() {}
+	VError() : std::runtime_error(vips_error_buffer()) {}
 
 	/**
 	 * Get a reference to the underlying C string.
+	 * Note: this override must be preserved for ABI, removing it
+	 * would also eliminate the `_ZNK4vips6VError4whatEv` symbol.
 	 */
-	virtual const char *
-	what() const throw()
+	const char *
+	what() const noexcept override
 	{
-		return _what.c_str();
+		return std::runtime_error::what();
 	}
 
 	/**
 	 * Print the error message to a stream.
 	 */
 	void ostream_print(std::ostream &) const;
+
+private:
+	/**
+	 * ABI padding to preserve original VError size.
+	 */
+	// TODO: Migrate to [[maybe_unused]] once we require C++17.
+	char _abi_padding[sizeof(std::exception) + sizeof(std::string) -
+		sizeof(std::runtime_error)] G_GNUC_UNUSED = {};
 };
 
 VIPS_NAMESPACE_END

package/include/vips/VImage8.h

@@ -548,6 +548,15 @@ public:
 		return vips_image_get_filename(get_image());
 	}
 
+	/**
+	 * The associated gainmap image, if any.
+	 */
+	VImage
+	gainmap() const
+	{
+		return VImage(vips_image_get_gainmap(get_image()));
+	}
+
 	/**
 	 * Gets an VImage ready for an in-place operation, such as draw_circle().
 	 * After calling this function you can both read and write the image with
@@ -556,10 +565,10 @@ public:
 	 * This method is called for you by the draw operations,
 	 * there's no need to call it yourself.
 	 *
-	 * Since this function modifies the image, it is not thread-safe. Only call it on
-	 * images which you are sure have not been shared with another thread.
-	 * All in-place operations are inherently not thread-safe, so you need to take
-	 * great care in any case.
+	 * Since this function modifies the image, it is not thread-safe. Only
+	 * call it on images which you are sure have not been shared with another
+	 * thread.  All in-place operations are inherently not thread-safe, so
+	 * you need to take great care in any case.
 	 */
 	void
 	inplace()
@@ -670,6 +679,15 @@ public:
 			free_fn, data, length);
 	}
 
+	/**
+	 * Set the value of an image metadata item on an image.
+	 */
+	void
+	set(const char *field, const VImage value)
+	{
+		vips_image_set_image(this->get_image(), field, value.get_image());
+	}
+
 	/**
 	 * Return the GType of a metadata item, or 0 if the named item does not
 	 * exist.
@@ -2066,7 +2084,7 @@ public:
 	 * @param fd File descriptor to write to.
 	 * @param options Set of options.
 	 */
-	G_DEPRECATED_FOR(rawsave_target)
+	[[deprecated("Use 'rawsave_target' instead")]]
 	void rawsave_fd(int fd, VOption *options = nullptr) const;
 
 	/* Automatically generated members.
@@ -2186,6 +2204,27 @@ public:
 	 */
 	VImage LabS2LabQ(VOption *options = nullptr) const;
 
+	/**
+	 * Transform oklab to oklch.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage Oklab2Oklch(VOption *options = nullptr) const;
+
+	/**
+	 * Transform oklab to xyz.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage Oklab2XYZ(VOption *options = nullptr) const;
+
+	/**
+	 * Transform oklch to oklab.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage Oklch2Oklab(VOption *options = nullptr) const;
+
 	/**
 	 * Transform xyz to cmyk.
 	 * @param options Set of options.
@@ -2204,6 +2243,13 @@ public:
 	 */
 	VImage XYZ2Lab(VOption *options = nullptr) const;
 
+	/**
+	 * Transform xyz to oklab.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage XYZ2Oklab(VOption *options = nullptr) const;
+
 	/**
 	 * Transform xyz to yxy.
 	 * @param options Set of options.
@@ -2714,7 +2760,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -2776,6 +2821,53 @@ public:
 	 */
 	VImage dECMC(VImage right, VOption *options = nullptr) const;
 
+	/**
+	 * Load raw camera files.
+	 *
+	 * **Optional parameters**
+	 *   - **bitdepth** -- Number of bits per pixel, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
+	 *
+	 * @param filename Filename to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage dcrawload(const char *filename, VOption *options = nullptr);
+
+	/**
+	 * Load raw camera files.
+	 *
+	 * **Optional parameters**
+	 *   - **bitdepth** -- Number of bits per pixel, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
+	 *
+	 * @param buffer Buffer to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage dcrawload_buffer(VipsBlob *buffer, VOption *options = nullptr);
+
+	/**
+	 * Load raw camera files.
+	 *
+	 * **Optional parameters**
+	 *   - **bitdepth** -- Number of bits per pixel, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *
+	 * @param source Source to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage dcrawload_source(VSource source, VOption *options = nullptr);
+
 	/**
 	 * Find image standard deviation.
 	 * @param options Set of options.
@@ -3075,7 +3167,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -3258,7 +3349,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -3431,7 +3521,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -3450,6 +3539,7 @@ public:
 	 *   - **effort** -- CPU effort, int.
 	 *   - **subsample_mode** -- Select chroma subsample operation mode, VipsForeignSubsample.
 	 *   - **encoder** -- Select encoder to use, VipsForeignHeifEncoder.
+	 *   - **tune** -- Tuning parameters, const char *.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -3471,6 +3561,7 @@ public:
 	 *   - **effort** -- CPU effort, int.
 	 *   - **subsample_mode** -- Select chroma subsample operation mode, VipsForeignSubsample.
 	 *   - **encoder** -- Select encoder to use, VipsForeignHeifEncoder.
+	 *   - **tune** -- Tuning parameters, const char *.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -3492,6 +3583,7 @@ public:
 	 *   - **effort** -- CPU effort, int.
 	 *   - **subsample_mode** -- Select chroma subsample operation mode, VipsForeignSubsample.
 	 *   - **encoder** -- Select encoder to use, VipsForeignHeifEncoder.
+	 *   - **tune** -- Tuning parameters, const char *.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -3804,7 +3896,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -3915,7 +4006,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -3924,7 +4014,7 @@ public:
 	static VImage jpegload_source(VSource source, VOption *options = nullptr);
 
 	/**
-	 * Save image to jpeg file.
+	 * Save as jpeg.
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
@@ -3947,7 +4037,7 @@ public:
 	void jpegsave(const char *filename, VOption *options = nullptr) const;
 
 	/**
-	 * Save image to jpeg buffer.
+	 * Save as jpeg.
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
@@ -3992,7 +4082,7 @@ public:
 	void jpegsave_mime(VOption *options = nullptr) const;
 
 	/**
-	 * Save image to jpeg target.
+	 * Save as jpeg.
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
@@ -4057,7 +4147,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4074,6 +4163,7 @@ public:
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality factor, int.
+	 *   - **bitdepth** -- Bit depth, int.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -4093,6 +4183,7 @@ public:
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality factor, int.
+	 *   - **bitdepth** -- Bit depth, int.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -4112,6 +4203,7 @@ public:
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality factor, int.
+	 *   - **bitdepth** -- Bit depth, int.
 	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **page_height** -- Set page height for multipage save, int.
@@ -4180,7 +4272,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param filename Filename to load from.
 	 * @param options Set of options.
@@ -4198,7 +4289,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param buffer Buffer to load from.
 	 * @param options Set of options.
@@ -4206,6 +4296,23 @@ public:
 	 */
 	static VImage magickload_buffer(VipsBlob *buffer, VOption *options = nullptr);
 
+	/**
+	 * Load source with imagemagick.
+	 *
+	 * **Optional parameters**
+	 *   - **density** -- Canvas resolution for rendering vector formats like SVG, const char *.
+	 *   - **page** -- First page to load, int.
+	 *   - **n** -- Number of pages to load, -1 for all, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *
+	 * @param source Source to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage magickload_source(VSource source, VOption *options = nullptr);
+
 	/**
 	 * Save file with imagemagick.
 	 *
@@ -4552,7 +4659,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4773,7 +4879,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4842,7 +4947,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4860,6 +4964,7 @@ public:
 	 *   - **scale** -- Factor to scale by, double.
 	 *   - **background** -- Background colour, std::vector<double>.
 	 *   - **password** -- Password to decrypt with, const char *.
+	 *   - **page_box** -- The region of the page to render, VipsForeignPdfPageBox.
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
@@ -4881,6 +4986,7 @@ public:
 	 *   - **scale** -- Factor to scale by, double.
 	 *   - **background** -- Background colour, std::vector<double>.
 	 *   - **password** -- Password to decrypt with, const char *.
+	 *   - **page_box** -- The region of the page to render, VipsForeignPdfPageBox.
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
@@ -4902,10 +5008,10 @@ public:
 	 *   - **scale** -- Factor to scale by, double.
 	 *   - **background** -- Background colour, std::vector<double>.
 	 *   - **password** -- Password to decrypt with, const char *.
+	 *   - **page_box** -- The region of the page to render, VipsForeignPdfPageBox.
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4984,7 +5090,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -4998,7 +5103,7 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
+	 *   - **filter** -- libpng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
 	 *   - **dither** -- Amount of dithering, double.
@@ -5020,7 +5125,7 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
+	 *   - **filter** -- libpng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
 	 *   - **dither** -- Amount of dithering, double.
@@ -5042,7 +5147,7 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
+	 *   - **filter** -- libpng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
 	 *   - **dither** -- Amount of dithering, double.
@@ -5095,7 +5200,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -5235,7 +5339,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -5839,7 +5942,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -5860,8 +5962,9 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **in** -- Array of input images, std::vector<VImage>.
-	 *   - **out_format** -- Format for output filename, const char *.
 	 *   - **in_format** -- Format for input filename, const char *.
+	 *   - **out_format** -- Format for output filename, const char *.
+	 *   - **cache** -- Cache this call, bool.
 	 *
 	 * @param cmd_format Command to run.
 	 * @param options Set of options.
@@ -6026,7 +6129,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -6183,6 +6285,105 @@ public:
 	 */
 	VImage transpose3d(VOption *options = nullptr) const;
 
+	/**
+	 * Transform uhdr to scrgb.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage uhdr2scRGB(VOption *options = nullptr) const;
+
+	/**
+	 * Load a uhdr image.
+	 *
+	 * **Optional parameters**
+	 *   - **shrink** -- Shrink factor on load, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
+	 *
+	 * @param filename Filename to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage uhdrload(const char *filename, VOption *options = nullptr);
+
+	/**
+	 * Load a uhdr image.
+	 *
+	 * **Optional parameters**
+	 *   - **shrink** -- Shrink factor on load, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
+	 *
+	 * @param buffer Buffer to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage uhdrload_buffer(VipsBlob *buffer, VOption *options = nullptr);
+
+	/**
+	 * Load a uhdr image.
+	 *
+	 * **Optional parameters**
+	 *   - **shrink** -- Shrink factor on load, int.
+	 *   - **memory** -- Force open via memory, bool.
+	 *   - **access** -- Required access pattern for this file, VipsAccess.
+	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
+	 *
+	 * @param source Source to load from.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage uhdrload_source(VSource source, VOption *options = nullptr);
+
+	/**
+	 * Save image in ultrahdr format.
+	 *
+	 * **Optional parameters**
+	 *   - **Q** -- Q factor, int.
+	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
+	 *   - **background** -- Background value, std::vector<double>.
+	 *   - **page_height** -- Set page height for multipage save, int.
+	 *   - **profile** -- Filename of ICC profile to embed, const char *.
+	 *
+	 * @param filename Filename to save to.
+	 * @param options Set of options.
+	 */
+	void uhdrsave(const char *filename, VOption *options = nullptr) const;
+
+	/**
+	 * Save image in ultrahdr format.
+	 *
+	 * **Optional parameters**
+	 *   - **Q** -- Q factor, int.
+	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
+	 *   - **background** -- Background value, std::vector<double>.
+	 *   - **page_height** -- Set page height for multipage save, int.
+	 *   - **profile** -- Filename of ICC profile to embed, const char *.
+	 *
+	 * @param options Set of options.
+	 * @return Buffer to save to.
+	 */
+	VipsBlob *uhdrsave_buffer(VOption *options = nullptr) const;
+
+	/**
+	 * Save image in ultrahdr format.
+	 *
+	 * **Optional parameters**
+	 *   - **Q** -- Q factor, int.
+	 *   - **keep** -- Which metadata to retain, VipsForeignKeep.
+	 *   - **background** -- Background value, std::vector<double>.
+	 *   - **page_height** -- Set page height for multipage save, int.
+	 *   - **profile** -- Filename of ICC profile to embed, const char *.
+	 *
+	 * @param target Target to save to.
+	 * @param options Set of options.
+	 */
+	void uhdrsave_target(VTarget target, VOption *options = nullptr) const;
+
 	/**
 	 * Unpremultiply image alpha.
 	 *
@@ -6217,7 +6418,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -6299,7 +6499,6 @@ public:
 	 *   - **memory** -- Force open via memory, bool.
 	 *   - **access** -- Required access pattern for this file, VipsAccess.
 	 *   - **fail_on** -- Error level to fail on, VipsFailOn.
-	 *   - **revalidate** -- Don't use a cached result for this operation, bool.
 	 *
 	 * @param source Source to load from.
 	 * @param options Set of options.
@@ -6313,6 +6512,7 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
+	 *   - **exact** -- Preserve color values from transparent pixels, bool.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6341,6 +6541,7 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
+	 *   - **exact** -- Preserve color values from transparent pixels, bool.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6369,6 +6570,7 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
+	 *   - **exact** -- Preserve color values from transparent pixels, bool.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6396,6 +6598,7 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
+	 *   - **exact** -- Preserve color values from transparent pixels, bool.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.