NAME

decode - Utility Routines to Read Image Formats

SYNOPSIS

image=ReadAVSImage(image_info)

image=ReadBMPImage(image_info)

image=ReadCGMImage(image_info)

image=ReadCMYKImage(image_info)

image=ReadDPSImage(image_info)

image=ReadFAXImage(image_info)

image=ReadFITSImage(image_info)

image=ReadGIFImage(image_info)

image=ReadGRADATIONImage(image_info)

image=ReadGRAYImage(image_info)

image=ReadHDFImage(image_info)

image=ReadHISTOGRAMImage(image_info)

image=ReadHTMLImage(image_info)

image=ReadImage(image_info)

image=ReadJBIGImage(image_info)

image=ReadJPEGImage(image_info)

image=ReadLOGOImage(image_info)

image=ReadMAPImage(image_info)

image=ReadMATTEImage(image_info)

image=ReadMIFFImage(filename)

image=ReadMONOImage(image_info)

image=ReadMPEGImage(image_info)

image=ReadMTVImage(image_info)

image=ReadNULLImage(image_info)

image=ReadPCDImage(image_info)

image=ReadPCLImage(image_info)

image=ReadPCXImage(image_info)

image=ReadPDFImage(image_info)

image=ReadPICTImage(image_info)

image=ReadPLASMAImage(image_info)

image=ReadPNGImage(image_info)

image=ReadPNMImage(image_info)

image=ReadPSImage(image_info)

image=ReadRADIANCEImage(image_info)

image=ReadRGBImage(image_info)

image=ReadRLAImage(image_info)

image=ReadRLEImage(image_info)

image=ReadSGIImage(image_info)

image=ReadSUNImage(image_info)

image=ReadTEXTImage(image_info)

image=ReadTGAImage(image_info)

image=ReadTIFFImage(image_info)

image=ReadTILEImage(image_info)

image=ReadUYVYImage(image_info)

image=ReadVICARImage(image_info)

image=ReadVIDImage(image_info)

image=ReadVIFFImage(image_info)

image=ReadXBMImage(image_info)

image=ReadXCImage(image_info)

image=ReadXImage(image_info,frame,borders,screen,descend)

image=ReadXPMImage(image_info)

image=ReadXWDImage(image_info)

image=ReadYUVImage(image_info)

FUNCTION DESCRIPTIONS

ReadAVSImage

Function ReadAVSImage reads a AVS X 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 ReadAVSImage routine is: 

        image=ReadAVSImage(image_info)

A description of each parameter follows:

o image:
Function ReadAVSImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadBMPImage

Function ReadBMPImage reads a Microsoft Windows bitmap 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 ReadBMPImage routine is: 

        image=ReadBMPImage(image_info)

A description of each parameter follows:

o image:
Function ReadBMPImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadCGMImage

Function ReadCGMImage reads a Computer Graphic Meta 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 ReadCGMImage routine is: 

        image=ReadCGMImage(image_info)

A description of each parameter follows:

o image:
Function ReadCGMImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadCMYKImage

Function ReadCMYKImage reads an image of raw cyan, magenta, yellow, and black bytes 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 ReadCMYKImage routine is: 

        image=ReadCMYKImage(image_info)

A description of each parameter follows:

o image:
Function ReadCMYKImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadDPSImage

Function ReadDPSImage reads a Adobe Postscript 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 ReadDPSImage routine is: 

        image=ReadDPSImage(image_info)

A description of each parameter follows:

o image:
Function ReadDPSImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadFAXImage

Function ReadFAXImage reads a Group 3 FAX 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 ReadFAXImage routine is: 

        image=ReadFAXImage(image_info)

A description of each parameter follows:

o image:
Function ReadFAXImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

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:

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

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

ReadGIFImage

Function ReadGIFImage reads a Compuserve Graphics 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 ReadGIFImage routine is: 

        image=ReadGIFImage(image_info)

A description of each parameter follows:

o image:
Function ReadGIFImage returns a pointer to the image after reading. A null image is returned if there is a a memory shortage or an error occurs.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadGRADATIONImage

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

The format of the ReadGRADATIONImage routine is: 

        image=ReadGRADATIONImage(image_info)

A description of each parameter follows:

o image:
Function ReadGRADATIONImage returns a pointer to the image after creating it. A null image is returned if there is a a memory shortage or if the image cannot be read.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadGRAYImage

Function ReadGRAYImage reads an image of raw grayscale bytes 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 ReadGRAYImage routine is: 

        image=ReadGRAYImage(image_info)

A description of each parameter follows:

o image:
Function ReadGRAYImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadHDFImage

Function ReadHDFImage reads a Hierarchical Data Format 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 ReadHDFImage routine is: 

        image=ReadHDFImage(image_info)

A description of each parameter follows:

o image:
Function ReadHDFImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadHISTOGRAMImage

Function ReadHISTOGRAMImage reads a HISTOGRAM 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 ReadHISTOGRAMImage routine is: 

        image=ReadHISTOGRAMImage(image_info)

A description of each parameter follows:

o image:
Function ReadHISTOGRAMImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadHTMLImage

Function ReadHTMLImage reads a HTML 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 ReadHTMLImage routine is: 

        image=ReadHTMLImage(image_info)

A description of each parameter follows:

o image:
Function ReadHTMLImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadJBIGImage

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

        image=ReadJBIGImage(image_info)

A description of each parameter follows:

o image:
Function ReadJBIGImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadJPEGImage

Function ReadJPEGImage reads 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 ReadJPEGImage routine is: 

        image=ReadJPEGImage(image_info)

A description of each parameter follows:

o image:
Function ReadJPEGImage 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.

o filename:
Specifies the name of the jpeg image to read.

ReadLOGOImage

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

        image=ReadLOGOImage(image_info)

A description of each parameter follows:

o image:
Function ReadLOGOImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadMAPImage

Function ReadMAPImage reads an image of raw RGB colormap and colormap index bytes 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 ReadMAPImage routine is: 

        image=ReadMAPImage(image_info)

A description of each parameter follows:

o image:
Function ReadMAPImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadMATTEImage

Function ReadMATTEImage reads an image of raw matte bytes 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 ReadMATTEImage routine is: 

        image=ReadMATTEImage(image_info)

A description of each parameter follows:

o image:
Function ReadMATTEImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

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:

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

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadMONOImage

Function ReadMONOImage reads an image of raw bites in LSB order 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 ReadMONOImage routine is: 

        image=ReadMONOImage(image_info)

A description of each parameter follows:

o image:
Function ReadMONOImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadMPEGImage

Function ReadMPEGImage reads a MPEG 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 ReadMPEGImage routine is: 

        image=ReadMPEGImage(image_info)

A description of each parameter follows:

o image:
Function ReadMPEGImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadMTVImage

Function ReadMTVImage reads a MTV 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 ReadMTVImage routine is: 

        image=ReadMTVImage(image_info)

A description of each parameter follows:

o image:
Function ReadMTVImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadNULLImage

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

        image=ReadNULLImage(image_info)

A description of each parameter follows:

o image:
Function ReadNULLImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPCDImage

Function ReadPCDImage reads a Photo CD image file and returns it. It allocates the memory necessary for the new Image structure and returns a pointer to the new image. Much of the PCD decoder was derived from the program hpcdtoppm(1) by Hadmut Danisch.

The format of the ReadPCDImage routine is: 

        image=ReadPCDImage(image_info)

A description of each parameter follows:

o image:
Function ReadPCDImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPCLImage

Function ReadPCLImage reads a Page Control Language 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 ReadPCLImage routine is: 

        image=ReadPCLImage(image_info)

A description of each parameter follows:

o image:
Function ReadPCLImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPCXImage

Function ReadPCXImage reads a ZSoft IBM PC Paintbrush 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 ReadPCXImage routine is: 

        image=ReadPCXImage(image_info)

A description of each parameter follows:

o image:
Function ReadPCXImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPDFImage

Function ReadPDFImage reads a Portable Document Format 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 ReadPDFImage routine is: 

        image=ReadPDFImage(image_info)

A description of each parameter follows:

o image:
Function ReadPDFImage 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.

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

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

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPLASMAImage

Function ReadPLASMAImage creates a plasma fractal image. The image is initialized 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:

o image:
Function ReadPLASMAImage returns a pointer to the image after creating it. A null image is returned if there is a a memory shortage or if the image cannot be read.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPNGImage

Function ReadPNGImage reads a Portable Network Graphics 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 ReadPNGImage routine is: 

        image=ReadPNGImage(image_info)

A description of each parameter follows:

o image:
Function ReadPNGImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPNMImage

Function ReadPNMImage reads a Portable Anymap 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 ReadPNMImage routine is: 

        image=ReadPNMImage(image_info)

A description of each parameter follows:

o image:
Function ReadPNMImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadPSImage

Function ReadPSImage reads a Adobe Postscript 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 ReadPSImage routine is: 

        image=ReadPSImage(image_info)

A description of each parameter follows:

o image:
Function ReadPSImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadRADIANCEImage

Function ReadRADIANCEImage reads a RADIANCE 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 ReadRADIANCEImage routine is: 

        image=ReadRADIANCEImage(image_info)

A description of each parameter follows:

o image:
Function ReadRADIANCEImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadRGBImage

Function ReadRGBImage reads an image of raw red, green, and blue bytes 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 ReadRGBImage routine is: 

        image=ReadRGBImage(image_info)

A description of each parameter follows:

o image:
Function ReadRGBImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadRLAImage

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

Note: This module was contributed by Lester Vecsey (master@internexus.net).

The format of the ReadRLAImage routine is: 

        image=ReadRLAImage(image_info)

A description of each parameter follows:

o image:
Function ReadRLAImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadRLEImage

Function ReadRLEImage reads a run-length encoded Utah Raster Toolkit 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 ReadRLEImage routine is: 

        image=ReadRLEImage(image_info)

A description of each parameter follows:

o image:
Function ReadRLEImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadSGIImage

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

        image=ReadSGIImage(image_info)

A description of each parameter follows:

o image:
Function ReadSGIImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadSUNImage

Function ReadSUNImage reads a SUN 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 ReadSUNImage routine is: 

        image=ReadSUNImage(image_info)

A description of each parameter follows:

o image:
Function ReadSUNImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadTGAImage

Function ReadTGAImage reads a Truevision TGA 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 ReadTGAImage routine is: 

        image=ReadTGAImage(image_info)

A description of each parameter follows:

o image:
Function ReadTGAImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadTEXTImage

Function ReadTEXTImage reads a text file and returns it as an image. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the ReadTEXTImage routine is: 

        image=ReadTEXTImage(image_info)

A description of each parameter follows:

o image:
Function ReadTEXTImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadTIFFImage

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

        image=ReadTIFFImage(image_info)

A description of each parameter follows:

o image:
Function ReadTIFFImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadTILEImage

Function ReadTILEImage tiles a texture on an image. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the ReadTILEImage routine is: 

        image=ReadTILEImage(image_info)

A description of each parameter follows:

o image:
Function ReadTILEImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadUYVYImage

Function ReadUYVYImage reads an image in the UYVY (16bit/pixel) format 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 ReadUYVYImage routine is: 

        image=ReadUYVYImage(image_info)

A description of each parameter follows:

o image:
Function ReadUYVYImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadVICARImage

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

        image=ReadVICARImage(image_info)

A description of each parameter follows:

o image:
Function ReadVICARImage 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.

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

ReadVIDImage

Function ReadVIDImage reads one of more images and creates a Visual Image Directory file. It allocates the memory necessary for the new Image structure 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:

o image:
Function ReadVIDImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadVIFFImage

Function ReadVIFFImage reads a Khoros Visualization 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 ReadVIFFImage routine is: 

        image=ReadVIFFImage(image_info)

A description of each parameter follows:

o image:
Function ReadVIFFImage 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.

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

ReadXImage

Procedure ReadXImage reads an image from an X window.

The format of the ReadXImage routine is: 

        image=ReadXImage(image_info,frame,borders,screen,descend)

A description of each parameter follows:

o image_info:
Specifies a pointer to an ImageInfo structure.

o frame:
Specifies whether to include the window manager frame with the image.

o borders:
Specifies whether borders pixels are to be saved with the image.

o screen:
Specifies whether the GetImage request used to obtain the image should be done on the root window, rather than directly on the specified window.

o descend:
If this option is zero, check to see if the WM_COLORMAP_WINDOWS property is set or if XListInstalledColormaps returns more than one colormap. If so, the image is obtained by descending the window hierarchy and reading each subwindow and its colormap.

ReadXBMImage

Function ReadXBMImage reads an X11 bitmap 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 ReadXBMImage routine is: 

        image=ReadXBMImage(image_info)

A description of each parameter follows:

o image:
Function ReadXBMImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadXCImage

Function ReadXCImage creates a constant image and initializes it to the X server color as specified by the filename. It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

The format of the ReadXCImage routine is: 

        image=ReadXCImage(image_info)

A description of each parameter follows:

o image:
Function ReadXCImage returns a pointer to the image after creating it. A null image is returned if there is a a memory shortage or if the image cannot be read.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadXPMImage

Function ReadXPMImage reads an X11 pixmap 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 ReadXPMImage routine is: 

        image=ReadXPMImage(image_info)

A description of each parameter follows:

o image:
Function ReadXPMImage returns a pointer to the image after creating it. A null image is returned if there is a a memory shortage or if the image cannot be read.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadXWDImage

Function ReadXWDImage reads an X Window System window dump 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 ReadXWDImage routine is: 

        image=ReadXWDImage(image_info)

A description of each parameter follows:

o image:
Function ReadXWDImage 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.

o image_info:
Specifies a pointer to an ImageInfo structure.

ReadYUVImage

Function ReadYUVImage reads an image with digital YUV (CCIR 601 4:1:1) bytes 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 ReadYUVImage routine is: 

        image=ReadYUVImage(image_info)

A description of each parameter follows:

o image:
Function ReadYUVImage 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.

o image_info:
Specifies a pointer to an ImageInfo 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:

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

o image_info:
Specifies a pointer to an ImageInfo structure.