Herror ::read_world_file (
    const HTuple &FileName,
    HTuple *WorldTransformation
)

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 WorldTransformation. 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 them with ::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.


Parameters

FileName (input_control)
filename -> HTuple.char *
Name of the ARC/INFO world file.

WorldTransformation (output_control)
affine2d-array -> HTuple.double *
Transformation matrix from image to world coordinates.
Number of elements: 6


Result

If the parameters are correct and the world file could be read, the operator ::read_world_file returns the value H_MSG_TRUE. Otherwise an exception is raised.


Possible Successors

::hom_mat2d_invert, ::affine_trans_contour_xld, ::affine_trans_polygon_xld


See also

::write_contour_xld_arc_info, ::read_contour_xld_arc_info, ::write_polygon_xld_arc_info, ::read_polygon_xld_arc_info


Module

Sub-pixel operators



Copyright © 1996-2002 MVTec Software GmbH