NAME

encode - Utility Routines to Write Image Formats


SYNOPSIS

status=WriteAVSImage(image_info,image)

status=WriteBMPImage(image_info,image)

status=WriteCGMImage(image_info,image)

status=WriteCMYKImage(image_info,image)

status=WriteFAXImage(image_info,image)

status=WriteFITSImage(image_info,image)

status=WriteGIFImage(image_info,image)

status=WriteGRADATIONImage(image_info,image)

status=WriteGRAYImage(image_info,image)

status=WriteHDFImage(image_info,image)

status=WriteHISTOGRAMImage(image_info,image)

status=WriteHTMLImage(image_info,image)

status=WriteImage(image_info,image)

status=WriteJBIGImage(image_info,image)

status=WriteJPEGImage(image_info,image)

status=WriteLOGOImage(image_info,image)

status=WriteMAPImage(image_info,image)

status=WriteMATTEImage(image_info,image)

status=WriteMIFFImage(image_info,image)

status=WriteMONOImage(image_info,image)

status=WriteMPEGImage(image_info,image)

status=WriteMTVImage(image_info,image)

status=WritePCDImage(image_info,image)

status=WritePCLImage(image_info,image)

status=WritePCXImage(image_info,image)

status=WritePDFImage(image_info,image)

status=WritePICTImage(image_info,image)

status=WritePLASMAImage(image_info,image)

status=WritePNGImage(image_info,image)

status=WritePNMImage(image_info,image)

status=WritePREVIEWImage(image_info,image)

status=WritePS2Image(image_info,image)

status=WritePSImage(image_info,image)

status=WriteRADIANCEImage(image_info,image)

status=WriteRGBImage(image_info,image)

status=WriteRLAImage(image_info,image)

status=WriteRLEImage(image_info,image)

status=WriteSGIImage(image_info,image)

status=WriteSUNImage(image_info,image)

status=WriteTARGAImage(image_info,image)

status=WriteTEXTImage(image_info,image)

status=WriteTIFFImage(image_info,image)

status=WriteTILEImage(image_info,image)

status=WriteUYVYImage(image_info,image)

status=WriteVICARImage(image_info,image)

status=WriteVIFFImage(image_info,image)

status=WriteXBMImage(image_info,image)

status=WriteXCImage(image_info,image)

status=WriteXImage(image_info,image)

status=WriteXPMImage(image_info,image)

status=WriteXWDImage(image_info,image)

status=WriteYUVImage(image_info,image)


FUNCTION DESCRIPTIONS


WriteAVSImage

Function WriteAVSImage writes an image to a file in AVS X image format.

The format of the WriteAVSImage routine is:

        status=WriteAVSImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteAVSImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteBMPImage

Function WriteBMPImage writes an image in Microsoft Windows bitmap encoded image format.

The format of the WriteBMPImage routine is:

        status=WriteBMPImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteBMPImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteCGMImage

Function WriteCGMImage writes an image in the CGM encoded image format.

The format of the WriteCGMImage routine is:

        status=WriteCGMImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteCGMImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteCMYKImage

Function WriteCMYKImage writes an image to a file in cyan, magenta, yellow, and black rasterfile format.

The format of the WriteCMYKImage routine is:

        status=WriteCMYKImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteCMYKImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteFAXImage

Procedure WriteFAXImage writes an image to a file in 1 dimensional Huffman encoded format.

The format of the WriteFAXImage routine is:

        status=WriteFAXImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteFAXImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteFITSImage

Function WriteFITSImage writes a Flexible Image Transport System image to a file as gray scale intensities [0..255].

The format of the WriteFITSImage routine is:

        status=WriteFITSImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteFITSImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteGIFImage

Function WriteGIFImage writes an image to a file in the Compuserve Graphics image format.

The format of the WriteGIFImage routine is:

        status=WriteGIFImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteGIFImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteGRADATIONImage

Function WriteGRADATIONImage writes an image in the gradation image format.

The format of the WriteGRADATIONImage routine is:

        status=WriteGRADATIONImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteGRADATIONImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteGRAYImage

Function WriteGRAYImage writes an image to a file as gray scale intensity values.

The format of the WriteGRAYImage routine is:

        status=WriteGRAYImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteGRAYImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteHDFImage

Function WriteHDFImage writes an image in the Hierarchial Data Format image format.

The format of the WriteHDFImage routine is:

        status=WriteHDFImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteHDFImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteHISTOGRAMImage

Function WriteHISTOGRAMImage writes an image to a file in HISTOGRAM format. The image shows a histogram of the color (or gray) values in the image. The image consists of three overlaid histograms: a red one for the red channel, a green one for the green channel, and a blue one for the blue channel. The image comment contains a list of unique pixel values and the number of times each occurs in the image.

This routine is strongly based on a similiar one written by muquit@warm.semcor.com which in turn is based on ppmhistmap of netpbm.

The format of the WriteHISTOGRAMImage routine is:

        status=WriteHISTOGRAMImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteHISTOGRAMImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteHTMLImage

Function WriteHTMLImage writes an image in the HTML encoded image format.

The format of the WriteHTMLImage routine is:

        status=WriteHTMLImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteHTMLImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteJBIGImage

Function WriteJBIGImage writes an image in the JBIG encoded image format.

The format of the WriteJBIGImage routine is:

        status=WriteJBIGImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteJBIGImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteJPEGImage

Function WriteJPEGImage writes a JPEG image file and returns it. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the WriteJPEGImage routine is:

        status=WriteJPEGImage(image_info,image)

A description of each parameter follows:

o status:
Function WriteJPEGImage return True if the image is written. False is returned is there is of a memory shortage or if the image file cannot be opened for writing.

o image_info:
Specifies a pointer to an ImageInfo structure.

o jpeg_image:
A pointer to a Image structure.


WriteLOGOImage

Function WriteLOGOImage writes an image in the LOGO encoded image format. We use GIF because it is the only format that is compressed without requiring addition optional plug-ins (TIFF, ZIP, etc).

The format of the WriteLOGOImage routine is:

        status=WriteLOGOImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteLOGOImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMAPImage

Function WriteMAPImage writes an image to a file as red, green, and blue colormap bytes followed by the colormap indexes.

The format of the WriteMAPImage routine is:

        status=WriteMAPImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteMAPImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMATTEImage

Function WriteMATTEImage writes an image of matte bytes to a file. It consists of data from the matte component of the image [0..255].

The format of the WriteMATTEImage routine is:

        status=WriteMATTEImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteMATTEImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMIFFImage

Function WriteMIFFImage writes an image to a file.

The format of the WriteMIFFImage routine is:

        status=WriteMIFFImage(image_info,image)

A description of each parameter follows:

o status:
Function WriteMIFFImage return True if the image is written. False is returned if there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMONOImage

Function WriteMONOImage writes an image of raw bits in LSB order to a file.

The format of the WriteMONOImage routine is:

        status=WriteMONOImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteMATTEImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMPEGImage

Function WriteMPEGImage writes an image in the MPEG encoded image format.

The format of the WriteMPEGImage routine is:

        status=WriteMPEGImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteMPEGImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteMTVImage

Function WriteMTVImage writes an image to a file in red, green, and blue MTV rasterfile format.

The format of the WriteMTVImage routine is:

        status=WriteMTVImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteMTVImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePCDImage

Function WritePCDImage writes an image in the Photo CD encoded image format.

The format of the WritePCDImage routine is:

        status=WritePCDImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePCDImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePCLImage

Function WritePCLImage writes an image in the Page Control Language encoded image format.

The format of the WritePCLImage routine is:

        status=WritePCLImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePCLImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePCXImage

Function WritePCXImage writes an image in the ZSoft IBM PC Paintbrush file format.

The format of the WritePCXImage routine is:

        status=WritePCXImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePCXImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePDFImage

Function WritePDFImage writes an image in the Portable Document image format.

The format of the WritePDFImage routine is:

        status=WritePDFImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePDFImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePICTImage

Function WritePICTImage writes an image to a file in the Apple Macintosh QuickDraw/PICT image format.

The format of the WritePICTImage routine is:

        status=WritePICTImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePICTImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePLASMAImage

Function WritePLASMAImage writes an image in the plasma image format.

The format of the WritePLASMAImage routine is:

        status=WritePLASMAImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePLASMAImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePNGImage

Function WritePNGImage writes an image in the Portable Network Graphics encoded image format.

The format of the WritePNGImage routine is:

        status=WritePNGImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePNGImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePNMImage

Procedure WritePNMImage writes an image to a file in the PNM rasterfile format.

The format of the WritePNMImage routine is:

        status=WritePNMImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePNMImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePREVIEWImage

Function WritePREVIEWImage creates several tiles each with a varying stength of an image enhancement function (e.g. gamma). The image is written in the MIFF format.

The format of the WritePREVIEWImage routine is:

        status=WritePREVIEWImage(image_info,image)

A description of each parameter follows.

o status:
Function WritePREVIEWImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WritePSImage

Function WritePSImage translates an image to encapsulated Postscript Level I for printing. If the supplied geometry is null, the image is centered on the Postscript page. Otherwise, the image is positioned as specified by the geometry.

The format of the WritePSImage routine is:

        status=WritePSImage(image_info,image)

A description of each parameter follows:

o status:
Function WritePSImage return True if the image is printed. False is returned if the image file cannot be opened for printing.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
The address of a structure of type Image; returned from ReadImage.


WritePS2Image

Function WritePS2Image translates an image to encapsulated Postscript Level II for printing. If the supplied geometry is null, the image is centered on the Postscript page. Otherwise, the image is positioned as specified by the geometry.

The format of the WritePS2Image routine is:

        status=WritePS2Image(image_info,image)

A description of each parameter follows:

o status:
Function WritePS2Image return True if the image is printed. False is returned if the image file cannot be opened for printing.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
The address of a structure of type Image; returned from ReadImage.


WriteRADIANCEImage

Function WriteRADIANCEImage writes an image in the RADIANCE encoded image format.

The format of the WriteRADIANCEImage routine is:

        status=WriteRADIANCEImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteRADIANCEImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteRGBImage

Function WriteRGBImage writes an image to a file in red, green, and blue rasterfile format.

The format of the WriteRGBImage routine is:

        status=WriteRGBImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteRGBImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteRLAImage

Function WriteRLAImage writes an image in the Alias/Wavefront encoded image format.

The format of the WriteRLAImage routine is:

        status=WriteRLAImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteRLAImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteRLEImage

Function WriteRLEImage writes an image in the Utah Run length encoded image format.

The format of the WriteRLEImage routine is:

        status=WriteRLEImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteRLEImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteSGIImage

Function WriteSGIImage writes an image in SGI RGB encoded image format.

The format of the WriteSGIImage routine is:

        status=WriteSGIImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteSGIImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteSUNImage

Function WriteSUNImage writes an image in the SUN rasterfile format.

The format of the WriteSUNImage routine is:

        status=WriteSUNImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteSUNImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteTARGAImage

Function WriteTARGAImage writes a image in the Truevision Targa rasterfile format.

The format of the WriteTARGAImage routine is:

        status=WriteTARGAImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteTARGAImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteTEXTImage

Function WriteTEXTImage writes an image in the TEXT image forma.

The format of the WriteTEXTImage routine is:

        status=WriteTEXTImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteTEXTImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteTIFFImage

Function WriteTIFFImage writes an image in the Tagged image file format.

The format of the WriteTIFFImage routine is:

        status=WriteTIFFImage(image_info,image)

A description of each parameter follows:

o status:
Function WriteTIFFImage return True if the image is written. False is returned is there is of a memory shortage or if the image file cannot be opened for writing.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteTILEImage

Function WriteTILEImage writes an image in the TILE encoded image format.

The format of the WriteTILEImage routine is:

        status=WriteTILEImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteTILEImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteUYVYImage

Function WriteUYVYImage writes an image to a file in the digital UYVY (16bit/pixel) format. This format, used by AccomWSD, is not dramatically higher quality than the 12bit/pixel YUV format, but has better locality.

The format of the WriteUYVYImage routine is:

        status=WriteUYVYImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteUYVYImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure. Implicit assumption: number of columns is even.


WriteVICARImage

Function WriteVICARImage writes an image in the VICAR rasterfile format. Vicar files contain a text header, followed by one or more planes of binary grayscale image data. Vicar files are designed to allow many planes to be stacked together to form image cubes. This routine only writes a single grayscale plane.

Function WriteVICARImage was written contributed by gorelick@esther.la.asu.edu.

The format of the WriteVICARImage routine is:

        status=WriteVICARImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteVICARImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteVIFFImage

Function WriteVIFFImage writes an image to a file in the VIFF image format.

The format of the WriteVIFFImage routine is:

        status=WriteVIFFImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteVIFFImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteXImage

Function WriteXImage writes an image to an X server.

The format of the WriteXImage routine is:

        status=WriteXImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteXImage return True if the image is displayed on the X server. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteXBMImage

Procedure WriteXBMImage writes an image to a file in the X bitmap format.

The format of the WriteXBMImage routine is:

        status=WriteXBMImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteXBMImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteXCImage

Function WriteXCImage writes an image in the X constant image format.

The format of the WriteXCImage routine is:

        status=WriteXCImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteXCImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteXPMImage

Procedure WriteXPMImage writes an image to a file in the X pixmap format.

The format of the WriteXPMImage routine is:

        status=WriteXPMImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteXPMImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteYUVImage

Function WriteYUVImage writes an image to a file in the digital YUV (CCIR 601 4:1:1) format.

The format of the WriteYUVImage routine is:

        status=WriteYUVImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteYUVImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteXWDImage

Function WriteXWDImage writes an image to a file in X window dump rasterfile format.

The format of the WriteXWDImage routine is:

        status=WriteXWDImage(image_info,image)

A description of each parameter follows.

o status:
Function WriteXWDImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.


WriteImage

Function WriteImage writes an image to a file. You can specify a particular image format by prefixing the file with the image type and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps).

The format of the WriteImage routine is:

        status=WriteImage(image_info,image)

A description of each parameter follows:

o status:
Function WriteImage return True if the image is written. False is returned is there is a memory shortage or if the image file fails to write.

o image_info:
Specifies a pointer to an ImageInfo structure.

o image:
A pointer to a Image structure.