Operator Reference

HALCON Operator Reference / File / Misc

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file (Operator)

read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file — Read the geo coding from an ARC/INFO world file.

Signature

read_world_file( : : FileName : WorldTransformation)

Herror T_read_world_file(const Htuple FileName, Htuple* WorldTransformation)

void ReadWorldFile(const HTuple& FileName, HTuple* WorldTransformation)

void HHomMat2D::ReadWorldFile(const HString& FileName)

void HHomMat2D::ReadWorldFile(const char* FileName)

void HHomMat2D::ReadWorldFile(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadWorldFile(HTuple fileName, out HTuple worldTransformation)

void HHomMat2D.ReadWorldFile(string fileName)

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

---

ClassesClasses | | Operators