read_info ( : : Format, FileName : Width, Height, PixelType, Channels, FormatFound )

Query information about an image file.

The operator read_info queries the image size (Width, Height), the pixel type (PixelType), the number of (color) channels (Channels) and the kind of graphic type (FormatFound). The name of the file without extension and the name of the graphic format are indicated. The extension of the file must be available corresponding to the convention. The image file is searched along the search path (see read_image). If the empty string is the input all graphic formats are checked. In this case the parameter FormatFound is set at the type found.


Attention

The pixel type refers to the transformation into HORUS types, not the types of the original data.


Parameters

Format (input_control)
string -> string
Type of graphic file or empty string.
Default value: 'image'
List of values: 'image', 'xwd', 'tiff', 'ras', 'pcx', 'gif'

FileName (input_control)
filename.named -> string
Name of file without extension.
Default value: 'affe'

Width (output_control)
extent.x -> integer
Height of image

Height (output_control)
extent.y -> integer
Width of image

PixelType (output_control)
string -> string
Type of pixels
List of values: 'byte', 'long', 'real'

Channels (output_control)
integer -> integer
Number of channels
List of values: 1, 3

FormatFound (output_control)
string -> string
Type of graphic format found
List of values: 'image', 'xwd', 'tiff', 'ras', 'pcx', 'gif'


Example
read_info(::'image','bild7':Width,Height,_,_) >
init_horus(::Width,Height,3:) >
read_image(:Img:'bild7':).

Result

If the indicated file is available and the format is correct read_info returns the value TRUE. Otherwise an exception is raised.


Possible Predecessors

init_horus


Possible Successors

read_image, read_picture, disp_image


See also

read_image, read_sequence, read_picture



Copyright © 1996-1997 MVTec Software GmbH