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.

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

read_world_file is reentrant and processed without parallelization.

hom_mat2d_invert, affine_trans_contour_xld, affine_trans_polygon_xld

write_contour_xld_arc_info, read_contour_xld_arc_info, write_polygon_xld_arc_info, read_polygon_xld_arc_info

Sub-pixel operators