A string containing the pathname and filename of an image file. System variables/logicals and special characters recognized by the operating system shell can be used in the path.
Reads an image file and returns an associative array in image format.
A string containing the pathname and filename of an image file. System variables/logicals and special characters recognized by the operating system shell can be used in the path.
If set, all subimages in the file are read and the Img_Count keyword is ignored. The first subimage in the file is read first, unless the Sub_Img keyword is also specified.
NOTE: Multiple images being read with the IMAGE_READ function must all be of the same height, width, and class. If a file contains images of different heights, widths, and/or classes, only the first contiguous sequence with equal height, width, and class are read.
If set, and the colormap in the image file has unused entries, IMAGE_READ compresses the colormap to the minimum size and re-maps the pixel array. File_Type
A string specifying the default file type. (See the Discussion.) Intleave
A scalar string indicating the desired type of interleaving of 3D image arrays. (Default: pixel) Valid strings and the corresponding interleaving methods are:
'image' The resulting 3D image array arrangement is (x, y, p) for p image-interleaved images of x-by-y.
'row' The resulting 3D image array arrangement is (x, p, y) for p row-interleaved images of x-by-y.
'pixel' The resulting 3D image array arrang10ement is (p, x, y) for p pixel-interleaved images of x-by-y. (Default)
An integer specifying the number of images to read from an array of images.
NOTE: The Img_Count keyword is ignored if the All_Subimages keyword is set.
If nonzero, returns the image mirrored in the y-direction. (Default: Do not mirror the image.)Quiet
Suppresses successive levels of error messages, depending on the value set. This keyword accepts the same integer values used with the system variable !Quiet.Sub_Img
The index number (integer) of the first image to read from an array of images. (Default: 0, the first image)
NOTE: If Sub_Img is used to request a subimage that is not in the image file, the status key of the returned image associative array is set to a negative number.
When you read in an image containing a 2D pixel array and no colormap, a colormap is created and your pixel data is mapped into this colormap. When nonzero, this keyword restores your original pixel values and places a standard grayscale colormap in the colormap field of the image associative array. Verbose
If nonzero, any available information about the file is printed to the screen.
An associative array in image format.
NOTE: Refer to the IMAGE_CREATE function for detailed information on the structure of the image associative array.
NOTE: FiletypeTGAdoes not have an encoded ID number. To read this type of file you must specify the File_type keyword or filename must have a.tgasuffix.
flowers = IMAGE_READ('flowers.tif')
