5decode - Methods to Read Image Formats;/


NAME



&decode - Methods to Read Image Formats




(

SYNOPSIS



/image=ReadAVSImage(image_info)

/image=ReadBMPImage(image_info)

0image=ReadCMYKImage(image_info)

/image=ReadDCMImage(image_info)

/image=ReadDPSImage(image_info)

/image=ReadFAXImage(image_info)

0image=ReadFITSImage(image_info)

/image=ReadFPXImage(image_info)

/image=ReadGIFImage(image_info)

5image=ReadGRADATIONImage(image_info)

0image=ReadGRAYImage(image_info)

/image=ReadHDFImage(image_info)

5image=ReadHISTOGRAMImage(image_info)

/image=ReadICCImage(image_info)

0image=ReadICONImage(image_info)

0image=ReadIPTCImage(image_info)

,image=ReadImage(image_info)

-image=ReadImages(image_info)

0image=ReadJBIGImage(image_info)

0image=ReadJPEGImage(image_info)

1image=ReadLABELImage(image_info)

0image=ReadLOGOImage(image_info)

0image=ReadLOGOImage(image_info)

/image=ReadMAPImage(image_info)

.image=ReadMIFFImage(filename)

0image=ReadMONOImage(image_info)

/image=ReadMTVImage(image_info)

0image=ReadNULLImage(image_info)

/image=ReadPCDImage(image_info)

/image=ReadPCLImage(image_info)

/image=ReadPCXImage(image_info)

/image=ReadPDFImage(image_info)

0image=ReadPICTImage(image_info)

/image=ReadPIXImage(image_info)

2image=ReadPLASMAImage(image_info)

/image=ReadPNGImage(image_info)

/image=ReadPNMImage(image_info)

/image=ReadPSDImage(image_info)

.image=ReadPSImage(image_info)

/image=ReadRGBImage(image_info)

/image=ReadRLAImage(image_info)

/image=ReadRLEImage(image_info)

/image=ReadSFWImage(image_info)

/image=ReadSGIImage(image_info)

3image=ReadSTEGANOImage(image_info)

/image=ReadSUNImage(image_info)

/image=ReadTGAImage(image_info)

0image=ReadTIFFImage(image_info)

0image=ReadTILEImage(image_info)

/image=ReadTIMImage(image_info)

/image=ReadTTFImage(image_info)

/image=ReadTXTImage(image_info)

/image=ReadUILImage(image_info)

0image=ReadUYVYImage(image_info)

1image=ReadVICARImage(image_info)

/image=ReadVIDImage(image_info)

0image=ReadVIFFImage(image_info)

/image=ReadXBMImage(image_info)

.image=ReadXCImage(image_info)

-image=ReadXImage(image_info)

/image=ReadXPMImage(image_info)

/image=ReadXWDImage(image_info)

/image=ReadYUVImage(image_info)




B

FUNCTION DESCRIPTIONS






0

ReadAVSImage



JMethod ReadAVSImage reads an AVS X 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 ReadAVSImage routine is:

+

        image=ReadAVSImage(image_info)


(A description of each parameter follows:

4
image:


HMethod ReadAVSImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadBMPImage



KMethod ReadBMPImage reads a Microsoft Windows bitmap image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

*The format of the ReadBMPImage routine is:

+

        image=ReadBMPImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadBMPImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadCMYKImage



KMethod ReadCMYKImage reads an image of raw cyan, magenta, yellow, and blackIbytes and returns it. It allocates the memory necessary for the new Image1structure and returns a pointer to the new image.

+The format of the ReadCMYKImage routine is:

,

        image=ReadCMYKImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadCMYKImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadDCMImage



JMethod ReadDCMImage reads a Digital Imaging and Communications in MedicineI(DICOM) file and returns it. It It allocates the memory necessary for the;new Image structure and returns a pointer to the new image.

*The format of the ReadDCMImage routine is:

+

        image=ReadDCMImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadDCMImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadDPSImage



JMethod ReadDPSImage reads a Adobe Postscript image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadDPSImage routine is:

+

        image=ReadDPSImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadDPSImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadFAXImage



EMethod ReadFAXImage reads a Group 3 FAX image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadFAXImage routine is:

+

        image=ReadFAXImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadFAXImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadFITSImage



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


IMethod ReadFITSImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread."

filename:


(Specifies the name of the image to read.






0

ReadFPXImage



BMethod ReadFPXImage reads a FlashPix image file and returns it. ItHallocates the memory necessary for the new Image structure and returns a<pointer to the new image. This routine was contributed by BillR@corbis.com.

*The format of the ReadFPXImage routine is:

+

        image=ReadFPXImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadFPXImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadGIFImage



JMethod ReadGIFImage reads a Compuserve Graphics image file and returns it.KIt allocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadGIFImage routine is:

+

        image=ReadGIFImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadGIFImage returns a pointer to the image after reading. A nullCimage is returned if there is a memory shortage or an error occurs.$

image_info:


.Specifies a pointer to an ImageInfo structure.






<

ReadGRADATIONImage



IMethod ReadGRADATIONImage creates a gradation image and initializes it toGthe X server color range as specified by the filename. It allocates theImemory necessary for the new Image structure and returns a pointer to the new image.

0The format of the ReadGRADATIONImage routine is:

1

        image=ReadGRADATIONImage(image_info)


(A description of each parameter follows:


image:


KMethod ReadGRADATIONImage returns a pointer to the image after creating it.FA null image is returned if there is a memory shortage or if the imagecannot be read.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadGRAYImage



JMethod ReadGRAYImage reads an image of raw grayscale bytes and returns it.KIt allocates the memory necessary for the new Image structure and returns apointer to the new image.

+The format of the ReadGRAYImage routine is:

,

        image=ReadGRAYImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadGRAYImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadHDFImage



KMethod ReadHDFImage reads a Hierarchical Data Format image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

*The format of the ReadHDFImage routine is:

+

        image=ReadHDFImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadHDFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






<

ReadHISTOGRAMImage



IMethod ReadHISTOGRAMImage reads a HISTOGRAM image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

0The format of the ReadHISTOGRAMImage routine is:

1

        image=ReadHISTOGRAMImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadHISTOGRAMImage returns a pointer to the image after reading. AKnull image is returned if there is a memory shortage or if the image cannotbe read.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadICCImage



IMethod ReadICCImage reads an image file in the ICC format and returns it.KIt allocates the memory necessary for the new Image structure and returns aDpointer to the new image. This method differs from the other decoderCmethods in that only the color profile information is useful in thereturned image.

*The format of the ReadICCImage routine is:

+

        image=ReadICCImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadICCImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadICONImage



IMethod ReadICONImage reads a Microsoft icon image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

+The format of the ReadICONImage routine is:

,

        image=ReadICONImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadICONImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






,

ReadImages



JMethod ReadImages reads a list of image names from a file and then returnsthe images as a linked list.

'The format of the ReadImage routine is:

)

        image=ReadImages(image_info)


(A description of each parameter follows:


image:


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

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadIPTCImage



KMethod ReadIPTCImage reads an image file in the IPTC format and returns it.KIt allocates the memory necessary for the new Image structure and returns aDpointer to the new image. This method differs from the other decoderKmethods in that only the iptc profile information is useful in the returnedimage.

+The format of the ReadIPTCImage routine is:

,

        image=ReadIPTCImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadIPTCImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadJBIGImage



IMethod ReadJBIGImage reads a JBIG 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 ReadJBIGImage routine is:

,

        image=ReadJBIGImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadJBIGImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadJPEGImage



IMethod ReadJPEGImage reads a JPEG 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 ReadJPEGImage routine is:

,

        image=ReadJPEGImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadJPEGImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread."

filename:


-Specifies the name of the jpeg image to read.






4

ReadLABELImage



KMethod ReadLABELImage reads a LABEL 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 ReadLABELImage routine is:

-

        image=ReadLABELImage(image_info)


(A description of each parameter follows:


image:


JMethod ReadLABELImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadLOGOImage



IMethod ReadLOGOImage reads a LOGO 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 ReadLOGOImage routine is:

,

        image=ReadLOGOImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadLOGOImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadMAPImage



IMethod ReadMAPImage reads an image of raw RGB colormap and colormap indexIbytes and returns it. It allocates the memory necessary for the new Image1structure and returns a pointer to the new image.

*The format of the ReadMAPImage routine is:

+

        image=ReadMAPImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadMAPImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadMIFFImage



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


IMethod ReadMIFFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadMONOImage



IMethod ReadMONOImage reads an image of raw bites in LSB order and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

+The format of the ReadMONOImage routine is:

,

        image=ReadMONOImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadMONOImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadMTVImage



KMethod ReadMTVImage reads a MTV image file and returns it. It allocates theImemory necessary for the new Image structure and returns a pointer to the new image.

*The format of the ReadMTVImage routine is:

+

        image=ReadMTVImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadMTVImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadNULLImage



IMethod ReadNULLImage reads a NULL 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 ReadNULLImage routine is:

,

        image=ReadNULLImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadNULLImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPCDImage



BMethod ReadPCDImage reads a Photo CD image file and returns it. ItHallocates the memory necessary for the new Image structure and returns aFpointer to the new image. Much of the PCD decoder was derived from the4program hpcdtoppm(1) by Hadmut Danisch.

*The format of the ReadPCDImage routine is:

+

        image=ReadPCDImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPCDImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPCLImage



HMethod ReadPCLImage reads a Page Control Language image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

*The format of the ReadPCLImage routine is:

+

        image=ReadPCLImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPCLImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPCXImage



KMethod ReadPCXImage reads a ZSoft IBM PC Paintbrush file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadPCXImage routine is:

+

        image=ReadPCXImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPCXImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPDFImage



KMethod ReadPDFImage reads a Portable Document Format image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

*The format of the ReadPDFImage routine is:

+

        image=ReadPDFImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPDFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadPICTImage



KMethod ReadPICTImage reads an Apple Macintosh QuickDraw/PICT image file andIreturns 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:


IMethod ReadPICTImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPIXImage



JMethod ReadPIXImage reads a Alias/Wavefront RLE image file and returns it.KIt allocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadPIXImage routine is:

+

        image=ReadPIXImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPIXImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






6

ReadPLASMAImage



CMethod ReadPLASMAImage creates a plasma fractal image. The image isBinitialized to to the X server color as specified by the filename.

-The format of the ReadPLASMAImage routine is:

.

        image=ReadPLASMAImage(image_info)


(A description of each parameter follows:


image:


JMethod ReadPLASMAImage returns a pointer to the image after creating it. AKnull image is returned if there is a memory shortage or if the image cannotbe read.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPNGImage



DMethod ReadPNGImage reads a Portable Network Graphics image file andIreturns it. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

*The format of the ReadPNGImage routine is:

+

        image=ReadPNGImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPNGImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPNMImage



IMethod ReadPNMImage reads a Portable Anymap image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadPNMImage routine is:

+

        image=ReadPNMImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPNMImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






.

ReadPSImage



IMethod ReadPSImage reads a Adobe Postscript image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

)The format of the ReadPSImage routine is:

*

        image=ReadPSImage(image_info)


(A description of each parameter follows:


image:


GMethod ReadPSImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadPSDImage



JMethod ReadPSDImage reads an Adobe Photoshop image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadPSDImage routine is:

+

        image=ReadPSDImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPSDImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadLOGOImage



KMethod ReadPWPImage reads a Seattle Film Works multi-image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

*The format of the ReadPWPImage routine is:

'

    image=ReadPWPImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadPWPImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadRGBImage



HMethod ReadRGBImage reads an image of raw red, green, and blue bytes andIreturns it. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

*The format of the ReadRGBImage routine is:

+

        image=ReadRGBImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadRGBImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadRLAImage



KMethod ReadRLAImage reads a run-length encoded Wavefront RLA image file andIreturns it. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

6Note: This module was contributed by Lester Vecsey (HREF="mailto:master@internexus.net">master@internexus.net)

*The format of the ReadRLAImage routine is:

+

        image=ReadRLAImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadRLAImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadRLEImage



HMethod ReadRLEImage reads a run-length encoded Utah Raster Toolkit imageHfile and returns it. It allocates the memory necessary for the new Image1structure and returns a pointer to the new image.

*The format of the ReadRLEImage routine is:

+

        image=ReadRLEImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadRLEImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadSFWImage



IMethod ReadSFWImage reads a Seattle Film Works image file and returns it.KIt allocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadSFWImage routine is:

+

        image=ReadSFWImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadSFWImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadSGIImage



KMethod ReadSGIImage reads a SGI RGB 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 ReadSGIImage routine is:

+

        image=ReadSGIImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadSGIImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






8

ReadSTEGANOImage



JMethod ReadSTEGANOImage reads a steganographic image hidden within anotherIimage type. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

.The format of the ReadSTEGANOImage routine is:

/

        image=ReadSTEGANOImage(image_info)


(A description of each parameter follows:


image:


GMethod ReadSTEGANOImage returns a pointer to the image after reading. AKnull image is returned if there is a memory shortage of if the image cannotbe read.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadSUNImage



KMethod ReadSUNImage reads a SUN image file and returns it. It allocates theImemory necessary for the new Image structure and returns a pointer to the new image.

*The format of the ReadSUNImage routine is:

+

        image=ReadSUNImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadSUNImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadTGAImage



HMethod ReadTGAImage reads a Truevision TGA image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadTGAImage routine is:

+

        image=ReadTGAImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadTGAImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadTIFFImage



KMethod ReadTIFFImage reads a Tagged 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 ReadTIFFImage routine is:

,

        image=ReadTIFFImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadTIFFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadTILEImage



IMethod ReadTILEImage tiles a texture on an image. It allocates the memoryFnecessary for the new Image structure and returns a pointer to the newimage.

+The format of the ReadTILEImage routine is:

,

        image=ReadTILEImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadTILEImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadTIMImage



KMethod ReadTIMImage reads a PSX TIM image file and returns it. It allocatesIthe memory necessary for the new Image structure and returns a pointer tothe new image.

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

*The format of the ReadTIMImage routine is:

+

        image=ReadTIMImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadTIMImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadTTFImage



KMethod ReadTTFImage reads a TrueType font file and returns it. It allocatesIthe memory necessary for the new Image structure and returns a pointer tothe new image.

*The format of the ReadTTFImage routine is:

+

        image=ReadTTFImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadTTFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadTXTImage



DMethod ReadTXTImage reads a text file and returns it as an image. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadTXTImage routine is:

+

        image=ReadTXTImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadTXTImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadUILImage



JMethod ReadUILImage reads a X-Motif UIL table and returns it. It allocatesIthe memory necessary for the new Image structure and returns a pointer tothe new image.

*The format of the ReadUILImage routine is:

+

        image=ReadUILImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadUILImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadUYVYImage



HMethod ReadUYVYImage reads an image in the UYVY (16bit/pixel) format andIreturns it. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

+The format of the ReadUYVYImage routine is:

,

        image=ReadUYVYImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadUYVYImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






4

ReadVICARImage



KMethod ReadVICARImage reads a VICAR 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 ReadVICARImage routine is:

-

        image=ReadVICARImage(image_info)


(A description of each parameter follows:


image:


JMethod ReadVICARImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread."

filename:


(Specifies the name of the image to read.






0

ReadVIDImage



GMethod ReadVIDImage reads one of more images and creates a Visual ImageCDirectory file. It allocates the memory necessary for the new Image1structure and returns a pointer to the new image.

*The format of the ReadVIDImage routine is:

+

        image=ReadVIDImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadVIDImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






2

ReadVIFFImage



HMethod ReadVIFFImage reads a Khoros Visualization image file and returnsEit. It allocates the memory necessary for the new Image structure and#returns a pointer to the new image.

+The format of the ReadVIFFImage routine is:

,

        image=ReadVIFFImage(image_info)


(A description of each parameter follows:


image:


IMethod ReadVIFFImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread."

filename:


(Specifies the name of the image to read.






,

ReadXImage



5Procedure ReadXImage reads an image from an X window.

(The format of the ReadXImage routine is:

)

        image=ReadXImage(image_info)


(A description of each parameter follows:

$
image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadXBMImage



EMethod ReadXBMImage reads an X11 bitmap image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadXBMImage routine is:

+

        image=ReadXBMImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadXBMImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






.

ReadXCImage



GMethod ReadXCImage creates a constant image and initializes it to the XBserver color as specified by the filename. It allocates the memoryFnecessary for the new Image structure and returns a pointer to the newimage.

)The format of the ReadXCImage routine is:

*

        image=ReadXCImage(image_info)


(A description of each parameter follows:


image:


KMethod ReadXCImage returns a pointer to the image after creating it. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadXPMImage



EMethod ReadXPMImage reads an X11 pixmap image file and returns it. ItHallocates the memory necessary for the new Image structure and returns apointer to the new image.

*The format of the ReadXPMImage routine is:

+

        image=ReadXPMImage(image_info)


(A description of each parameter follows:


image:


GMethod ReadXPMImage returns a pointer to the image after creating it. AKnull image is returned if there is a memory shortage or if the image cannotbe read.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadXWDImage



GMethod ReadXWDImage reads an X Window System window dump image file andIreturns it. It allocates the memory necessary for the new Image structure'and returns a pointer to the new image.

*The format of the ReadXWDImage routine is:

+

        image=ReadXWDImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadXWDImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






0

ReadYUVImage



JMethod ReadYUVImage reads an image with digital YUV (CCIR 601 4:1:1) bytesCand returns it. It allocates the memory necessary for the new Image1structure and returns a pointer to the new image.

*The format of the ReadYUVImage routine is:

+

        image=ReadYUVImage(image_info)


(A description of each parameter follows:


image:


HMethod ReadYUVImage returns a pointer to the image after reading. A nullIimage is returned if there is a memory shortage or if the image cannot beread.$

image_info:


.Specifies a pointer to an ImageInfo structure.






*

ReadImage



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


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

image_info:


.Specifies a pointer to an ImageInfo structure.