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=ReadTIMImage(image_info)

image=ReadXImage(image_info,ximage_info);


FUNCTION DESCRIPTIONS


ReadFITSImage

Method 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:

Method 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

Method 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:

Method 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

Method 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:

Method 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.


ReadTIMImage

Method ReadTIMImage reads a PSX TIM image file and returns it. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

Contributed by os@scee.sony.co.uk.

The format of the ReadTIMImage routine is:

        image=ReadTIMImage(image_info)

A description of each parameter follows:

image:

Method ReadTIMImage 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

Method 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:

Method 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.