NAME

decode - Utility Routines to Read Image Formats

SYNOPSIS

image=ReadFITSImage(image_info)

image=ReadImage(image_info)

image=ReadMIFFImage(filename)

image=ReadPICTImage(image_info)

image=ReadXImage(image_info,ximage_info);

FUNCTION DESCRIPTIONS

ReadFITSImage

Function ReadFITSImage reads a FITS 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 ReadFITSImage routine is: 

        image=ReadFITSImage(image_info)

A description of each parameter follows:

image:
Function ReadFITSImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or if the image cannot be read.

filename:
Specifies the name of the image to read.

ReadMIFFImage

Function ReadMIFFImage reads a MIFF 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 ReadMIFFImage routine is: 

        image=ReadMIFFImage(filename)

A description of each parameter follows:

image:
Function ReadMIFFImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or if the image cannot be read.

image_info:
Specifies a pointer to an ImageInfo structure.

ReadPICTImage

Function ReadPICTImage reads an Apple Macintosh QuickDraw/PICT 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 ReadPICTImage routine is: 

        image=ReadPICTImage(image_info)

A description of each parameter follows:

image:
Function ReadPICTImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or if the image cannot be read.

image_info:
Specifies a pointer to an ImageInfo structure.

ReadXImage

Procedure ReadXImage reads an image from an X window.

The format of the ReadXImage routine is: 

        image=ReadXImage(image_info,ximage_info);

A description of each parameter follows:

image_info:
Specifies a pointer to an ImageInfo structure.

ximage_info:
Specifies a pointer to an XImportInfo structure.

ReadImage

Function ReadImage reads an image and returns it. It allocates the memory necessary for the new Image structure and returns a pointer to the new image. By default, the image format is determined by its magic number. To specify a particular image format, precede the filename with an explicit image format name and a colon (i.e. ps:image) or as the filename suffix (i.e. image.ps).

The format of the ReadImage routine is: 

        image=ReadImage(image_info)

A description of each parameter follows:

image:
Function ReadImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or if the image cannot be read.

image_info:
Specifies a pointer to an ImageInfo structure.