ftp.nice.ch/pub/next/unix/graphics/imtools.2.0.N.bs.tar.gz#/imtools/src/imscale.c

This is imscale.c in view mode; [Download] [Up]

/**
 **	$Header: /import/dev-vis/image/imtools/v2.0/imtools/src/RCS/imscale.c,v 1.1 91/10/03 13:20:03 nadeau Exp $
 **	Copyright (c) 1989, 1990  San Diego Supercomputer Center (SDSC)
 **		San Diego, California, USA
 **
 **	Users and possessors of this source code are hereby granted a
 **	nonexclusive, royalty-free copyright and design patent license to
 **	use this code in individual software.  License is not granted for
 **	commercial resale, in whole or in part, without prior written
 **	permission from SDSC.  This source is provided "AS IS" without express
 **	or implied warranty of any kind.
 **
 **	For further information contact:
 **		E-Mail:		info@sds.sdsc.edu
 **
 **		Surface Mail:	Information Center
 **				San Diego Supercomputer Center
 **				P.O. Box 85608
 **				San Diego, CA  92138-5608
 **				(619) 534-5000
 **/

#define HEADER	"    $Header: /import/dev-vis/image/imtools/v2.0/imtools/src/RCS/imscale.c,v 1.1 91/10/03 13:20:03 nadeau Exp $"

/**
 **  FILE
 **	imscale.c	-  Copy a part of an image
 **
 **  PROJECT
 **	IM		-  Image Manipulation Tools
 **
 **  DESCRIPTION
 **	imscale copies a piece of an image into a new file.
 **
 **  PUBLIC CONTENTS
 **			d =defined constant
 **			f =function
 **			m =defined macro
 **			t =typedef/struct/union
 **			v =variable
 **			? =other
 **
 **	main		f  main program
 **
 **  PRIVATE CONTENTS
 **	toolCommand	v  tool-specific tool info
 **	toolHelp	v  tool-specific help
 **	toolOptions	v  tool-specific options
 **	toolEquivs	v  tool-specific equivalent keywords
 **
 **	toolInFilename	v  the name of the input file (could be 'stdin')
 **	toolOutFilename	v  the name of the output file (could be 'stdout')
 **
 **	toolInFormat	v  the name of the input file's format (could be '\0')
 **	toolOutFormat	v  the name of the output file's format (could be '\0')
 **
 **	toolInTable	v  a table for the storage of data read in
 **	toolFlagsTable	v  a table for the storage of read/write flags
 **
 **	toolXScale	v  X scale factor
 **	toolYScale	v  Y scale factor
 **	toolXSize	v  X desired size
 **	toolYSize	v  Y desired size
 **
 **	toolInit	f  initialize things for the tool
 **	toolPromoteRgb	f  promote an image to RGB
 **	toolDemoteRgb	f  demote an image from RGB
 **
 **  HISTORY
 **	$Log:	imscale.c,v $
 **	Revision 1.1  91/10/03  13:20:03  nadeau
 **	Initial revision
 **	
 **
 **/

#include "imtools.h"


extern void   toolInit( );		/* Initialize things		*/
extern ImVfb *toolPromoteRgb( );	/* Promote to RGB		*/
extern ImVfb *toolDemoteRgb( );		/* Demote from RGB		*/





/*
 *  GLOBALS
 *	toolCommand		-  tool-specific tool info
 *	toolHelp		-  tool-specific help
 *	toolOptions		-  tool-specific options
 *	toolEquivs		-  tool-specific equivalent keywords
 *
 *  DESCRIPTION
 *	toolCommand describes the command to the arg package.
 *
 *	toolHelp is the tool-specific help for the tool.  It will be
 *	concatenated with the generic image tools help message and
 *	added to the toolCommand structure as the help string to be
 *	printed after the option listing.
 *
 *	toolOptions is the tool-specific option list.  It will be merged
 *	with the generic image tools options, and the list of image file
 *	format names supported by the library.  This larger option list
 *	is then used as the list of options supported by the tool.
 *
 *	toolEquivs is the tool-specific option equivalent keyword list.
 *	It will be merged with the generic image tools equivs.  This large
 *	equivs list is then used as the list of equivs supported by the tool.
 */

private ArgCommand toolCommand =
{
	/* command name */		"imscale",

	/* major version # */		IMTOOLSMAJOR,
	/* minor version # */		IMTOOLSMINOR,
	/* subminor version # */	IMTOOLSSUBMINOR,

	/* -help pre-option list information				*/
"%command scales input images by a selected scale factor, or scales them\n\
up or down to a desired size.  Input and output files may have different\n\
image file formats.\n\
",
	/* -help post-option list information				*/
	NULL,				/* filled in later on		*/

	/* -fullhelp pre-option list information			*/
	NULL,				/* Use same message as for -help*/
	/* -fullhelp post-option list information			*/
	NULL,				/* filled in later on		*/

	ARGFNONE,			/* No special flags		*/
	"[options...] infilename outfilename",
	"[options...] infilename outfilename",
	"SDSC Image Tools, October 1991.",
	"Copyright (c) 1989-1991  San Diego Supercomputer Center (SDSC), CA, USA",
	NULL,				/* filled in later on		*/
	NULL,				/* filled in later on		*/
};

private char *toolHelp = "\n\
Typical Invocations:\n\
    Scale a 640x480 image up to 1280x1024 (non-uniform scaling):\n\
        %command small.pix -xscale 2.0 -yscale 2.133 large.pix\n\
        %command small.pix -xsize 1280 -ysize 1024 large.pix\n\
    Reduce an image to 1/3 its original size:\n\
        %command large.pix -xscale 0.33 -yscale 0.33 small.pix\n\
";

private char *toolFullHelp = "\n\
Files:\n\
    -infile selects the file whose images are to be scaled.  -outfile\n\
    selects the file into which to write the resulting scaled images.  The\n\
    input file is unaltered.\n\
\n\
Image Resizing:\n\
    -xscale and -yscale specify floating point scale factors.  To increase\n\
    the size of an image, use a scale factor greater than 1.0.  To decrease\n\
    an image's size, use a scale factor less than 1.0.  Default is 1.0.\n\
\n\
    -xsize and -ysize specify desired image size in pixels.  The scale factor\n\
    needed to enlarge or reduce the incomming image to the desired size is\n\
    automatically computed and applied.  Default is the input image size.\n\
\n\
    -xsize, -ysize, -xscale, and -yscale may be used together as long as at\n\
    most one of -xsize and -xscale are used, and at most one of -ysize and\n\
    -yscale are used.\n\
\n\
    Scaling uses bi-linear interpolation.\n\
";

private char *toolNote = "\n\
Additional Help:\n\
    This is an abbreviated help listing.  For a full listing of options,\n\
    including a list of image file formats supported, type:\n\
        %command -fullhelp\n\
";

#define TOOLNOPTIONS	7
private ArgOption toolOptions[TOOLNOPTIONS] =
{
	{ "infile", "image_filename", "Specify an input image file name",
	  ARGFREQUIRED | ARGFIMPKEYWORD, 1, 1, ARGTSTRING },

	{ "outfile", "image_filename", "Specify an output image file name",
	  ARGFREQUIRED | ARGFIMPKEYWORD, 1, 1, ARGTSTRING },

	{ "xscale", "x", "Specify X scale factor",
	  ARGFNONE, 1, 1, ARGTFLOAT },

	{ "yscale", "y", "Specify Y scale factor",
	  ARGFNONE, 1, 1, ARGTFLOAT },

	{ "xsize", "x", "Specify desired width in pixels",
	  ARGFNONE, 1, 1, ARGTINT },

	{ "ysize", "y", "Specify desired height in pixels",
	  ARGFNONE, 1, 1, ARGTINT },

	{ "verbose", NULL, "Be verbose",
	  ARGFFULLHELP, 0, 0, ARGTNONE },
};

#define TOOLNEQUIVS	0
#if TOOLNEQUIVS == 0
private ArgEquiv *toolEquivs;
#else
private ArgEquiv toolEquivs[TOOLNEQUIVS] =
{
};
#endif





/*
 *  GLOBALS
 *	toolInFilename	-  the name of the input file (could be 'stdin')
 *	toolOutFilename	-  the name of the output file (could be 'stdout')
 *
 *	toolInFormat	-  the name of the input file's format (could be NULL)
 *	toolOutFormat	-  the name of the output file's format (could be NULL)
 *
 *	toolInTable	-  a table for the storage of data read in
 *	toolFlagsTable	-  a table for the storage of read/write flags
 *
 *	toolXScale	-  X scale factor
 *	toolYScale	-  Y scale factor
 *	toolXSize	-  X desired size
 *	toolYSize	-  Y desired size
 *
 *  DESCRIPTION
 *	Data held by these variables is used throughout the tool.
 */

private char      toolInFilename[1024];	/* Input file name		*/
private char      toolInFormat[1024];	/* Input file's format name	*/

private char      toolOutFilename[1024];/* Output file name		*/
private char      toolOutFormat[1024];	/* Output file's format name	*/

private TagTable *toolInTable;	/* Data tag table		*/
private TagTable *toolFlagsTable;	/* Flags tag table		*/

private float	  toolXScale;		/* X Position			*/
private float	  toolYScale;		/* Y Position			*/
private int	  toolXSize;		/* Width			*/
private int	  toolYSize;		/* Height			*/





/*
 *  FUNCTION
 *	main	-  main program
 *
 *  DESCRIPTION
 *	Control things:
 *		-  Initialize things (parse arguments and set up tables).
 *		-  Read in the input file (put data into data table).
 *		-  Copy part of each image.
 *		-  Replace the data table images with their smaller copy pieces.
 *		-  Write out the output file (get data from data table).
 *	That's about it.
 *
 *  NOTES
 *	This 'main' is pretty much the same for each of the image tools.
 *	Differences between tools include:
 *		-  the number of input files read in
 *		-  the number of output files written out
 *		-  the actions taken on the data between read and write
 */

main( argc, argv )
	int argc;			/* Argument count		*/
	char *argv[];			/* Argument vector		*/
{
	int         nInVfb;		/* Number of images in file	*/
	int         i;			/* Counter			*/

	TagEntry   *dataEntry;		/* Entry from data table	*/

	ImVfb      *srcVfb;		/* Source image			*/
	ImVfb	   *srcRgbVfb;		/* Temporary RGB image		*/
	int         srcFields;		/* Source image's fields	*/
	int         srcRgbFields;	/* RGB source image's fields	*/
	int	    srcW, srcH;		/* Source image dimensions	*/
	ImVfb      *dstVfb;		/* Desintation image		*/
	ImVfb	   *dstRgbVfb;		/* Temporary RGB image		*/
	int	    xsize, ysize;	/* New image resolution		*/


	/*
	 *  Initialize things:
	 *	-  Prepare the arg parsing data, then parse the command-line.
	 *	-  Prepare the flags table based upon command-line args.
	 *	-  Determine the file formats for input and output files.
	 */
	toolInit( argc, argv );


	/*
	 *  Read in the input file.
	 *	-  Open the file (or stdin) and read data into the data table.
	 */
	ImToolsFileRead( toolInFilename, toolInFormat, toolFlagsTable,
		toolInTable );


	/*
	 *  Check for errors
	 *	-  no input images
	 */
	nInVfb = TagTableQNEntry( toolInTable, "image vfb" );
	if ( nInVfb == 0 )
	{
		fprintf( stderr, "%s: Input file contains no images!\n",
			ImToolsProgram );
		exit( 1 );
	}


	/*
	 *  Scale!
	 *	-  Walk the data table looking for images.  For each one found,
	 *	   get the VFB, resize it, and replace the original with the
	 *	   resized image back in the same data table.
	 *
	 *  Watch for two special cases:
	 *	-  The source image is not an RGB image.  ImVfbResize()
	 *	   interpolates pixel values.  For RGB images this produces
	 *	   new intermediary colors.  For color index and monochrome
	 *	   images this creates new color indexes, which may correspond
	 *	   to CLT entries that don't have the right color.  To create
	 *	   a good image from a non-RGB source, we first promote the
	 *	   image to RGB.  In order to cause predictable output casting
	 *	   operations for file format output, we then demote the RGB
	 *	   image back to the same image type as the source.
	 *
	 *	-  The source image has additional fields besides just color
	 *	   (such as alpha or Z-buffer).  Intermediate images must
	 *	   have these fields as well, and the too must be resized.
	 */
	for ( i = 0; i < nInVfb; i++ )
	{
		/*
		 *  Get the next image out of the data table.
		 */
		dataEntry = TagTableQDirect( toolInTable, "image vfb", i );
		TagEntryQValue( dataEntry, &srcVfb );
		srcW         = ImVfbQWidth( srcVfb );
		srcH         = ImVfbQHeight( srcVfb );
		srcFields    = ImVfbQFields( srcVfb );
		srcRgbFields = (srcFields & (~IMVFBIMAGEMASK)) | IMVFBRGB;


		/*
		 *  Determine the X and Y scale factors to use.
		 */
		if ( toolXSize == -1 )
			xsize = toolXScale * srcW;
		else
			xsize = toolXSize;
		if ( toolYSize == -1 )
			ysize = toolYScale * srcH;
		else
			ysize = toolYSize;


		/*
		 *  If the source image is not RGB, then promote it to RGB
		 *  so that the resize will interpolate colors, rather than
		 *  color table indexes.  Maintain all non-image fields and
		 *  their data.
		 */
		srcRgbVfb = toolPromoteRgb( srcVfb );
		if ( srcRgbVfb == IMVFBNULL )
		{
			ImPError( ImToolsProgram );
			fprintf( stderr, "%s: Couldn't create temporary RGB image for image %d of %d.\n",
				ImToolsProgram, i + 1, nInVfb );
			fprintf( stderr, "%s: Full size original image placed into output file.\n",
				ImToolsProgram );
			continue;
		}


		/*
		 *  Make a new dstination image of the right size, and with
		 *  the same fields as the original (RGB version).
		 */
		dstRgbVfb = ImVfbAlloc( xsize, ysize, srcRgbFields );
		if ( dstRgbVfb == IMVFBNULL )
		{
			ImPError( ImToolsProgram );
			fprintf( stderr, "%s: Couldn't create temporary RGB image for image %d of %d.\n",
				ImToolsProgram, i + 1, nInVfb );
			fprintf( stderr, "%s: Full size original image placed into output file.\n",
				ImToolsProgram );
			if ( srcVfb != srcRgbVfb )
				ImVfbFree( srcRgbVfb );
			continue;
		}


		/*
		 *  Resize the RGB image.
		 */
		if ( ImToolsVerbose )
			fprintf( stderr, "%s: Resizing image to %d X %d for image %d of %d\n",
				ImToolsProgram, xsize, ysize, i + 1, nInVfb );

		dstVfb = ImVfbResize( srcRgbVfb,	/* Use this VFB*/
			IMVFBBILINEAR,			/* Interpolate	*/
			dstRgbVfb,			/* Put it here	*/
			xsize, ysize );			/* Make it this big*/
		if ( dstVfb == IMVFBNULL )
		{
			ImPError( ImToolsProgram );
			fprintf( stderr, "%s: Couldn't resize for image %d of %d.\n",
				ImToolsProgram, i + 1, nInVfb );
			fprintf( stderr, "%s: Full size original image placed into output file.\n",
				ImToolsProgram );
			if ( srcVfb != srcRgbVfb )
				ImVfbFree( srcRgbVfb );
			ImVfbFree( dstRgbVfb );
			continue;
		}


		/*
		 *  If the source image was not RGB, demote the resized
		 *  image to the same image type.  Be careful to maintain
		 *  extra non-image fields, if any.
		 */
		dstVfb = toolDemoteRgb( dstRgbVfb, srcFields );
		if ( dstVfb == IMVFBNULL )
		{
			ImPError( ImToolsProgram );
			fprintf( stderr, "%s: Couldn't create temporary RGB image for image %d of %d.\n",
				ImToolsProgram, i + 1, nInVfb );
			fprintf( stderr, "%s: Full size original image placed into output file.\n",
				ImToolsProgram );
			if ( srcVfb != srcRgbVfb )
				ImVfbFree( srcRgbVfb );
			ImVfbFree( dstRgbVfb );
			continue;
		}
		if ( (srcFields & IMVFBINDEX8) && ImVfbQClt( srcVfb)==IMCLTNULL)
		{
			/*
			 *  Source was grayscale (no CLT).  Convert the
			 *  new image to grayscale and remove its CLT.
			 */
			if ( ImVfbToGray( dstVfb, dstVfb ) == IMVFBNULL )
			{
				ImPError( ImToolsProgram );
				fprintf( stderr, "%s: Couldn't post-process image for image %d of %d.\n",
					ImToolsProgram, i + 1, nInVfb );
				fprintf( stderr, "%s: Full size original image placed into output file.\n",
					ImToolsProgram );
				if ( srcVfb != srcRgbVfb )
					ImVfbFree( srcRgbVfb );
				ImVfbFree( dstRgbVfb );
				continue;
			}
			ImCltFree( ImVfbQClt( dstVfb ) );
			ImVfbSClt( dstVfb, IMCLTNULL );
		}


		/*
		 *  Replace the source image with the destination image in the
		 *  same data table.
		 */
		TagTableReplace( toolInTable,
			TagEntryQNthEntry( dataEntry ),
			TagEntryAlloc( "image vfb", POINTER, &dstVfb ));


		/*
		 *  Destroy the extra VFBs.
		 */
		ImVfbFree( srcVfb );
		ImVfbFree( srcRgbVfb );
		if ( dstVfb != dstRgbVfb )
			ImVfbFree( dstRgbVfb );
	}


	/*
	 *  Write out the output file.
	 *	-  Open the file (or stdout) and write the data in the data
	 *	   table.  Upon failure, remove the bad output file.
	 */
	ImToolsFileWrite( toolOutFilename, toolOutFormat, toolFlagsTable,
		toolInTable );


	exit( 0 );
}





/*
 *  FUNCTION
 *	toolInit	-  initialize things for the tool
 *
 *  DESCRIPTION
 *	The tool's argument parsing data structures are set up to include:
 *		- the full help message (generic help + tool-specific help)
 *		- the full option list (generic options + tool-specific options)
 *		- the full equivs list (generic equivs + tool-specific equivs)
 *
 *	Command-line arguments are then parsed.  The results are used to
 *	set up the flags table (the generic -out* options).
 *
 *	Input and output file's names and formats are determined from the
 *	command-line arguments.
 *
 *  NOTES
 *	This function is included in most of the image tools and differs
 *	only in slight ways.  Typical differences include:
 *		-  the number of input and output file names found
 *		-  the number of input and output file formats found
 *		-  the number of command-line arg flags checked for
 */

private void				/* Returns nothing		*/
toolInit( argc, argv )
	int argc;			/* Argument count		*/
	char *argv[ ];			/* Argument vector		*/
{
	int	    i;			/* Counter			*/
	int	    noccur;		/* Number of option occurrences	*/
	int         nOpt;		/* Number of options		*/
	int         nEquiv;		/* Number of equivalences	*/
	ArgOption  *options1;		/* Argument options		*/
	ArgOption  *options;		/* Argument options		*/
	ArgEquiv   *equivs1;		/* Argument equivalent keywords	*/
	ArgEquiv   *equivs;		/* Argument equivalent keywords	*/

	char       *tmp;		/* Temporary string holder	*/
	char       *tmpFormat;		/* Tmp format name		*/


	/*
	 *  Save the name of the program, as invoked.
	 */
	ImToolsProgram = argv[0];


	/*
	 *  Make a data table to hold the incomming data.
	 */
	if ( (toolInTable = TagTableAlloc( )) == TAGTABLENULL )
	{
		TagPError( ImToolsProgram );
		exit( 1 );
	}


	/*
	 *  Use the standard Image Tools user registration and feedback forms.
	 */
	toolCommand.arg_register = ImToolsRegister;
	toolCommand.arg_feedback = ImToolsFeedback;


	/*
	 *  Allocate space for the total help string for the tool.  Copy the
	 *  tool-specific help in, then concatenate on the generic help text
	 *  used by most of the image tools.
	 */
	if ( (tmp = (char *)malloc( sizeof( char ) * (strlen( toolNote ) +
		strlen( toolHelp ) + 1) )) == NULL )
	{
		perror( ImToolsProgram );
		exit( 1 );
	}
	strcpy( tmp, toolHelp );
	strcat( tmp, toolNote );
	toolCommand.arg_help2 = tmp;

	if ( (tmp = (char *)malloc( sizeof( char ) * (strlen( ImToolsBaseHelp) +
		strlen( toolHelp ) + strlen( toolFullHelp ) + 1) )) == NULL )
	{
		perror( ImToolsProgram );
		exit( 1 );
	}
	strcpy( tmp, toolHelp );
	strcat( tmp, toolFullHelp );
	strcat( tmp, ImToolsBaseHelp );
	toolCommand.arg_fullhelp2 = tmp;


	/*
	 *  Build up an option list by merging the tool-specific options,
	 *  the standard (base) tool options, and those for the various
	 *  image file formats.
	 */
	nOpt = ImToolsMergeOptions( TOOLNOPTIONS, toolOptions,
		IMTOOLSNBASEOPTIONS, ImToolsBaseOptions, &options1 );
	if ( (nOpt = ImFileFormatOptions( nOpt, options1, &options )) == -1)
	{
		ImPError( ImToolsProgram );
		exit( 1 );
	}


	/*
	 *  Build up an equivalent keyword list by merging the tool-specific
	 *  equivalences, the standard (base) tool equivalences, and those
	 *  for the various image file formats.
	 */
	nEquiv = ImToolsMergeEquivs( TOOLNEQUIVS, toolEquivs,
		 IMTOOLSNBASEEQUIVS, ImToolsBaseEquivs, &equivs1 );
	if ( (nEquiv = ImFileFormatEquivs( nEquiv, equivs1, &equivs )) == -1)
	{
		ImPError( ImToolsProgram );
		exit( 1 );
	}


	/*
	 *  Parse the command line!
	 */
	nOpt = ArgParse( argc, argv, &toolCommand, nOpt, options,
		nEquiv, equivs );
	if ( ArgQNOccur( "verbose" ) != 0 )
		ImToolsVerbose = TRUE;


	/*
	 *  Get the image scale and size selections.
	 */
	toolXSize = toolYSize = -1;
	if ( ArgQNOccur( "xsize" ) != 0 )
	{
		toolXSize = ArgQValue( "xsize", 0, 0 )->arg_i;
		if ( toolXSize <= 0 )
		{
			fprintf( stderr, "%s: -xsize must be positive\n",
				ImToolsProgram );
			exit( 1 );
		}
	}
	if ( ArgQNOccur( "ysize" ) != 0 )
	{
		toolYSize = ArgQValue( "ysize", 0, 0 )->arg_i;
		if ( toolYSize <= 0 )
		{
			fprintf( stderr, "%s: -ysize must be positive\n",
				ImToolsProgram );
			exit( 1 );
		}
	}
	toolXScale = toolYScale = 1.0;
	if ( ArgQNOccur( "xscale" ) != 0 )
	{
		toolXScale = ArgQValue( "xscale", 0, 0 )->arg_f;
		if ( toolXScale <= 0.0 )
		{
			fprintf( stderr, "%s: -xscale must be greater than zero\n",
				ImToolsProgram );
			exit( 1 );
		}
		if ( toolXSize != -1 )
		{
			fprintf( stderr, "%s: only one of -xscale or -xsize may be given at a time\n",
				ImToolsProgram );
			exit( 1 );
		}
	}
	if ( ArgQNOccur( "yscale" ) != 0 )
	{
		toolYScale = ArgQValue( "yscale", 0, 0 )->arg_f;
		if ( toolYScale <= 0.0 )
		{
			fprintf( stderr, "%s: -yscale must be greater than zero\n",
				ImToolsProgram );
			exit( 1 );
		}
		if ( toolYSize != -1 )
		{
			fprintf( stderr, "%s: only one of -yscale or -ysize may be given at a time\n",
				ImToolsProgram );
			exit( 1 );
		}
	}


	/*
	 *  Set up the flags table based upon command-line arguments.
	 *  This is primarily derived from the -out* directives part of the
	 *  standard image tool option set (see ImToolsBaseOptions above).
	 *  Also included are flags to direct error messages to stderr and
	 *  a flag giving the program's name for later use in error messages.
	 */
	toolFlagsTable = ImToolsBuildFlagsTable( );


	/*
	 *  Get the input file's name (-infile), and search backwards in the
	 *  command-line option list to find the last format selection (if
	 *  any).  Stop the search on the beginning of the command-line, or
	 *  on -outfile.
	 */
	strcpy( toolInFilename, ArgQValue( "infile", 0, 0 )->arg_s );
	tmpFormat = NULL;
	for ( i = ArgQOccurOpt( "infile", 0 ) - 1; i >= 0; i-- )
	{
		tmp = ArgQOpt( i, &noccur );


		/*
		 *  Stop looking backward when we reach any other file name
		 *  argument.
		 */
		if ( strcmp( tmp, "outfile" ) == 0 )
			break;


		/*
		 *  Skip it if it isn't the name of a file format.
		 */
		if ( !ImToolsIsFormat( tmp ) )
			continue;


		if ( tmpFormat != NULL )
		{
			fprintf( stderr, "%s:  Only 1 file format selection may precede -infile.\n",
				ImToolsProgram );
			exit( 1 );
		}
		tmpFormat = tmp;
	}
	if ( tmpFormat == NULL )
		*toolInFormat = '\0';
	else
		strcpy( toolInFormat, tmpFormat );


	/*
	 *  Get the output file's name (-outfile), and search backwards in the
	 *  command-line option list to find the last format selection (if
	 *  any).  Stop the search on the beginning of the command-line, or
	 *  on -infile.
	 */
	strcpy( toolOutFilename, ArgQValue( "outfile", 0, 0 )->arg_s );
	tmpFormat = NULL;
	for ( i = ArgQOccurOpt( "outfile", 0 ) - 1; i >= 0; i-- )
	{
		tmp = ArgQOpt( i, &noccur );


		/*
		 *  Stop looking backward when we reach any other file name
		 *  argument.
		 */
		if ( strcmp( tmp, "infile" ) == 0 )
			break;


		/*
		 *  Skip it if it isn't the name of a file format.
		 */
		if ( !ImToolsIsFormat( tmp ) )
			continue;


		if ( tmpFormat != NULL )
		{
			fprintf( stderr, "%s:  Only 1 file format selection may precede -outfile.\n",
				ImToolsProgram );
			exit( 1 );
		}
		tmpFormat = tmp;
	}
	if ( tmpFormat == NULL )
		*toolOutFormat = '\0';
	else
		strcpy( toolOutFormat, tmpFormat );
}





/*
 *  FUNCTION
 *	toolPromoteRgb	-  promote an image to RGB
 *
 *  DESCRIPTION
 *	An incomming image is promoted, if necessary, to an RGB image with
 *	the same non-image fields (and their data) as the incomming image.
 */

private ImVfb *				/* Returns new RGB image	*/
toolPromoteRgb( srcVfb )
	ImVfb *srcVfb;			/* Image to turn into RGB	*/
{
	int srcFields;			/* Field mask of source image	*/
	int srcRgbFields;		/* New RGB image's fields	*/
	ImVfb *srcRgbVfb;		/* New RGB VFB			*/
	int srcW, srcH;			/* Source dimensions		*/


	/*
	 *  If the source image is already RGB, just return it.
	 */
	srcFields = ImVfbQFields( srcVfb );
	if ( srcFields & IMVFBRGB )
		return ( srcVfb );


	/*
	 *  If the source image doesn't have any non-image fields, such as
	 *  an alpha plane or Z-buffer, just convert it to a new VFB and
	 *  return the new VFB.
	 */
	if ( (srcFields & (~IMVFBIMAGEMASK)) == 0 )
		return ( ImVfbToRgb( srcVfb, IMVFBNEW ) );


	/*
	 *  The source image has "extra" fields not associated with image data.
	 *  We need to allocate a new VFB with an RGB image field, as well as
	 *  the other non-image fields from the source.
	 *
	 *  The source's non-image field data must then be copied into the new
	 *  VFB, and the source's image fields promoted to RGB data.
	 */
	srcW = ImVfbQWidth( srcVfb );
	srcH = ImVfbQHeight( srcVfb );
	srcRgbFields = (srcFields & (~IMVFBIMAGEMASK)) | IMVFBRGB;

	srcRgbVfb = ImVfbAlloc( srcW, srcH, srcRgbFields );
	if ( srcRgbVfb == IMVFBNULL )
		return ( IMVFBNULL );

	if ( ImVfbCopy( srcVfb,
		0, 0, srcW, srcH, srcFields & (~IMVFBIMAGEMASK),
		srcRgbVfb, 0, 0 ) == IMVFBNULL )
	{
		ImVfbFree( srcRgbVfb );
		return ( IMVFBNULL );
	}

	if ( ImVfbToRgb( srcVfb, srcRgbVfb ) == IMVFBNULL )
	{
		ImVfbFree( srcRgbVfb );
		return ( IMVFBNULL );
	}

	return ( srcRgbVfb );
}





/*
 *  FUNCTION
 *	toolDemoteRgb	-  demote an image from RGB
 *
 *  DESCRIPTION
 *	The incomming image is demoted to the given field type and returned.
 */

private ImVfb *				/* Returns demoted VFB		*/
toolDemoteRgb( srcVfb, dstFields )
	ImVfb *srcVfb;			/* Image to demote		*/
	int    dstFields;		/* Desired fields		*/
{
	int srcFields;			/* Field mask of source image	*/
	int srcW, srcH;			/* Source dimensions		*/
	ImVfb *dstVfb;			/* New destination VFB		*/
	ImVfb *tmpVfb;			/* Temporary VFB pointer holder	*/


	/*
	 *  If the source image already has the desired fields, just return
	 *  the source image.
	 */
	if ( ImVfbQFields( srcVfb ) == dstFields )
		return ( srcVfb );


	/*
	 *  If the destination fields include non-image fields, make a new
	 *  VFB and copy those non-image fields to it.
	 */
	if ( dstFields & (~IMVFBIMAGEMASK) )
	{
		srcW = ImVfbQWidth( srcVfb );
		srcH = ImVfbQHeight( srcVfb );

		dstVfb = ImVfbAlloc( srcW, srcH, dstFields );
		if ( dstVfb == IMVFBNULL )
			return ( IMVFBNULL );

		if ( ImVfbCopy( srcVfb,
			0, 0, srcW, srcH, dstFields & (~IMVFBIMAGEMASK),
			dstVfb, 0, 0 ) == IMVFBNULL )
		{
			ImVfbFree( dstVfb );
			return ( IMVFBNULL );
		}
	}
	else
		dstVfb = IMVFBNEW;


	/*
	 *  Convert the image to the desired image type.
	 */
	switch ( dstFields & IMVFBIMAGEMASK )
	{
	case IMVFBMONO:
		tmpVfb = ImVfbToMono( srcVfb, 127, dstVfb );
		break;

	case IMVFBINDEX8:
		tmpVfb = ImVfbToIndex8( srcVfb, dstVfb );
		break;

	case IMVFBINDEX16:
		tmpVfb = ImVfbToIndex16( srcVfb, dstVfb );
		break;
	}

	if ( tmpVfb == IMVFBNULL )
	{
		if ( dstVfb != IMVFBNULL )
			ImVfbFree( dstVfb );
		return ( IMVFBNULL );
	}

	return ( tmpVfb );
}

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.