read_world_file — Read the geo coding from an ARC/INFO world file.
read_world_file reads a geocoding from an ARC/INFO world
file with the file name
FileName and returns it as a
homogeneous 2D transformation matrix in
To find the file
FileName, all directories contained in the
HALCON system variable 'image_dir' (usually this is the
content of the environment variable HALCONIMAGES) are searched (see
read_image). This transformation matrix can be used to
transform XLD contours to the world coordinate system before writing
write_contour_xld_arc_info. If the matrix
WorldTransformation is inverted by calling
hom_mat2d_invert, the resulting matrix can be used to
transform contours that have been read with
read_contour_xld_arc_info to the image coordinate system.
Name of the ARC/INFO world file.
Transformation matrix from image to world coordinates.
If the parameters are correct and the world file could be read, the
read_world_file returns the value 2 (H_MSG_TRUE). Otherwise
an exception is raised.