NAME
write_Image - writes the contents of a CVIP Image structure
out to disk
SYNOPSIS
#include <CVIPtoolkit.h>
#include <CVIPimage.h>
#include <CVIPlconvert.h>
write_Image(Image *cvip_Image, char *filename, CVIP_BOOLEAN
retain_image, CVIP_BOOLEAN set_up, IMAGE_FORMAT new_format,
CVIP_BOOLEAN showmessages)
<cvip_Image> - pointer to valid CVIP Image structure
<filename> - pointer to an character string containing the
file name
<retain_image> - retain image after writing (CVIP_YES or
CVIP_NO)?
<set_up> - run setup (CVIP_YES or CVIP_NO)?
<new_format> - enumeration constant specifying the format
of the file to be read in
<showmessages> - shall I be verbose (CVIP_YES or CVIP_NO)?
PATH
$CVIPHOME/CONVERSION/convert.c
DESCRIPTION
Writes the contents of a CVIP Image structure out to disk
in the specified format <new_format>. Many of the formats
offer variations on the way a file can be presented to disk.
(e.g. compression schemes, byte ordering, etc..) To take
full advantage of this a set-up routine can be run by set-
ting <set-up> equal to CVIP_YES; otherwise, default options
will be used. Set-up routines vary for each format.
TYPES AND CONSTANTS
RETURN VALUES
Pointer to newly allocated Image structure
HISTORY
History information recorded: None
EXAMPLE
#include <CVIPtoolkit.h>
#include <CVIPimage.h>
#include <CVIPdef.h>
#include <CVIPview.h>
#include <CVIPconvert.h>
#define VIEWER "picture"
#define VIDEO_APP "SunVideo &"
void main()
{
Image *cvipImage;
IMAGE_FORMAT format;
char *inputfile,*outputfile;
setDisplay_Image(VIEWER, "Default");
print_CVIP("\n\t\tEnter the Input File Name: ");
inputfile =(char *) getString_CVIP();
format = getFormat_CVIP(inputfile);
/* the following call loads an image structure with data
from the specified file */
cvipImage = read_Image(inputfile,1);
view_Image(cvipImage, inputfile);
free(inputfile);
print_CVIP("\n\t\tEnter the Output File Name: ");
outputfile = getString_CVIP();
view_Image(cvipImage,outputfile);
/* the following call writes the contents of the CVIP image
structure out to disk.The format is the same as the
input file format */
write_Image(cvipImage,outputfile,CVIP_NO,CVIP_NO,format,1);
free(outputfile);
}
SEE ALSO
libconverter(3)
AUTHOR
Copyright (C) 1996 SIUE - by Scott E. Umbaugh and Greg
Hance.