/* save to ppm
 *
 * 2/12/11
 * 	- wrap a class around the ppm writer
 * 13/11/19
 * 	- redone with targets
 * 18/6/20
 * 	- add "bitdepth" param, cf. tiffsave
 * 27/6/20
 * 	- add ppmsave_target
 * 20/11/20
 * 	- byteswap on save, if necessary [ewelot]
 * 2/12/20
 * 	- don't add date with @strip [ewelot]
 * 28/10/21
 * 	- add @format, default type by filename
 * 30/8/22
 *      - add ".pnm", save as image format [ewelot]
 */

/*

    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

 */

/*
#define DEBUG_VERBOSE
#define DEBUG
 */

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif /*HAVE_CONFIG_H*/
#include <glib/gi18n-lib.h>

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <vips/vips.h>
#include <vips/internal.h>

#include "pforeign.h"

#ifdef HAVE_PPM

typedef struct _VipsForeignSavePpm VipsForeignSavePpm;

typedef int (*VipsSavePpmFn)( VipsForeignSavePpm *, VipsImage *, VipsPel * );

struct _VipsForeignSavePpm {
	VipsForeignSave parent_object;

	VipsTarget *target;
	VipsForeignPpmFormat format;
	gboolean ascii;
	int bitdepth;

	VipsSavePpmFn fn;

	/* Deprecated.
	 */
	gboolean squash;
};

typedef VipsForeignSaveClass VipsForeignSavePpmClass;

G_DEFINE_ABSTRACT_TYPE( VipsForeignSavePpm, vips_foreign_save_ppm, 
	VIPS_TYPE_FOREIGN_SAVE );

static void
vips_foreign_save_ppm_dispose( GObject *gobject )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) gobject;

	VIPS_UNREF( ppm->target );

	G_OBJECT_CLASS( vips_foreign_save_ppm_parent_class )->
		dispose( gobject );
}

static int
vips_foreign_save_ppm_line_ascii( VipsForeignSavePpm *ppm, 
        VipsImage *image, VipsPel *p )
{
	const int n_elements = image->Xsize * image->Bands;

	int i;

	for( i = 0; i < n_elements; i++ ) {
		switch( image->BandFmt ) {
		case VIPS_FORMAT_UCHAR:
			vips_target_writef( ppm->target, 
				"%d ", p[i] );
			break;

		case VIPS_FORMAT_USHORT:
			vips_target_writef( ppm->target, 
				"%d ", ((unsigned short *) p)[i] );
			break;

		case VIPS_FORMAT_UINT:
			vips_target_writef( ppm->target, 
				"%d ", ((unsigned int *) p)[i] );
			break;

		default:
			g_assert_not_reached();
		}
	}

	if( vips_target_writes( ppm->target, "\n" ) ) 
		return( -1 );

	return( 0 );
}

static int
vips_foreign_save_ppm_line_ascii_1bit( VipsForeignSavePpm *ppm, 
        VipsImage *image, VipsPel *p )
{
	int x;

	for( x = 0; x < image->Xsize; x++ ) 
		vips_target_writef( ppm->target, "%d ", p[x] ? 0 : 1 );

	if( vips_target_writes( ppm->target, "\n" ) ) 
		return( -1 );

	return( 0 );
}

static int
vips_foreign_save_ppm_line_binary( VipsForeignSavePpm *ppm, 
        VipsImage *image, VipsPel *p )
{
	if( vips_target_write( ppm->target, 
		p, VIPS_IMAGE_SIZEOF_LINE( image ) ) ) 
		return( -1 );

	return( 0 );
}

static int
vips_foreign_save_ppm_line_binary_1bit( VipsForeignSavePpm *ppm, 
	VipsImage *image, VipsPel *p )
{
	int x;
	int bits;
	int n_bits;

	bits = 0;
	n_bits = 0;
	for( x = 0; x < image->Xsize; x++ ) {
		bits = VIPS_LSHIFT_INT( bits, 1 );
		n_bits += 1;
		bits |= p[x] > 128 ? 0 : 1;

		if( n_bits == 8 ) {
			if( VIPS_TARGET_PUTC( ppm->target, bits ) ) 
				return( -1 );

			bits = 0;
			n_bits = 0;
		}
	}

	/* Flush any remaining bits in this line.
	 */
	if( n_bits &&
		VIPS_TARGET_PUTC( ppm->target, bits ) ) 
		return( -1 );

	return( 0 );
}

static int
vips_foreign_save_ppm_block( VipsRegion *region, VipsRect *area, void *a )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) a;
	VipsImage *image = region->im;

	int y;

	for( y = 0; y < area->height; y++ ) {
		VipsPel *p = VIPS_REGION_ADDR( region, 0, area->top + y );

		if( ppm->fn( ppm, image, p ) )
			return( -1 );
	}

	return( 0 );
}

static int
vips_foreign_save_ppm_build( VipsObject *object )
{
	VipsForeignSave *save = (VipsForeignSave *) object;
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) object;
	VipsImage **t = (VipsImage **) vips_object_local_array( object, 2 );

	VipsImage *image;
	char *magic;
	char *date;
	VipsBandFormat target_format;
	VipsInterpretation target_interpretation;

	if( VIPS_OBJECT_CLASS( vips_foreign_save_ppm_parent_class )->
		build( object ) )
		return( -1 );

	image = save->ready;
	target_format = image->BandFmt;
	target_interpretation = image->Type;

	/* ppm types to set the defaults for bitdepth etc.
	 *
	 *   pbm ... 1 band 1 bit
	 *   pgm ... 1 band many bit
	 *   ppm ... 3 band many bit
	 *   pfm ... 1 or 3 bands, 32 bit
	 *   pnm ... pick from input
	 */
	switch( ppm->format ) {
	case VIPS_FOREIGN_PPM_FORMAT_PBM:
		if( !vips_object_argument_isset( object, "bitdepth" ) ) 
			ppm->bitdepth = 1;
		target_interpretation = VIPS_INTERPRETATION_B_W;
		break;

	case VIPS_FOREIGN_PPM_FORMAT_PGM:
		if( target_format == VIPS_FORMAT_USHORT )
			target_interpretation = VIPS_INTERPRETATION_GREY16;
		else
			target_interpretation = VIPS_INTERPRETATION_B_W;
		break;

	case VIPS_FOREIGN_PPM_FORMAT_PPM:
		if( target_format == VIPS_FORMAT_USHORT )
			target_interpretation = VIPS_INTERPRETATION_RGB16;
		else
			target_interpretation = VIPS_INTERPRETATION_sRGB;
		break;

	case VIPS_FOREIGN_PPM_FORMAT_PFM:
		target_format = VIPS_FORMAT_FLOAT;
		break;

	case VIPS_FOREIGN_PPM_FORMAT_PNM:
	default:
		/* Just use the input format and interpretation.
		 */
		break;
	}

	if( vips_cast( image, &t[0], target_format, NULL ) )
		return( -1 );
	image = t[0];

	if( image->Type != target_interpretation ) {
		if( vips_colourspace( image, &t[1], 
			target_interpretation, NULL ) )
			return( -1 );
		image = t[1];
	}

        /* Handle the deprecated squash parameter.
	 */
        if( vips_object_argument_isset( object, "squash" ) ) 
		ppm->bitdepth = 1;

	if( vips_check_uintorf( "vips2ppm", image ) || 
		vips_check_bands_1or3( "vips2ppm", image ) || 
		vips_check_uncoded( "vips2ppm", image ) || 
		vips_image_pio_input( image ) )
		return( -1 );

	if( ppm->ascii && 
		image->BandFmt == VIPS_FORMAT_FLOAT ) {
		g_warning( "%s", 
			_( "float images must be binary -- disabling ascii" ) );
		ppm->ascii = FALSE;
	}

	/* One bit images must come from a 8 bit, one band source. 
	 */
	if( ppm->bitdepth && 
		(image->Bands != 1 || 
		 image->BandFmt != VIPS_FORMAT_UCHAR) ) {
		g_warning( "%s", 
			_( "can only save 1 band uchar images as 1 bit -- " 
				"disabling 1 bit save" ) );
		ppm->bitdepth = 0; 
	}

	magic = "unset";
	if( image->BandFmt == VIPS_FORMAT_FLOAT && 
		image->Bands == 3 ) 
		magic = "PF";
	else if( image->BandFmt == VIPS_FORMAT_FLOAT && 
		image->Bands == 1 ) 
		magic = "Pf";
	else if( image->Bands == 1 && 
		ppm->ascii && 
		ppm->bitdepth )
		magic = "P1";
	else if( image->Bands == 1 && 
		ppm->ascii )
		magic = "P2";
	else if( image->Bands == 1 && 
		!ppm->ascii && 
		ppm->bitdepth )
		magic = "P4";
	else if( image->Bands == 1 && 
		!ppm->ascii )
		magic = "P5";
	else if( image->Bands == 3 && 
		ppm->ascii )
		magic = "P3";
	else if( image->Bands == 3 && 
		!ppm->ascii )
		magic = "P6";
	else
		g_assert_not_reached();

	vips_target_writef( ppm->target, "%s\n", magic );
	if( !save->strip ) {
		date = vips__get_iso8601();
		vips_target_writef( ppm->target, 
			"#vips2ppm - %s\n", date );
		g_free( date );
	}
	vips_target_writef( ppm->target, 
		"%d %d\n", image->Xsize, image->Ysize );

	if( !ppm->bitdepth ) 
		switch( image->BandFmt ) {
		case VIPS_FORMAT_UCHAR:
			vips_target_writef( ppm->target, 
				"%d\n", UCHAR_MAX );
			break;

		case VIPS_FORMAT_USHORT:
			vips_target_writef( ppm->target, 
				"%d\n", USHRT_MAX );
			break;

		case VIPS_FORMAT_UINT:
			vips_target_writef( ppm->target, 
				"%d\n", UINT_MAX );
			break;

		case VIPS_FORMAT_FLOAT:
{
			double scale;
			char buf[G_ASCII_DTOSTR_BUF_SIZE];

			scale = 1;
			if( vips_image_get_typeof( image, "pfm-scale" ) &&
				!vips_image_get_double( image, 
					"pfm-scale", &scale ) )
				;

			if( !vips_amiMSBfirst() )
				scale *= -1;
			/* Need to be locale independent.
			 */
			g_ascii_dtostr( buf, G_ASCII_DTOSTR_BUF_SIZE, scale );
			vips_target_writes( ppm->target, buf );
			vips_target_writes( ppm->target, "\n" );
}
			break;

		default:
			g_assert_not_reached();
		}

	if( ppm->bitdepth )
		ppm->fn = ppm->ascii ? 
			vips_foreign_save_ppm_line_ascii_1bit : 
			vips_foreign_save_ppm_line_binary_1bit;
	else
		ppm->fn = ppm->ascii ? 
			vips_foreign_save_ppm_line_ascii : 
			vips_foreign_save_ppm_line_binary;

	/* 16 and 32-bit binary write might need byteswapping.
	 */
	if( !ppm->ascii &&
		(image->BandFmt == VIPS_FORMAT_USHORT ||
		 image->BandFmt == VIPS_FORMAT_UINT) ) {
		VipsImage *x;

		if( vips__byteswap_bool( image, &x, !vips_amiMSBfirst() ) )
			return( -1 );
		image = x;

		/* image must now be unreffed on exit.
		 */
		vips_object_local( VIPS_OBJECT( ppm->target ), image );
	}

	if( vips_sink_disc( image, vips_foreign_save_ppm_block, ppm ) )
		return( -1 );

	if( vips_target_end( ppm->target ) )
		return( -1 );

	return( 0 );
}

/* Save a bit of typing.
 */
#define UC VIPS_FORMAT_UCHAR
#define C VIPS_FORMAT_CHAR
#define US VIPS_FORMAT_USHORT
#define S VIPS_FORMAT_SHORT
#define UI VIPS_FORMAT_UINT
#define I VIPS_FORMAT_INT
#define F VIPS_FORMAT_FLOAT
#define X VIPS_FORMAT_COMPLEX
#define D VIPS_FORMAT_DOUBLE
#define DX VIPS_FORMAT_DPCOMPLEX

static int bandfmt_ppm[10] = {
/* UC  C   US  S   UI  I   F   X   D   DX */
   UC, UC, US, US, UI, UI, F,  F,  F,  F
};

static void
vips_foreign_save_ppm_class_init( VipsForeignSavePpmClass *class )
{
	GObjectClass *gobject_class = G_OBJECT_CLASS( class );
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignSaveClass *save_class = (VipsForeignSaveClass *) class;

	gobject_class->dispose = vips_foreign_save_ppm_dispose;
	gobject_class->set_property = vips_object_set_property;
	gobject_class->get_property = vips_object_get_property;

	object_class->nickname = "ppmsave_base";
	object_class->description = _( "save to ppm" );
	object_class->build = vips_foreign_save_ppm_build;

	save_class->saveable = VIPS_SAVEABLE_RGB;
	save_class->format_table = bandfmt_ppm;

	VIPS_ARG_ENUM( class, "format", 2,
		_( "Format" ),
		_( "Format to save in" ),
		VIPS_ARGUMENT_OPTIONAL_INPUT,
		G_STRUCT_OFFSET( VipsForeignSavePpm, format ),
		VIPS_TYPE_FOREIGN_PPM_FORMAT, 
			VIPS_FOREIGN_PPM_FORMAT_PPM ); 

	VIPS_ARG_BOOL( class, "ascii", 10, 
		_( "ASCII" ), 
		_( "Save as ascii" ),
		VIPS_ARGUMENT_OPTIONAL_INPUT,
		G_STRUCT_OFFSET( VipsForeignSavePpm, ascii ),
		FALSE );

	VIPS_ARG_INT( class, "bitdepth", 15,
		_( "Bit depth" ),
		_( "Set to 1 to write as a 1 bit image" ),
		VIPS_ARGUMENT_OPTIONAL_INPUT,
		G_STRUCT_OFFSET( VipsForeignSavePpm, bitdepth ),
		0, 1, 0 );

	VIPS_ARG_BOOL( class, "squash", 11, 
		_( "Squash" ), 
		_( "Save as one bit" ),
		VIPS_ARGUMENT_OPTIONAL_INPUT | VIPS_ARGUMENT_DEPRECATED,
		G_STRUCT_OFFSET( VipsForeignSavePpm, squash ),
		FALSE );

}

static void
vips_foreign_save_ppm_init( VipsForeignSavePpm *ppm )
{
	ppm->format = VIPS_FOREIGN_PPM_FORMAT_PPM;
}

typedef struct _VipsForeignSavePpmFile {
	VipsForeignSavePpm parent_object;

	char *filename; 
} VipsForeignSavePpmFile;

typedef VipsForeignSavePpmClass VipsForeignSavePpmFileClass;

G_DEFINE_TYPE( VipsForeignSavePpmFile, vips_foreign_save_ppm_file, 
	vips_foreign_save_ppm_get_type() );

static int
vips_foreign_save_ppm_file_build( VipsObject *object )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) object;
	VipsForeignSavePpmFile *file = (VipsForeignSavePpmFile *) object;

	if( file->filename &&
		!(ppm->target = vips_target_new_to_file( file->filename )) )
		return( -1 );

	if( vips_iscasepostfix( file->filename, ".pbm" ) )
		ppm->format = VIPS_FOREIGN_PPM_FORMAT_PBM;
	else if( vips_iscasepostfix( file->filename, ".pgm" ) )
		ppm->format = VIPS_FOREIGN_PPM_FORMAT_PGM;
	else if( vips_iscasepostfix( file->filename, ".pfm" ) )
		ppm->format = VIPS_FOREIGN_PPM_FORMAT_PFM;
	else if( vips_iscasepostfix( file->filename, ".pnm" ) )
		ppm->format = VIPS_FOREIGN_PPM_FORMAT_PNM;

	return( VIPS_OBJECT_CLASS( vips_foreign_save_ppm_file_parent_class )->
		build( object ) );
}

static void
vips_foreign_save_ppm_file_class_init( VipsForeignSavePpmFileClass *class )
{
	GObjectClass *gobject_class = G_OBJECT_CLASS( class );
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;

	gobject_class->set_property = vips_object_set_property;
	gobject_class->get_property = vips_object_get_property;

	object_class->nickname = "ppmsave";
	object_class->description = _( "save image to ppm file" );
	object_class->build = vips_foreign_save_ppm_file_build;

	foreign_class->suffs = vips__ppm_suffs;

	VIPS_ARG_STRING( class, "filename", 1, 
		_( "Filename" ),
		_( "Filename to save to" ),
		VIPS_ARGUMENT_REQUIRED_INPUT, 
		G_STRUCT_OFFSET( VipsForeignSavePpmFile, filename ),
		NULL );

}

static void
vips_foreign_save_ppm_file_init( VipsForeignSavePpmFile *file )
{
}

typedef struct _VipsForeignSavePpmTarget {
	VipsForeignSavePpm parent_object;

	VipsTarget *target;
} VipsForeignSavePpmTarget;

typedef VipsForeignSavePpmClass VipsForeignSavePpmTargetClass;

G_DEFINE_TYPE( VipsForeignSavePpmTarget, vips_foreign_save_ppm_target, 
	vips_foreign_save_ppm_get_type() );

static int
vips_foreign_save_ppm_target_build( VipsObject *object )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) object;
	VipsForeignSavePpmTarget *target = 
		(VipsForeignSavePpmTarget *) object;

	if( target->target ) {
		ppm->target = target->target; 
		g_object_ref( ppm->target );
	}

	return( VIPS_OBJECT_CLASS( 
		vips_foreign_save_ppm_target_parent_class )->
			build( object ) );
}

static void
vips_foreign_save_ppm_target_class_init( 
	VipsForeignSavePpmTargetClass *class )
{
	GObjectClass *gobject_class = G_OBJECT_CLASS( class );
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;

	gobject_class->set_property = vips_object_set_property;
	gobject_class->get_property = vips_object_get_property;

	object_class->nickname = "ppmsave_target";
	object_class->build = vips_foreign_save_ppm_target_build;

	foreign_class->suffs = vips__save_ppm_suffs;

	VIPS_ARG_OBJECT( class, "target", 1,
		_( "Target" ),
		_( "Target to save to" ),
		VIPS_ARGUMENT_REQUIRED_INPUT, 
		G_STRUCT_OFFSET( VipsForeignSavePpmTarget, target ),
		VIPS_TYPE_TARGET );

}

static void
vips_foreign_save_ppm_target_init( VipsForeignSavePpmTarget *target )
{
}

typedef VipsForeignSavePpmTarget VipsForeignSavePbmTarget;
typedef VipsForeignSavePpmTargetClass VipsForeignSavePbmTargetClass;

G_DEFINE_TYPE( VipsForeignSavePbmTarget, vips_foreign_save_pbm_target, 
	vips_foreign_save_ppm_target_get_type() );

static void
vips_foreign_save_pbm_target_class_init( 
	VipsForeignSavePbmTargetClass *class )
{
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;
	VipsOperationClass *operation_class = (VipsOperationClass *) class;

	object_class->nickname = "pbmsave_target";
	object_class->description = _( "save image in pbm format" );

	foreign_class->suffs = vips__save_pbm_suffs;

	/* Hide from UI.
	 */
	operation_class->flags |= VIPS_OPERATION_DEPRECATED;
}

static void
vips_foreign_save_pbm_target_init( VipsForeignSavePbmTarget *target )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) target;

	ppm->format = VIPS_FOREIGN_PPM_FORMAT_PBM;
}

typedef VipsForeignSavePpmTarget VipsForeignSavePgmTarget;
typedef VipsForeignSavePpmTargetClass VipsForeignSavePgmTargetClass;

G_DEFINE_TYPE( VipsForeignSavePgmTarget, vips_foreign_save_pgm_target, 
	vips_foreign_save_ppm_target_get_type() );

static void
vips_foreign_save_pgm_target_class_init( 
	VipsForeignSavePgmTargetClass *class )
{
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;
	VipsOperationClass *operation_class = (VipsOperationClass *) class;

	object_class->nickname = "pgmsave_target";
	object_class->description = _( "save image in pgm format" );

	foreign_class->suffs = vips__save_pgm_suffs;

	/* Hide from UI.
	 */
	operation_class->flags |= VIPS_OPERATION_DEPRECATED;
}

static void
vips_foreign_save_pgm_target_init( VipsForeignSavePgmTarget *target )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) target;

	ppm->format = VIPS_FOREIGN_PPM_FORMAT_PGM;
}

typedef VipsForeignSavePpmTarget VipsForeignSavePfmTarget;
typedef VipsForeignSavePpmTargetClass VipsForeignSavePfmTargetClass;

G_DEFINE_TYPE( VipsForeignSavePfmTarget, vips_foreign_save_pfm_target, 
	vips_foreign_save_ppm_target_get_type() );

static void
vips_foreign_save_pfm_target_class_init( 
	VipsForeignSavePfmTargetClass *class )
{
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;
	VipsOperationClass *operation_class = (VipsOperationClass *) class;

	object_class->nickname = "pfmsave_target";
	object_class->description = _( "save image in pfm format" );

	foreign_class->suffs = vips__save_pfm_suffs;

	/* Hide from UI.
	 */
	operation_class->flags |= VIPS_OPERATION_DEPRECATED;
}

static void
vips_foreign_save_pfm_target_init( VipsForeignSavePfmTarget *target )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) target;

	ppm->format = VIPS_FOREIGN_PPM_FORMAT_PFM;
}

typedef VipsForeignSavePpmTarget VipsForeignSavePnmTarget;
typedef VipsForeignSavePpmTargetClass VipsForeignSavePnmTargetClass;

G_DEFINE_TYPE( VipsForeignSavePnmTarget, vips_foreign_save_pnm_target, 
	vips_foreign_save_ppm_target_get_type() );

static void
vips_foreign_save_pnm_target_class_init( 
	VipsForeignSavePfmTargetClass *class )
{
	VipsObjectClass *object_class = (VipsObjectClass *) class;
	VipsForeignClass *foreign_class = (VipsForeignClass *) class;
	VipsOperationClass *operation_class = (VipsOperationClass *) class;

	object_class->nickname = "pnmsave_target";
	object_class->description = _( "save image in pnm format" );

	foreign_class->suffs = vips__save_pnm_suffs;

	/* Hide from UI.
	 */
	operation_class->flags |= VIPS_OPERATION_DEPRECATED;
}

static void
vips_foreign_save_pnm_target_init( VipsForeignSavePfmTarget *target )
{
	VipsForeignSavePpm *ppm = (VipsForeignSavePpm *) target;

	ppm->format = VIPS_FOREIGN_PPM_FORMAT_PNM;
}

#endif /*HAVE_PPM*/

/**
 * vips_ppmsave: (method)
 * @in: image to save 
 * @filename: file to write to
 * @...: %NULL-terminated list of optional named arguments
 *
 * Optional arguments:
 *
 * * @format: #VipsForeignPpmFormat, format to save in
 * * @ascii: %gboolean, save as ASCII rather than binary
 * * @bitdepth: %gint, bitdepth to save at
 *
 * Write a VIPS image to a file as PPM. It can write 1, 8, 16 or
 * 32 bit unsigned integer images, float images, colour or monochrome, 
 * stored as binary or ASCII. 
 * Integer images of more than 8 bits can only be stored in ASCII.
 *
 * When writing float (PFM) images the scale factor is set from the 
 * "pfm-scale" metadata.
 *
 * Set @ascii to %TRUE to write as human-readable ASCII. Normally data is
 * written in binary. 
 *
 * Set @bitdepth to 1 to write a one-bit image.
 *
 * @format defaults to the sub-type for this filename suffix.
 *
 * See also: vips_image_write_to_file().
 *
 * Returns: 0 on success, -1 on error.
 */
int
vips_ppmsave( VipsImage *in, const char *filename, ... )
{
	va_list ap;
	int result;

	va_start( ap, filename );
	result = vips_call_split( "ppmsave", ap, in, filename );
	va_end( ap );

	return( result );
}

/**
 * vips_ppmsave_target: (method)
 * @in: image to save 
 * @target: save image to this target
 * @...: %NULL-terminated list of optional named arguments
 *
 * Optional arguments:
 *
 * * @format: #VipsForeignPpmFormat, format to save in
 * * @ascii: %gboolean, save as ASCII rather than binary
 * * @bitdepth: %gint, bitdepth to save at
 *
 * As vips_ppmsave(), but save to a target.
 *
 * See also: vips_ppmsave().
 *
 * Returns: 0 on success, -1 on error.
 */
int
vips_ppmsave_target( VipsImage *in, VipsTarget *target, ... )
{
	va_list ap;
	int result;

	va_start( ap, target );
	result = vips_call_split( "ppmsave_target", ap, in, target );
	va_end( ap );

	return( result );
}
