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.
|
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 | |
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.
::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