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