; decode - Utility Routines to Read Image Formats��� �  0 




NAME

/decode - Utility Routines to Read Image Formats








SYNOPSIS

0image=ReadFITSImage(image_info)

,image=ReadImage(image_info)

.image=ReadMIFFImage(filename)

0image=ReadPICTImage(image_info)

:image=ReadXImage(image_info,ximage_info);






9

FUNCTION DESCRIPTIONS






)

ReadFITSImage

KFunction ReadFITSImage reads a FITS image file and returns it. It allocatesIthe memory necessary for the new Image structure and returns a pointer tothe new image.

+The format of the ReadFITSImage routine is:

,

        image=ReadFITSImage(image_info)


(A description of each parameter follows:



#
image:
KFunction ReadFITSImage returns a pointer to the image after reading. A nullKimage is returned if there is a a memory shortage or if the image cannot beread.



filename:
(Specifies the name of the image to read.






)

ReadMIFFImage

KFunction ReadMIFFImage reads a MIFF image file and returns it. It allocatesIthe memory necessary for the new Image structure and returns a pointer tothe new image.

+The format of the ReadMIFFImage routine is:

*

        image=ReadMIFFImage(filename)


(A description of each parameter follows:




image:
KFunction ReadMIFFImage returns a pointer to the image after reading. A nullKimage is returned if there is a a memory shortage or if the image cannot beread.



image_info:
.Specifies a pointer to an ImageInfo structure.






)

ReadPICTImage

IFunction ReadPICTImage reads an Apple Macintosh QuickDraw/PICT image fileCand returns it. It allocates the memory necessary for the new Image1structure 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:
KFunction ReadPICTImage returns a pointer to the image after reading. A nullKimage is returned if there is a a memory shortage or if the image cannot beread.



image_info:
.Specifies a pointer to an ImageInfo structure.






#

ReadXImage

5Procedure ReadXImage reads an image from an X window.

(The format of the ReadXImage routine is:

6

        image=ReadXImage(image_info,ximage_info);


(A description of each parameter follows:




image_info:
.Specifies a pointer to an ImageInfo structure.



ximage_info:
0Specifies a pointer to an XImportInfo structure.






!

ReadImage

IFunction ReadImage reads an image and returns it. It allocates the memoryFnecessary for the new Image structure and returns a pointer to the newIimage. By default, the image format is determined by its magic number. ToHspecify a particular image format, precede the filename with an explicitGimage 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:
GFunction ReadImage returns a pointer to the image after reading. A nullKimage is returned if there is a a memory shortage or if the image cannot beread.



image_info:
.Specifies a pointer to an ImageInfo structure.