#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rreadima ReadImage #!N #!N Category #!N #!N  #!Lcatiae,dxall756 h Import and Export  #!EL  #!N 
#!N Function #!N #!N Reads an image from an image file. 
#!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N image #!EF 
= ReadImage(  #!F-adobe-times-bold-r-normal--18*   name, format, start, end, delta, width, height #!EF 
); #!EF #!N #!N #!EC #!N #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   
#!N TAB Name TAB Type TAB Default TAB Description #!EF #!N 
TAB name TAB string TAB "image" TAB file name #!N TAB 
format TAB string TAB "rgb" or input dependent TAB file format 
#!N TAB start TAB integer TAB first frame TAB first movie 
frame #!N TAB end TAB integer TAB last frame TAB last 
movie frame #!N TAB delta TAB integer TAB 1 TAB delta 
of images to be read #!N TAB width TAB integer TAB 
input dependent TAB width of image #!N TAB height TAB integer 
TAB input dependent TAB height of image #!N TAB delayed TAB 
flag TAB environment dependent TAB use delayed colors if present in 
#!N TAB - TAB - TAB - TAB file #!N TAB 
colortype TAB string TAB environment dependent TAB data type for colors 
#!N TAB - TAB - TAB - TAB #!EF #!N #!N 
Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Description 
#!EF #!N TAB image TAB image or image series TAB resulting 
image #!N TAB - TAB - TAB #!EF #!N #!N Functional 
Details #!N #!N This module supports four basic file formats: RGB 
and TIFF (Tag Image File Format), GIF (Graphics Interchange Format), and 
MIFF. #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   name #!EF 
#!EF #!I50 #!N is the name of the image file. #!N 
#!N If  #!F-adobe-times-bold-r-normal--18*   name #!EF contains a series, the parameters  #!F-adobe-times-bold-r-normal--18*   
start #!EF ,  #!F-adobe-times-bold-r-normal--18*   end #!EF , and  #!F-adobe-times-bold-r-normal--18*   delta #!EF 
can be used to read a subset of the images (see 
parameter descriptions). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   format #!EF #!EF #!I50 
#!N specifies the format of the image file. This parameter is 
not required if  #!F-adobe-times-bold-r-normal--18*   name #!EF includes a file extension defining 
the format (see following table). If  #!F-adobe-times-bold-r-normal--18*   name #!EF is specified 
without the appropriate extension, then the file format must be specified. 
If  #!F-adobe-times-bold-r-normal--18*   format #!EF is specified as "rgb," and  #!F-adobe-times-bold-r-normal--18*   name 
#!EF is "image," the module will first try to open image.rgb. 
If that fails, it will then try to open image. #!T,1,186,321,506,641 
 #!F-adobe-times-bold-r-normal--18*   #!N TAB File Type TAB Format Specifier TAB Expected File 
Extension(s) TAB Multiframe/Series Data #!N TAB - TAB - TAB - 
TAB #!EF #!N TAB RGB TAB "rgb" TAB .rgb and .size 
TAB Yes #!N TAB - TAB "r+g+b" TAB .r, .g, .b, 
.size, TAB #!N TAB TIFF TAB "tiff" TAB .tiff TAB Yes 
#!N TAB GIF TAB "gif" TAB .gif TAB No #!N TAB 
MIFF TAB "miff" TAB .miff TAB Yes #!N #!T,0 #!N #!N 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   start #!EF  #!F-adobe-times-medium-r-normal--18*   and #!EF  #!F-adobe-times-bold-r-normal--18*   
end #!EF #!EF #!I50 #!N specify the first and last frame 
to be read from an image file containing a series. #!N 
#!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   delta #!EF #!EF #!I50 #!N specifies the 
increment in counting the frames in the range from  #!F-adobe-times-bold-r-normal--18*   start 
#!EF to  #!F-adobe-times-bold-r-normal--18*   end #!EF . For example, if the first 
and last frames are 10 and 20 respectively, and  #!F-adobe-times-bold-r-normal--18*   delta 
#!EF = 2, the output (  #!F-adobe-times-bold-r-normal--18*   image #!EF ) is 
a series group with six members (indexed from 0 to 5). 
Frame numbers (10, 12,..., 20 in this example) are preserved as 
the series position number. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   width #!EF 
 #!F-adobe-times-medium-r-normal--18*   and #!EF  #!F-adobe-times-bold-r-normal--18*   height #!EF #!EF #!I50 #!N are used 
only for RGB format files. The module obtains information about the 
size and number of images from  #!F-adobe-times-bold-r-normal--18*   name.size #!EF , an 
ASCII file containing the string "  #!F-adobe-times-bold-i-normal--18*   w #!EF *  #!F-adobe-times-bold-i-normal--18*   
h #!EF *  #!F-adobe-times-bold-i-normal--18*   f #!EF ," (where  #!F-adobe-times-bold-i-normal--18*   w #!EF 
and  #!F-adobe-times-bold-i-normal--18*   h #!EF are pixel width and height of image 
respectively, and  #!F-adobe-times-bold-i-normal--18*   f #!EF is the number of frames). #!N 
#!N If the  #!F-adobe-times-bold-r-normal--18*   .size #!EF file is not available, then 
 #!F-adobe-times-bold-r-normal--18*   width #!EF and  #!F-adobe-times-bold-r-normal--18*   height #!EF can be used to 
specify the size of the image(s). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
delayed #!EF #!EF #!I50 #!N specifies whether ReadImage should create a 
"delayed color" image if the image file is stored in an 
"image with colormap" format. By default, ReadImage will create a "delayed 
color" image if possible, unless the environment variable DXDELAYEDCOLORS is set 
to 0, or the  #!F-adobe-times-bold-r-normal--18*   delayed #!EF parameter is set to 
0. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   colortype #!EF #!EF #!I50 #!N 
specifies whether the colors in the image should be byte or 
floating point. By default, ReadImage will create byte colors unless the 
DXPIXELTYPE environment variable is set to DXFloat, or  #!F-adobe-times-bold-r-normal--18*   colortype #!EF 
is set to "float." #!I0 #!N #!N #!N #!N #!I0 #!N 
Notes: #!N #!I30 #!N 1. RGB format files can be either 
"rgb" or "r+g+b." The file format "rgb" contains the image with 
the bytes for the red, green, and blue values interleaved. An 
alternate file format is "r+g+b," where three output files contain the 
non-interleaved image: "  #!F-adobe-times-bold-r-normal--18*   name.r #!EF ," "  #!F-adobe-times-bold-r-normal--18*   name.g #!EF 
," and "  #!F-adobe-times-bold-r-normal--18*   name.b #!EF ." #!N #!N TIFF format 
files must be either full color RGB images (TIFF Class R) 
or palette color RGB images (TIFF Class P), uncompressed ("Compression=1"), and 
interleaved ("PlanarConfiguration=1"). If the extension is not part of the name, 
the format must be set to "tiff." Information about the size 
of the image is obtained from the file itself, since TIFF 
files are self-describing. (For more information on file formats, see  #!Lwriteim,dxall981 h WriteImage  #!EL  
.) #!N #!I30 #!N 2. The default behavior of ReadImage is 
different in Data Explorer version 3.1.4 and above in terms of 
the type of image it creates internally. If you do not 
specify the environment variable DXPIXELTYPE as "DXFloat," ReadImage will create byte 
colors internally. This will result in reduced storage required for the 
image, and will only affect networks that require the colors to 
be of type float, in which case the ReadImage parameter "colortype" 
should be set to "float," or the DXPIXELTYPE environment variable should 
be set to "DXFloat." #!N #!I30 #!N 3. ReadImage will also 
maintain the delayed color status of an image, as will be 
the case for GIF, some TIFF, and some MIFF format files. 
If the visualization program requires full colors for each pixel, set 
the ReadImage "delayed" parameter to false (0) or set the environment 
variable DXDELAYEDCOLORS to 0. #!N #!I30 #!N 4. If you want 
to convert an image file that does not already have delayed 
colors to one that does, use ReadImage to load it in 
and then use QuantizeImage to make it delayed color. #!I0 #!N 
#!N #!N #!N Components #!N #!N Creates an output with "positions," 
"connections," and "colors" components. #!N #!N Example Visual Programs #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N ReadImage.net #!N UsingFilter.net #!EF #!N #!N #!EC #!N 
#!N See Also #!N #!N  #!Lwriteim,dxall981 h WriteImage  #!EL  #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next 
Topic #!EF #!N #!N  #!Lreadimw,dxall916 h ReadImageWindow  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N 
