read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file (Operator)
Name
read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file — Read the geo coding from an ARC/INFO world file.
Signature
def read_world_file(file_name: str) -> Sequence[float]
Description
read_world_fileread_world_fileReadWorldFileReadWorldFileread_world_file reads a geocoding from an ARC/INFO world
file with the file name FileNameFileNameFileNamefileNamefile_name and returns it as a
homogeneous 2D transformation matrix in WorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation.
To find the file FileNameFileNameFileNamefileNamefile_name, all directories contained in the
HALCON system variable 'image_dir'"image_dir""image_dir""image_dir""image_dir" (usually this is the
content of the environment variable HALCONIMAGES) are searched (see
read_imageread_imageReadImageReadImageread_image). This transformation matrix can be used to
transform XLD contours to the world coordinate system before writing
them with write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info. If the matrix
WorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation is inverted by calling
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInverthom_mat2d_invert, the resulting matrix can be used to
transform contours that have been read with
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info to the image coordinate system.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the ARC/INFO world file.
WorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation (output_control) hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Transformation matrix from image to world coordinates.
Result
If the parameters are correct and the world file could be read, the
operator read_world_fileread_world_fileReadWorldFileReadWorldFileread_world_file returns the value 2 (
H_MSG_TRUE)
. Otherwise
an exception is raised.
Possible Successors
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInverthom_mat2d_invert,
affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXldaffine_trans_contour_xld,
affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldaffine_trans_polygon_xld
See also
write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info,
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info,
write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info,
read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info
Module
Foundation