@img/sharp-libvips-dev 1.0.6 → 1.1.0-rc2

package/include/vips/VImage8.h

@@ -919,7 +919,7 @@ public:
 	 * C-style array.
 	 */
 	static VImage
-	new_from_memory(void *data, size_t size,
+	new_from_memory(const void *data, size_t size,
 		int width, int height, int bands, VipsBandFormat format)
 	{
 		VipsImage *image;
@@ -937,7 +937,7 @@ public:
 	 * The VImage makes a copy of @data.
 	 */
 	static VImage
-	new_from_memory_copy(void *data, size_t size,
+	new_from_memory_copy(const void *data, size_t size,
 		int width, int height, int bands, VipsBandFormat format)
 	{
 		VipsImage *image;
@@ -957,7 +957,7 @@ public:
 	 * goes out of scope.
 	 */
 	static VImage
-	new_from_memory_steal(void *data, size_t size,
+	new_from_memory_steal(const void *data, size_t size,
 		int width, int height, int bands, VipsBandFormat format);
 
 	/**
@@ -2048,6 +2048,27 @@ public:
 	friend VIPS_CPLUSPLUS_API VImage &
 	operator>>=(VImage &a, const std::vector<double> b);
 
+	// Compat operations
+
+	static VImage
+	new_from_memory_steal(void *data, size_t size,
+		int width, int height, int bands, VipsBandFormat format);
+
+	/**
+	 * Write raw image to file descriptor.
+	 *
+	 * **Optional parameters**
+	 *   - **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 fd File descriptor to write to.
+	 * @param options Set of options.
+	 */
+	G_DEPRECATED_FOR(rawsave_target)
+	void rawsave_fd(int fd, VOption *options = nullptr) const;
+
 	/* Automatically generated members.
 	 *
 	 * Rebuild with:
@@ -2055,7 +2076,7 @@ public:
 	 * 	meson compile -Cbuild vips-operators-header
 	 *
 	 * Then delete from here to the end of the class and paste in
-	 * vips-operators.h. We could just #include vips-operators.h, but
+	 * vips-operators.h. We could just #include "vips-operators.h", but
 	 * that confuses doxygen.
 	 */
 
@@ -2218,6 +2239,13 @@ public:
 	 */
 	VImage add(VImage right, VOption *options = nullptr) const;
 
+	/**
+	 * Append an alpha channel.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage addalpha(VOption *options = nullptr) const;
+
 	/**
 	 * Affine transform of an image.
 	 *
@@ -2406,6 +2434,7 @@ public:
 	 * @param options Set of options.
 	 * @return Output image.
 	 */
+	G_DEPRECATED
 	VImage cache(VOption *options = nullptr) const;
 
 	/**
@@ -2440,6 +2469,18 @@ public:
 	 */
 	VImage cast(VipsBandFormat format, VOption *options = nullptr) const;
 
+	/**
+	 * Clamp values of an image.
+	 *
+	 * **Optional parameters**
+	 *   - **min** -- Minimum value, double.
+	 *   - **max** -- Maximum value, double.
+	 *
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage clamp(VOption *options = nullptr) const;
+
 	/**
 	 * Convert to a new colorspace.
 	 *
@@ -2684,11 +2725,11 @@ public:
 	 * Save image to csv.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **separator** -- Separator characters, const char *.
 	 *   - **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.
@@ -2699,11 +2740,11 @@ public:
 	 * Save image to csv.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **separator** -- Separator characters, const char *.
 	 *   - **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.
@@ -2845,7 +2886,6 @@ public:
 	 *   - **suffix** -- Filename suffix for tiles, const char *.
 	 *   - **overlap** -- Tile overlap in pixels, int.
 	 *   - **tile_size** -- Tile size in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **centre** -- Center image in tile, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **angle** -- Rotate image during save, VipsAngle.
@@ -2858,6 +2898,7 @@ public:
 	 *   - **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.
@@ -2873,7 +2914,6 @@ public:
 	 *   - **suffix** -- Filename suffix for tiles, const char *.
 	 *   - **overlap** -- Tile overlap in pixels, int.
 	 *   - **tile_size** -- Tile size in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **centre** -- Center image in tile, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **angle** -- Rotate image during save, VipsAngle.
@@ -2886,6 +2926,7 @@ public:
 	 *   - **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.
@@ -2901,7 +2942,6 @@ public:
 	 *   - **suffix** -- Filename suffix for tiles, const char *.
 	 *   - **overlap** -- Tile overlap in pixels, int.
 	 *   - **tile_size** -- Tile size in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **centre** -- Center image in tile, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **angle** -- Rotate image during save, VipsAngle.
@@ -2914,6 +2954,7 @@ public:
 	 *   - **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.
@@ -3045,10 +3086,10 @@ public:
 	 * Save image to fits file.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -3162,6 +3203,10 @@ public:
 
 	/**
 	 * Read a point from an image.
+	 *
+	 * **Optional parameters**
+	 *   - **unpack_complex** -- Complex pixels should be unpacked, bool.
+	 *
 	 * @param x Point to read.
 	 * @param y Point to read.
 	 * @param options Set of options.
@@ -3226,7 +3271,6 @@ public:
 	 * **Optional parameters**
 	 *   - **dither** -- Amount of dithering, double.
 	 *   - **effort** -- Quantisation effort, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
 	 *   - **interframe_maxerror** -- Maximum inter-frame error for transparency, double.
 	 *   - **reuse** -- Reuse palette from input, bool.
@@ -3235,6 +3279,7 @@ public:
 	 *   - **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.
@@ -3247,7 +3292,6 @@ public:
 	 * **Optional parameters**
 	 *   - **dither** -- Amount of dithering, double.
 	 *   - **effort** -- Quantisation effort, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
 	 *   - **interframe_maxerror** -- Maximum inter-frame error for transparency, double.
 	 *   - **reuse** -- Reuse palette from input, bool.
@@ -3256,6 +3300,7 @@ public:
 	 *   - **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.
@@ -3268,7 +3313,6 @@ public:
 	 * **Optional parameters**
 	 *   - **dither** -- Amount of dithering, double.
 	 *   - **effort** -- Quantisation effort, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
 	 *   - **interframe_maxerror** -- Maximum inter-frame error for transparency, double.
 	 *   - **reuse** -- Reuse palette from input, bool.
@@ -3277,6 +3321,7 @@ public:
 	 *   - **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.
@@ -3396,7 +3441,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **compression** -- Compression format, VipsForeignHeifCompression.
 	 *   - **effort** -- CPU effort, int.
@@ -3405,6 +3449,7 @@ public:
 	 *   - **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.
@@ -3417,7 +3462,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **compression** -- Compression format, VipsForeignHeifCompression.
 	 *   - **effort** -- CPU effort, int.
@@ -3426,6 +3470,7 @@ public:
 	 *   - **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.
@@ -3438,7 +3483,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **compression** -- Compression format, VipsForeignHeifCompression.
 	 *   - **effort** -- CPU effort, int.
@@ -3447,6 +3491,7 @@ public:
 	 *   - **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.
@@ -3765,7 +3810,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Q factor, int.
@@ -3773,8 +3817,9 @@ public:
 	 *   - **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 load from.
+	 * @param filename Filename to save to.
 	 * @param options Set of options.
 	 */
 	void jp2ksave(const char *filename, VOption *options = nullptr) const;
@@ -3784,7 +3829,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Q factor, int.
@@ -3792,6 +3836,7 @@ public:
 	 *   - **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.
@@ -3803,7 +3848,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Q factor, int.
@@ -3811,6 +3855,7 @@ public:
 	 *   - **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.
@@ -3876,7 +3921,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **optimize_coding** -- Compute optimal Huffman coding tables, bool.
 	 *   - **interlace** -- Generate an interlaced (progressive) jpeg, bool.
 	 *   - **trellis_quant** -- Apply trellis quantisation to each 8x8 block, bool.
@@ -3888,6 +3932,7 @@ public:
 	 *   - **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.
@@ -3899,7 +3944,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **optimize_coding** -- Compute optimal Huffman coding tables, bool.
 	 *   - **interlace** -- Generate an interlaced (progressive) jpeg, bool.
 	 *   - **trellis_quant** -- Apply trellis quantisation to each 8x8 block, bool.
@@ -3911,6 +3955,7 @@ public:
 	 *   - **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.
@@ -3922,7 +3967,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **optimize_coding** -- Compute optimal Huffman coding tables, bool.
 	 *   - **interlace** -- Generate an interlaced (progressive) jpeg, bool.
 	 *   - **trellis_quant** -- Apply trellis quantisation to each 8x8 block, bool.
@@ -3934,6 +3978,7 @@ public:
 	 *   - **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.
 	 */
@@ -3944,7 +3989,6 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **optimize_coding** -- Compute optimal Huffman coding tables, bool.
 	 *   - **interlace** -- Generate an interlaced (progressive) jpeg, bool.
 	 *   - **trellis_quant** -- Apply trellis quantisation to each 8x8 block, bool.
@@ -3956,6 +4000,7 @@ public:
 	 *   - **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.
@@ -3966,6 +4011,8 @@ public:
 	 * Load jpeg-xl image.
 	 *
 	 * **Optional parameters**
+	 *   - **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.
@@ -3981,6 +4028,8 @@ public:
 	 * Load jpeg-xl image.
 	 *
 	 * **Optional parameters**
+	 *   - **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.
@@ -3996,6 +4045,8 @@ public:
 	 * Load jpeg-xl image.
 	 *
 	 * **Optional parameters**
+	 *   - **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.
@@ -4013,15 +4064,15 @@ public:
 	 * **Optional parameters**
 	 *   - **tier** -- Decode speed tier, int.
 	 *   - **distance** -- Target butteraugli distance, double.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality 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 load from.
+	 * @param filename Filename to save to.
 	 * @param options Set of options.
 	 */
 	void jxlsave(const char *filename, VOption *options = nullptr) const;
@@ -4032,13 +4083,13 @@ public:
 	 * **Optional parameters**
 	 *   - **tier** -- Decode speed tier, int.
 	 *   - **distance** -- Target butteraugli distance, double.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality 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.
@@ -4051,13 +4102,13 @@ public:
 	 * **Optional parameters**
 	 *   - **tier** -- Decode speed tier, int.
 	 *   - **distance** -- Target butteraugli distance, double.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **effort** -- Encoding effort, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
 	 *   - **Q** -- Quality 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.
@@ -4157,10 +4208,10 @@ public:
 	 *   - **optimize_gif_frames** -- Apply GIF frames optimization, bool.
 	 *   - **optimize_gif_transparency** -- Apply GIF transparency optimization, bool.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -4176,10 +4227,10 @@ public:
 	 *   - **optimize_gif_frames** -- Apply GIF frames optimization, bool.
 	 *   - **optimize_gif_transparency** -- Apply GIF transparency optimization, bool.
 	 *   - **bitdepth** -- Number of bits per pixel, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -4506,10 +4557,10 @@ public:
 	 * Print matrix.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
 	 */
@@ -4519,10 +4570,10 @@ public:
 	 * Save image to matrix.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -4533,10 +4584,10 @@ public:
 	 * Save image to matrix.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -4554,6 +4605,14 @@ public:
 	 */
 	double max(VOption *options = nullptr) const;
 
+	/**
+	 * Maximum of a pair of images.
+	 * @param right Right-hand image argument.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage maxpair(VImage right, VOption *options = nullptr) const;
+
 	/**
 	 * Measure a set of patches on a color chart.
 	 *
@@ -4596,6 +4655,14 @@ public:
 	 */
 	double min(VOption *options = nullptr) const;
 
+	/**
+	 * Minimum of a pair of images.
+	 * @param right Right-hand image argument.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	VImage minpair(VImage right, VOption *options = nullptr) const;
+
 	/**
 	 * Morphology operation.
 	 * @param mask Input matrix image.
@@ -4703,10 +4770,10 @@ public:
 	 * Save image to nifti file.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -4916,7 +4983,6 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
@@ -4926,6 +4992,7 @@ public:
 	 *   - **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.
@@ -4938,7 +5005,6 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
@@ -4948,6 +5014,7 @@ public:
 	 *   - **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.
@@ -4960,7 +5027,6 @@ public:
 	 * **Optional parameters**
 	 *   - **compression** -- Compression factor, int.
 	 *   - **interlace** -- Interlace image, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **filter** -- libspng row filter flag(s), VipsForeignPngFilter.
 	 *   - **palette** -- Quantise to 8bpp palette, bool.
 	 *   - **Q** -- Quantisation quality, int.
@@ -4970,6 +5036,7 @@ public:
 	 *   - **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.
@@ -5012,11 +5079,11 @@ public:
 	 * **Optional parameters**
 	 *   - **format** -- Format to save in, VipsForeignPpmFormat.
 	 *   - **ascii** -- Save as ascii, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **bitdepth** -- Set to 1 to write as a 1 bit image, 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.
@@ -5029,11 +5096,11 @@ public:
 	 * **Optional parameters**
 	 *   - **format** -- Format to save in, VipsForeignPpmFormat.
 	 *   - **ascii** -- Save as ascii, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **bitdepth** -- Set to 1 to write as a 1 bit image, 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.
@@ -5150,10 +5217,10 @@ public:
 	 * Save image to radiance file.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -5164,10 +5231,10 @@ public:
 	 * Save image to radiance buffer.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -5178,10 +5245,10 @@ public:
 	 * Save image to radiance target.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -5223,10 +5290,10 @@ public:
 	 * Save image to raw file.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -5234,18 +5301,32 @@ public:
 	void rawsave(const char *filename, VOption *options = nullptr) const;
 
 	/**
-	 * Write raw image to file descriptor.
+	 * Write raw image to buffer.
 	 *
 	 * **Optional parameters**
+	 *   - **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 *rawsave_buffer(VOption *options = nullptr) const;
+
+	/**
+	 * Write raw image to target.
+	 *
+	 * **Optional parameters**
 	 *   - **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 fd File descriptor to write to.
+	 * @param target Target to save to.
 	 * @param options Set of options.
 	 */
-	void rawsave_fd(int fd, VOption *options = nullptr) const;
+	void rawsave_target(VTarget target, VOption *options = nullptr) const;
 
 	/**
 	 * Linear recombination with matrix.
@@ -5382,7 +5463,7 @@ public:
 	 *   - **idx** -- Horizontal input displacement, double.
 	 *   - **idy** -- Vertical input displacement, double.
 	 *
-	 * @param angle Rotate anticlockwise by this many degrees.
+	 * @param angle Rotate clockwise by this many degrees.
 	 * @param options Set of options.
 	 * @return Output image.
 	 */
@@ -5458,6 +5539,23 @@ public:
 	 */
 	VImage scharr(VOption *options = nullptr) const;
 
+	/**
+	 * Create an sdf image.
+	 *
+	 * **Optional parameters**
+	 *   - **r** -- Radius, double.
+	 *   - **a** -- Point a, std::vector<double>.
+	 *   - **b** -- Point b, std::vector<double>.
+	 *   - **corners** -- Corner radii, std::vector<double>.
+	 *
+	 * @param width Image width in pixels.
+	 * @param height Image height in pixels.
+	 * @param shape SDF shape to create.
+	 * @param options Set of options.
+	 * @return Output image.
+	 */
+	static VImage sdf(int width, int height, VipsSdfShape shape, VOption *options = nullptr);
+
 	/**
 	 * Check sequential access.
 	 *
@@ -5534,7 +5632,7 @@ public:
 	 *
 	 * **Optional parameters**
 	 *   - **scale** -- Scale by this factor, double.
-	 *   - **angle** -- Rotate anticlockwise by this many degrees, double.
+	 *   - **angle** -- Rotate clockwise by this many degrees, double.
 	 *   - **interpolate** -- Interpolate pixels with this, VInterpolate.
 	 *   - **background** -- Background value, std::vector<double>.
 	 *   - **odx** -- Horizontal output displacement, double.
@@ -5897,7 +5995,6 @@ public:
 	 *   - **predictor** -- Compression prediction, VipsForeignTiffPredictor.
 	 *   - **tile** -- Write a tiled tiff, bool.
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **pyramid** -- Write a pyramidal tiff, bool.
 	 *   - **miniswhite** -- Use 0 for white in 1-bit images, bool.
@@ -5908,7 +6005,7 @@ public:
 	 *   - **bigtiff** -- Write a bigtiff image, bool.
 	 *   - **properties** -- Write a properties document to IMAGEDESCRIPTION, bool.
 	 *   - **region_shrink** -- Method to shrink regions, VipsRegionShrink.
-	 *   - **level** -- ZSTD compression level, int.
+	 *   - **level** -- Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level, int.
 	 *   - **lossless** -- Enable WEBP lossless mode, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **subifd** -- Save pyr layers as sub-IFDs, bool.
@@ -5916,6 +6013,7 @@ public:
 	 *   - **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.
@@ -5931,7 +6029,6 @@ public:
 	 *   - **predictor** -- Compression prediction, VipsForeignTiffPredictor.
 	 *   - **tile** -- Write a tiled tiff, bool.
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **pyramid** -- Write a pyramidal tiff, bool.
 	 *   - **miniswhite** -- Use 0 for white in 1-bit images, bool.
@@ -5942,7 +6039,7 @@ public:
 	 *   - **bigtiff** -- Write a bigtiff image, bool.
 	 *   - **properties** -- Write a properties document to IMAGEDESCRIPTION, bool.
 	 *   - **region_shrink** -- Method to shrink regions, VipsRegionShrink.
-	 *   - **level** -- ZSTD compression level, int.
+	 *   - **level** -- Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level, int.
 	 *   - **lossless** -- Enable WEBP lossless mode, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **subifd** -- Save pyr layers as sub-IFDs, bool.
@@ -5950,6 +6047,7 @@ public:
 	 *   - **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.
@@ -5965,7 +6063,6 @@ public:
 	 *   - **predictor** -- Compression prediction, VipsForeignTiffPredictor.
 	 *   - **tile** -- Write a tiled tiff, bool.
 	 *   - **tile_width** -- Tile width in pixels, int.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **tile_height** -- Tile height in pixels, int.
 	 *   - **pyramid** -- Write a pyramidal tiff, bool.
 	 *   - **miniswhite** -- Use 0 for white in 1-bit images, bool.
@@ -5976,7 +6073,7 @@ public:
 	 *   - **bigtiff** -- Write a bigtiff image, bool.
 	 *   - **properties** -- Write a properties document to IMAGEDESCRIPTION, bool.
 	 *   - **region_shrink** -- Method to shrink regions, VipsRegionShrink.
-	 *   - **level** -- ZSTD compression level, int.
+	 *   - **level** -- Deflate (1-9, default 6) or ZSTD (1-22, default 9) compression level, int.
 	 *   - **lossless** -- Enable WEBP lossless mode, bool.
 	 *   - **depth** -- Pyramid depth, VipsForeignDzDepth.
 	 *   - **subifd** -- Save pyr layers as sub-IFDs, bool.
@@ -5984,6 +6081,7 @@ public:
 	 *   - **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.
@@ -6083,10 +6181,10 @@ public:
 	 * Save image to file in vips format.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -6097,10 +6195,10 @@ public:
 	 * Save image to target in vips format.
 	 *
 	 * **Optional parameters**
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **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.
@@ -6167,7 +6265,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6176,10 +6273,14 @@ public:
 	 *   - **kmin** -- Minimum number of frames between key frames, int.
 	 *   - **kmax** -- Maximum number of frames between key frames, int.
 	 *   - **effort** -- Level of CPU effort to reduce file size, int.
+	 *   - **target_size** -- Desired target size in bytes, int.
 	 *   - **mixed** -- Allow mixed encoding (might reduce file size), bool.
+	 *   - **smart_deblock** -- Enable auto-adjusting of the deblocking filter, bool.
+	 *   - **passes** -- Number of entropy-analysis passes (in [1..10]), 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.
@@ -6192,7 +6293,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6201,10 +6301,14 @@ public:
 	 *   - **kmin** -- Minimum number of frames between key frames, int.
 	 *   - **kmax** -- Maximum number of frames between key frames, int.
 	 *   - **effort** -- Level of CPU effort to reduce file size, int.
+	 *   - **target_size** -- Desired target size in bytes, int.
 	 *   - **mixed** -- Allow mixed encoding (might reduce file size), bool.
+	 *   - **smart_deblock** -- Enable auto-adjusting of the deblocking filter, bool.
+	 *   - **passes** -- Number of entropy-analysis passes (in [1..10]), 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.
@@ -6217,7 +6321,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6226,10 +6329,14 @@ public:
 	 *   - **kmin** -- Minimum number of frames between key frames, int.
 	 *   - **kmax** -- Maximum number of frames between key frames, int.
 	 *   - **effort** -- Level of CPU effort to reduce file size, int.
+	 *   - **target_size** -- Desired target size in bytes, int.
 	 *   - **mixed** -- Allow mixed encoding (might reduce file size), bool.
+	 *   - **smart_deblock** -- Enable auto-adjusting of the deblocking filter, bool.
+	 *   - **passes** -- Number of entropy-analysis passes (in [1..10]), 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.
 	 */
@@ -6241,7 +6348,6 @@ public:
 	 * **Optional parameters**
 	 *   - **Q** -- Q factor, int.
 	 *   - **lossless** -- Enable lossless compression, bool.
-	 *   - **profile** -- Filename of ICC profile to embed, const char *.
 	 *   - **preset** -- Preset for lossy compression, VipsForeignWebpPreset.
 	 *   - **smart_subsample** -- Enable high quality chroma subsampling, bool.
 	 *   - **near_lossless** -- Enable preprocessing in lossless mode (uses Q), bool.
@@ -6250,10 +6356,14 @@ public:
 	 *   - **kmin** -- Minimum number of frames between key frames, int.
 	 *   - **kmax** -- Maximum number of frames between key frames, int.
 	 *   - **effort** -- Level of CPU effort to reduce file size, int.
+	 *   - **target_size** -- Desired target size in bytes, int.
 	 *   - **mixed** -- Allow mixed encoding (might reduce file size), bool.
+	 *   - **smart_deblock** -- Enable auto-adjusting of the deblocking filter, bool.
+	 *   - **passes** -- Number of entropy-analysis passes (in [1..10]), 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.