@img/sharp-libvips-dev 0.0.1 → 0.0.3

package/include/vips/foreign.h

@@ -4,28 +4,28 @@
 
 /*
 
-    This file is part of VIPS.
-    
-    VIPS is free software; you can redistribute it and/or modify
-    it under the terms of the GNU Lesser General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
-    02110-1301  USA
+	This file is part of VIPS.
+
+	VIPS is free software; you can redistribute it and/or modify
+	it under the terms of the GNU Lesser General Public License as published by
+	the Free Software Foundation; either version 2 of the License, or
+	(at your option) any later version.
+
+	This program is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+	GNU Lesser General Public License for more details.
+
+	You should have received a copy of the GNU Lesser General Public License
+	along with this program; if not, write to the Free Software
+	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+	02110-1301  USA
 
  */
 
 /*
 
-    These files are distributed with VIPS - http://www.vips.ecs.soton.ac.uk
+	These files are distributed with VIPS - http://www.vips.ecs.soton.ac.uk
 
  */
 
@@ -42,19 +42,19 @@ extern "C" {
 #endif /*__cplusplus*/
 
 #define VIPS_TYPE_FOREIGN (vips_foreign_get_type())
-#define VIPS_FOREIGN( obj ) \
-	(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
-	VIPS_TYPE_FOREIGN, VipsForeign ))
-#define VIPS_FOREIGN_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_CAST( (klass), \
-	VIPS_TYPE_FOREIGN, VipsForeignClass))
-#define VIPS_IS_FOREIGN( obj ) \
-	(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FOREIGN ))
-#define VIPS_IS_FOREIGN_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FOREIGN ))
-#define VIPS_FOREIGN_GET_CLASS( obj ) \
-	(G_TYPE_INSTANCE_GET_CLASS( (obj), \
-	VIPS_TYPE_FOREIGN, VipsForeignClass ))
+#define VIPS_FOREIGN(obj) \
+	(G_TYPE_CHECK_INSTANCE_CAST((obj), \
+		VIPS_TYPE_FOREIGN, VipsForeign))
+#define VIPS_FOREIGN_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_CAST((klass), \
+		VIPS_TYPE_FOREIGN, VipsForeignClass))
+#define VIPS_IS_FOREIGN(obj) \
+	(G_TYPE_CHECK_INSTANCE_TYPE((obj), VIPS_TYPE_FOREIGN))
+#define VIPS_IS_FOREIGN_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_TYPE((klass), VIPS_TYPE_FOREIGN))
+#define VIPS_FOREIGN_GET_CLASS(obj) \
+	(G_TYPE_INSTANCE_GET_CLASS((obj), \
+		VIPS_TYPE_FOREIGN, VipsForeignClass))
 
 typedef struct _VipsForeign {
 	VipsOperation parent_object;
@@ -91,32 +91,32 @@ GType vips_foreign_get_type(void);
  * subclasses of VipsForeign.
  */
 VIPS_API
-void *vips_foreign_map( const char *base, 
-	VipsSListMap2Fn fn, void *a, void *b );
+void *vips_foreign_map(const char *base,
+	VipsSListMap2Fn fn, void *a, void *b);
 
-/* Image file load properties. 
+/* Image file load properties.
  *
  * Keep in sync with the deprecated VipsFormatFlags, we need to be able to
  * cast between them.
  */
 typedef enum /*< flags >*/ {
-	VIPS_FOREIGN_NONE = 0,		/* No flags set */
-	VIPS_FOREIGN_PARTIAL = 1,	/* Lazy read OK (eg. tiled tiff) */
-	VIPS_FOREIGN_BIGENDIAN = 2,	/* Most-significant byte first */
-	VIPS_FOREIGN_SEQUENTIAL = 4,	/* Top-to-bottom lazy read OK */
-	VIPS_FOREIGN_ALL = 7		/* All flags set */
+	VIPS_FOREIGN_NONE = 0,		 /* No flags set */
+	VIPS_FOREIGN_PARTIAL = 1,	 /* Lazy read OK (eg. tiled tiff) */
+	VIPS_FOREIGN_BIGENDIAN = 2,	 /* Most-significant byte first */
+	VIPS_FOREIGN_SEQUENTIAL = 4, /* Top-to-bottom lazy read OK */
+	VIPS_FOREIGN_ALL = 7		 /* All flags set */
 } VipsForeignFlags;
 
-/** 
+/**
  * VipsFailOn:
- * @VIPS_FAIL_ON_NONE: never stop 
+ * @VIPS_FAIL_ON_NONE: never stop
  * @VIPS_FAIL_ON_TRUNCATED: stop on image truncated, nothing else
  * @VIPS_FAIL_ON_ERROR: stop on serious error or truncation
  * @VIPS_FAIL_ON_WARNING: stop on anything, even warnings
  *
- * How sensitive loaders are to errors, from never stop (very insensitive), to 
- * stop on the smallest warning (very sensitive). 
- * 
+ * How sensitive loaders are to errors, from never stop (very insensitive), to
+ * stop on the smallest warning (very sensitive).
+ *
  * Each one implies the ones before it, so #VIPS_FAIL_ON_ERROR implies
  * #VIPS_FAIL_ON_TRUNCATED.
  */
@@ -129,29 +129,29 @@ typedef enum {
 } VipsFailOn;
 
 #define VIPS_TYPE_FOREIGN_LOAD (vips_foreign_load_get_type())
-#define VIPS_FOREIGN_LOAD( obj ) \
-	(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
-	VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoad ))
-#define VIPS_FOREIGN_LOAD_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_CAST( (klass), \
-	VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoadClass))
-#define VIPS_IS_FOREIGN_LOAD( obj ) \
-	(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FOREIGN_LOAD ))
-#define VIPS_IS_FOREIGN_LOAD_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FOREIGN_LOAD ))
-#define VIPS_FOREIGN_LOAD_GET_CLASS( obj ) \
-	(G_TYPE_INSTANCE_GET_CLASS( (obj), \
-	VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoadClass ))
+#define VIPS_FOREIGN_LOAD(obj) \
+	(G_TYPE_CHECK_INSTANCE_CAST((obj), \
+		VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoad))
+#define VIPS_FOREIGN_LOAD_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_CAST((klass), \
+		VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoadClass))
+#define VIPS_IS_FOREIGN_LOAD(obj) \
+	(G_TYPE_CHECK_INSTANCE_TYPE((obj), VIPS_TYPE_FOREIGN_LOAD))
+#define VIPS_IS_FOREIGN_LOAD_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_TYPE((klass), VIPS_TYPE_FOREIGN_LOAD))
+#define VIPS_FOREIGN_LOAD_GET_CLASS(obj) \
+	(G_TYPE_INSTANCE_GET_CLASS((obj), \
+		VIPS_TYPE_FOREIGN_LOAD, VipsForeignLoadClass))
 
 typedef struct _VipsForeignLoad {
 	VipsForeign parent_object;
 	/*< private >*/
 
-	/* Set TRUE to force open via memory. 
+	/* Set TRUE to force open via memory.
 	 */
 	gboolean memory;
 
-	/* Type of access upstream wants and the loader must supply. 
+	/* Type of access upstream wants and the loader must supply.
 	 */
 	VipsAccess access;
 
@@ -192,75 +192,80 @@ typedef struct _VipsForeignLoad {
 	 * from also triggering the load.
 	 */
 	gboolean error;
+
+	/* Set by "revalidate": set the REVALIDATE flag for this operation to
+	 * force it to execute.
+	 */
+	gboolean revalidate;
 } VipsForeignLoad;
 
 typedef struct _VipsForeignLoadClass {
 	VipsForeignClass parent_class;
 	/*< public >*/
 
-	/* Is a file in this format. 
+	/* Is a file in this format.
 	 *
-	 * This function should return %TRUE if the file contains an image of 
+	 * This function should return %TRUE if the file contains an image of
 	 * this type. If you don't define this function, #VipsForeignLoad
 	 * will use @suffs instead.
 	 */
-	gboolean (*is_a)( const char *filename );
+	gboolean (*is_a)(const char *filename);
 
-	/* Is a buffer in this format. 
+	/* Is a buffer in this format.
 	 *
-	 * This function should return %TRUE if the buffer contains an image of 
-	 * this type. 
+	 * This function should return %TRUE if the buffer contains an image of
+	 * this type.
 	 */
-	gboolean (*is_a_buffer)( const void *data, size_t size );
+	gboolean (*is_a_buffer)(const void *data, size_t size);
 
-	/* Is a stream in this format. 
+	/* Is a stream in this format.
 	 *
-	 * This function should return %TRUE if the stream contains an image of 
-	 * this type. 
+	 * This function should return %TRUE if the stream contains an image of
+	 * this type.
 	 */
-	gboolean (*is_a_source)( VipsSource *source );
+	gboolean (*is_a_source)(VipsSource *source);
 
-	/* Get the flags from a filename. 
+	/* Get the flags from a filename.
 	 *
 	 * This function should examine the file and return a set
-	 * of flags. If you don't define it, vips will default to 0 (no flags 
-	 * set).  
+	 * of flags. If you don't define it, vips will default to 0 (no flags
+	 * set).
 	 *
 	 * This method is necessary for vips7 compatibility. Don't define
 	 * it if you don't need vips7.
 	 */
-	VipsForeignFlags (*get_flags_filename)( const char *filename );
+	VipsForeignFlags (*get_flags_filename)(const char *filename);
 
-	/* Get the flags for this load operation. Images can be loaded from 
+	/* Get the flags for this load operation. Images can be loaded from
 	 * (for example) memory areas rather than files, so you can't just use
 	 * @get_flags_filename().
 	 */
-	VipsForeignFlags (*get_flags)( VipsForeignLoad *load );
+	VipsForeignFlags (*get_flags)(VipsForeignLoad *load);
 
-	/* Do the minimum read we can. 
+	/* Do the minimum read we can.
 	 *
-	 * Set the header fields in @out from @filename. If you can read the 
+	 * Set the header fields in @out from @filename. If you can read the
 	 * whole image as well with no performance cost (as with vipsload),
 	 * or if your loader does not support reading only the header, read
 	 * the entire image in this method and leave @load() NULL.
 	 *
-	 * @header() needs to set the dhint on the image .. otherwise you get 
+	 * @header() needs to set the dhint on the image .. otherwise you get
 	 * the default SMALLTILE.
 	 *
 	 * Return 0 for success, -1 for error, setting vips_error().
 	 */
-	int (*header)( VipsForeignLoad *load );
+	int (*header)(VipsForeignLoad *load);
 
-	/* Read the whole image into @real. The pixels will get copied to @out 
+	/* Read the whole image into @real. The pixels will get copied to @out
 	 * later.
 	 *
-	 * You can omit this method if you define a @header() method which 
-	 * loads the whole file. 
+	 * You can omit this method if you define a @header() method which
+	 * loads the whole file.
 	 *
 	 * Return 0 for success, -1 for error, setting
 	 * vips_error().
 	 */
-	int (*load)( VipsForeignLoad *load );
+	int (*load)(VipsForeignLoad *load);
 } VipsForeignLoadClass;
 
 /* Don't put spaces around void here, it breaks gtk-doc.
@@ -269,45 +274,45 @@ VIPS_API
 GType vips_foreign_load_get_type(void);
 
 VIPS_API
-const char *vips_foreign_find_load( const char *filename );
+const char *vips_foreign_find_load(const char *filename);
 VIPS_API
-const char *vips_foreign_find_load_buffer( const void *data, size_t size );
+const char *vips_foreign_find_load_buffer(const void *data, size_t size);
 VIPS_API
-const char *vips_foreign_find_load_source( VipsSource *source );
+const char *vips_foreign_find_load_source(VipsSource *source);
 
 VIPS_API
-VipsForeignFlags vips_foreign_flags( const char *loader, const char *filename );
+VipsForeignFlags vips_foreign_flags(const char *loader, const char *filename);
 VIPS_API
-gboolean vips_foreign_is_a( const char *loader, const char *filename );
+gboolean vips_foreign_is_a(const char *loader, const char *filename);
 VIPS_API
-gboolean vips_foreign_is_a_buffer( const char *loader, 
-	const void *data, size_t size );
+gboolean vips_foreign_is_a_buffer(const char *loader,
+	const void *data, size_t size);
 VIPS_API
-gboolean vips_foreign_is_a_source( const char *loader, 
-	VipsSource *source );
+gboolean vips_foreign_is_a_source(const char *loader,
+	VipsSource *source);
 
 VIPS_API
-void vips_foreign_load_invalidate( VipsImage *image );
+void vips_foreign_load_invalidate(VipsImage *image);
 
 #define VIPS_TYPE_FOREIGN_SAVE (vips_foreign_save_get_type())
-#define VIPS_FOREIGN_SAVE( obj ) \
-	(G_TYPE_CHECK_INSTANCE_CAST( (obj), \
-	VIPS_TYPE_FOREIGN_SAVE, VipsForeignSave ))
-#define VIPS_FOREIGN_SAVE_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_CAST( (klass), \
-	VIPS_TYPE_FOREIGN_SAVE, VipsForeignSaveClass))
-#define VIPS_IS_FOREIGN_SAVE( obj ) \
-	(G_TYPE_CHECK_INSTANCE_TYPE( (obj), VIPS_TYPE_FOREIGN_SAVE ))
-#define VIPS_IS_FOREIGN_SAVE_CLASS( klass ) \
-	(G_TYPE_CHECK_CLASS_TYPE( (klass), VIPS_TYPE_FOREIGN_SAVE ))
-#define VIPS_FOREIGN_SAVE_GET_CLASS( obj ) \
-	(G_TYPE_INSTANCE_GET_CLASS( (obj), \
-	VIPS_TYPE_FOREIGN_SAVE, VipsForeignSaveClass ))
-
-/** 
+#define VIPS_FOREIGN_SAVE(obj) \
+	(G_TYPE_CHECK_INSTANCE_CAST((obj), \
+		VIPS_TYPE_FOREIGN_SAVE, VipsForeignSave))
+#define VIPS_FOREIGN_SAVE_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_CAST((klass), \
+		VIPS_TYPE_FOREIGN_SAVE, VipsForeignSaveClass))
+#define VIPS_IS_FOREIGN_SAVE(obj) \
+	(G_TYPE_CHECK_INSTANCE_TYPE((obj), VIPS_TYPE_FOREIGN_SAVE))
+#define VIPS_IS_FOREIGN_SAVE_CLASS(klass) \
+	(G_TYPE_CHECK_CLASS_TYPE((klass), VIPS_TYPE_FOREIGN_SAVE))
+#define VIPS_FOREIGN_SAVE_GET_CLASS(obj) \
+	(G_TYPE_INSTANCE_GET_CLASS((obj), \
+		VIPS_TYPE_FOREIGN_SAVE, VipsForeignSaveClass))
+
+/**
  * VipsSaveable:
  * @VIPS_SAVEABLE_MONO: 1 band (eg. CSV)
- * @VIPS_SAVEABLE_RGB: 1 or 3 bands (eg. PPM) 
+ * @VIPS_SAVEABLE_RGB: 1 or 3 bands (eg. PPM)
  * @VIPS_SAVEABLE_RGBA: 1, 2, 3 or 4 bands (eg. PNG)
  * @VIPS_SAVEABLE_RGBA_ONLY: 3 or 4 bands (eg. WEBP)
  * @VIPS_SAVEABLE_RGB_CMYK: 1, 3 or 4 bands (eg. JPEG)
@@ -325,13 +330,48 @@ typedef enum {
 	VIPS_SAVEABLE_LAST
 } VipsSaveable;
 
+/**
+ * VipsForeignKeep:
+ * @VIPS_FOREIGN_KEEP_NONE: don't attach metadata
+ * @VIPS_FOREIGN_KEEP_EXIF: keep Exif metadata
+ * @VIPS_FOREIGN_KEEP_XMP: keep XMP metadata
+ * @VIPS_FOREIGN_KEEP_IPTC: keep IPTC metadata
+ * @VIPS_FOREIGN_KEEP_ICC: keep ICC metadata
+ * @VIPS_FOREIGN_KEEP_OTHER: keep other metadata (e.g. PNG comments and some TIFF tags)
+ * @VIPS_FOREIGN_KEEP_ALL: keep all metadata
+ *
+ * Which metadata to retain.
+ */
+typedef enum /*< flags >*/ {
+	VIPS_FOREIGN_KEEP_NONE = 0,
+	VIPS_FOREIGN_KEEP_EXIF = 1 << 0,
+	VIPS_FOREIGN_KEEP_XMP = 1 << 1,
+	VIPS_FOREIGN_KEEP_IPTC = 1 << 2,
+	VIPS_FOREIGN_KEEP_ICC = 1 << 3,
+	VIPS_FOREIGN_KEEP_OTHER = 1 << 4,
+
+	VIPS_FOREIGN_KEEP_ALL = (VIPS_FOREIGN_KEEP_EXIF |
+		VIPS_FOREIGN_KEEP_XMP |
+		VIPS_FOREIGN_KEEP_IPTC |
+		VIPS_FOREIGN_KEEP_ICC |
+		VIPS_FOREIGN_KEEP_OTHER),
+} VipsForeignKeep;
+
 typedef struct _VipsForeignSave {
 	VipsForeign parent_object;
 
-	/* Don't attach metadata.
+	/* Deprecated in favor of [keep=none]
 	 */
 	gboolean strip;
 
+	/* Which metadata to retain.
+	 */
+	VipsForeignKeep keep;
+
+	/* Filename of profile to embed.
+	 */
+	char *profile;
+
 	/* If flattening out alpha, the background colour to use. Default to
 	 * 0 (black).
 	 */
@@ -343,7 +383,7 @@ typedef struct _VipsForeignSave {
 
 	/*< public >*/
 
-	/* The image we are to save, as supplied by our caller. 
+	/* The image we are to save, as supplied by our caller.
 	 */
 	VipsImage *in;
 
@@ -363,17 +403,17 @@ typedef struct _VipsForeignSaveClass {
 
 	/* How this format treats bands.
 	 *
-	 * @saveable describes the bands that your saver can handle. For 
-	 * example, PPM images can have 1 or 3 bands (mono or RGB), so it 
+	 * @saveable describes the bands that your saver can handle. For
+	 * example, PPM images can have 1 or 3 bands (mono or RGB), so it
 	 * uses #VIPS_SAVEABLE_RGB.
 	 */
 	VipsSaveable saveable;
 
 	/* How this format treats band formats.
 	 *
-	 * @format_table describes the band formats that your saver can 
-	 * handle. For each of the 10 #VipsBandFormat values, the array 
-	 * should give the format your saver will accept. 
+	 * @format_table describes the band formats that your saver can
+	 * handle. For each of the 10 #VipsBandFormat values, the array
+	 * should give the format your saver will accept.
 	 */
 	VipsBandFormat *format_table;
 
@@ -391,32 +431,32 @@ VIPS_API
 GType vips_foreign_save_get_type(void);
 
 VIPS_API
-const char *vips_foreign_find_save( const char *filename );
+const char *vips_foreign_find_save(const char *filename);
 VIPS_API
-gchar **vips_foreign_get_suffixes( void );
+gchar **vips_foreign_get_suffixes(void);
 VIPS_API
-const char *vips_foreign_find_save_buffer( const char *suffix );
+const char *vips_foreign_find_save_buffer(const char *suffix);
 VIPS_API
-const char *vips_foreign_find_save_target( const char *suffix );
+const char *vips_foreign_find_save_target(const char *suffix);
 
 VIPS_API
-int vips_vipsload( const char *filename, VipsImage **out, ... )
+int vips_vipsload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_vipsload_source( VipsSource *source, VipsImage **out, ... )
+int vips_vipsload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_vipssave( VipsImage *in, const char *filename, ... )
+int vips_vipssave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_vipssave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_vipssave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_openslideload( const char *filename, VipsImage **out, ... )
+int vips_openslideload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_openslideload_source( VipsSource *source, VipsImage **out, ... )
+int vips_openslideload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -452,26 +492,26 @@ typedef enum {
 } VipsForeignJpegSubsample;
 
 VIPS_API
-int vips_jpegload( const char *filename, VipsImage **out, ... )
+int vips_jpegload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jpegload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_jpegload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jpegload_source( VipsSource *source, VipsImage **out, ... )
+int vips_jpegload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_jpegsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_jpegsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jpegsave( VipsImage *in, const char *filename, ... )
+int vips_jpegsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jpegsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_jpegsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jpegsave_mime( VipsImage *in, ... )
+int vips_jpegsave_mime(VipsImage *in, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -496,26 +536,26 @@ typedef enum {
 } VipsForeignWebpPreset;
 
 VIPS_API
-int vips_webpload_source( VipsSource *source, VipsImage **out, ... )
+int vips_webpload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_webpload( const char *filename, VipsImage **out, ... )
+int vips_webpload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_webpload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_webpload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_webpsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_webpsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_webpsave( VipsImage *in, const char *filename, ... )
+int vips_webpsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_webpsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_webpsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_webpsave_mime( VipsImage *in, ... )
+int vips_webpsave_mime(VipsImage *in, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -583,90 +623,90 @@ typedef enum {
 } VipsForeignTiffResunit;
 
 VIPS_API
-int vips_tiffload( const char *filename, VipsImage **out, ... )
+int vips_tiffload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_tiffload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_tiffload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_tiffload_source( VipsSource *source, VipsImage **out, ... )
+int vips_tiffload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_tiffsave( VipsImage *in, const char *filename, ... )
+int vips_tiffsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_tiffsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_tiffsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_tiffsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_tiffsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_openexrload( const char *filename, VipsImage **out, ... )
+int vips_openexrload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_fitsload( const char *filename, VipsImage **out, ... )
+int vips_fitsload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_fitssave( VipsImage *in, const char *filename, ... )
+int vips_fitssave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_analyzeload( const char *filename, VipsImage **out, ... )
+int vips_analyzeload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_rawload( const char *filename, VipsImage **out, 
-	int width, int height, int bands, ... )
+int vips_rawload(const char *filename, VipsImage **out,
+	int width, int height, int bands, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_rawsave( VipsImage *in, const char *filename, ... )
+int vips_rawsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_rawsave_fd( VipsImage *in, int fd, ... )
+int vips_rawsave_fd(VipsImage *in, int fd, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_csvload( const char *filename, VipsImage **out, ... )
+int vips_csvload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_csvload_source( VipsSource *source, VipsImage **out, ... )
+int vips_csvload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_csvsave( VipsImage *in, const char *filename, ... )
+int vips_csvsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_csvsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_csvsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_matrixload( const char *filename, VipsImage **out, ... )
+int vips_matrixload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_matrixload_source( VipsSource *source, VipsImage **out, ... )
+int vips_matrixload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_matrixsave( VipsImage *in, const char *filename, ... )
+int vips_matrixsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_matrixsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_matrixsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_matrixprint( VipsImage *in, ... )
+int vips_matrixprint(VipsImage *in, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_magickload( const char *filename, VipsImage **out, ... )
+int vips_magickload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_magickload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_magickload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_magicksave( VipsImage *in, const char *filename, ... )
+int vips_magicksave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_magicksave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_magicksave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -691,22 +731,22 @@ typedef enum /*< flags >*/ {
 } VipsForeignPngFilter;
 
 VIPS_API
-int vips_pngload_source( VipsSource *source, VipsImage **out, ... )
+int vips_pngload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pngload( const char *filename, VipsImage **out, ... )
+int vips_pngload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pngload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_pngload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pngsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_pngsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pngsave( VipsImage *in, const char *filename, ... )
+int vips_pngsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pngsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_pngsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -741,149 +781,149 @@ typedef enum {
 } VipsForeignPpmFormat;
 
 VIPS_API
-int vips_ppmload( const char *filename, VipsImage **out, ... )
+int vips_ppmload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_ppmload_source( VipsSource *source, VipsImage **out, ... )
+int vips_ppmload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_ppmsave( VipsImage *in, const char *filename, ... )
+int vips_ppmsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_ppmsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_ppmsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_matload( const char *filename, VipsImage **out, ... )
+int vips_matload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_radload_source( VipsSource *source, VipsImage **out, ... )
+int vips_radload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_radload( const char *filename, VipsImage **out, ... )
+int vips_radload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_radload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_radload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_radsave( VipsImage *in, const char *filename, ... )
+int vips_radsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_radsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_radsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_radsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_radsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_pdfload( const char *filename, VipsImage **out, ... )
+int vips_pdfload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pdfload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_pdfload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_pdfload_source( VipsSource *source, VipsImage **out, ... )
+int vips_pdfload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_svgload( const char *filename, VipsImage **out, ... )
+int vips_svgload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_svgload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_svgload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_svgload_string( const char *str, VipsImage **out, ... )
+int vips_svgload_string(const char *str, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_svgload_source( VipsSource *source, VipsImage **out, ... )
+int vips_svgload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_gifload( const char *filename, VipsImage **out, ... )
+int vips_gifload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_gifload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_gifload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_gifload_source( VipsSource *source, VipsImage **out, ... )
+int vips_gifload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_gifsave( VipsImage *in, const char *filename, ... )
+int vips_gifsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_gifsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_gifsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_gifsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_gifsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_heifload( const char *filename, VipsImage **out, ... )
+int vips_heifload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_heifload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_heifload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_heifload_source( VipsSource *source, VipsImage **out, ... )
+int vips_heifload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_heifsave( VipsImage *in, const char *filename, ... )
+int vips_heifsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_heifsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_heifsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_heifsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_heifsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_niftiload( const char *filename, VipsImage **out, ... )
+int vips_niftiload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_niftiload_source( VipsSource *source, VipsImage **out, ... )
+int vips_niftiload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_niftisave( VipsImage *in, const char *filename, ... )
+int vips_niftisave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_jp2kload( const char *filename, VipsImage **out, ... )
+int vips_jp2kload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jp2kload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_jp2kload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jp2kload_source( VipsSource *source, VipsImage **out, ... )
+int vips_jp2kload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jp2ksave( VipsImage *in, const char *filename, ... )
+int vips_jp2ksave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jp2ksave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_jp2ksave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jp2ksave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_jp2ksave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 VIPS_API
-int vips_jxlload_source( VipsSource *source, VipsImage **out, ... )
+int vips_jxlload_source(VipsSource *source, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jxlload_buffer( void *buf, size_t len, VipsImage **out, ... )
+int vips_jxlload_buffer(void *buf, size_t len, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jxlload( const char *filename, VipsImage **out, ... )
+int vips_jxlload(const char *filename, VipsImage **out, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jxlsave( VipsImage *in, const char *filename, ... )
+int vips_jxlsave(VipsImage *in, const char *filename, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jxlsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_jxlsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_jxlsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_jxlsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -894,7 +934,7 @@ int vips_jxlsave_target( VipsImage *in, VipsTarget *target, ... )
  * @VIPS_FOREIGN_DZ_LAYOUT_IIIF: use IIIF v2 directory layout
  * @VIPS_FOREIGN_DZ_LAYOUT_IIIF3: use IIIF v3 directory layout
  *
- * What directory layout and metadata standard to use. 
+ * What directory layout and metadata standard to use.
  */
 typedef enum {
 	VIPS_FOREIGN_DZ_LAYOUT_DZ,
@@ -936,13 +976,13 @@ typedef enum {
 } VipsForeignDzContainer;
 
 VIPS_API
-int vips_dzsave( VipsImage *in, const char *name, ... )
+int vips_dzsave(VipsImage *in, const char *name, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_dzsave_buffer( VipsImage *in, void **buf, size_t *len, ... )
+int vips_dzsave_buffer(VipsImage *in, void **buf, size_t *len, ...)
 	G_GNUC_NULL_TERMINATED;
 VIPS_API
-int vips_dzsave_target( VipsImage *in, VipsTarget *target, ... )
+int vips_dzsave_target(VipsImage *in, VipsTarget *target, ...)
 	G_GNUC_NULL_TERMINATED;
 
 /**
@@ -952,7 +992,7 @@ int vips_dzsave_target( VipsImage *in, VipsTarget *target, ... )
  * @VIPS_FOREIGN_HEIF_COMPRESSION_JPEG: jpeg
  * @VIPS_FOREIGN_HEIF_COMPRESSION_AV1: aom
  *
- * The compression format to use inside a HEIF container. 
+ * The compression format to use inside a HEIF container.
  *
  * This is assumed to use the same numbering as %heif_compression_format.
  */