HALCON Website / HALCON Operator Reference / File / Misc
ClassesClassesClassesClasses | | | | Operators

read_world_fileT_read_world_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile (Operator)

Name

read_world_fileT_read_world_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile — 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)

Herror 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 HOperatorSetX.ReadWorldFile(
[in] VARIANT FileName, [out] VARIANT* WorldTransformation)

void HHomMat2DX.ReadWorldFile([in] BSTR FileName)

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

void HHomMat2D.ReadWorldFile(string fileName)

Description

read_world_fileread_world_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile reads a geocoding from an ARC/INFO world file with the file name FileNameFileNameFileNameFileNameFileNamefileName and returns it as a homogeneous 2D transformation matrix in WorldTransformationWorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation. To find the file FileNameFileNameFileNameFileNameFileNamefileName, all directories contained in the HALCON system variable 'image_dir'"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_imageReadImageread_imageReadImageReadImage). 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_infoWriteContourXldArcInfowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfo. If the matrix WorldTransformationWorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation is inverted by calling hom_mat2d_inverthom_mat2d_invertHomMat2dInverthom_mat2d_invertHomMat2dInvertHomMat2dInvert, the resulting matrix can be used to transform contours that have been read with read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfo to the image coordinate system.

Parallelization

Parameters

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of the ARC/INFO world file.

WorldTransformationWorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation (output_control)  hom_mat2d → HHomMat2D, HTupleHTupleHTupleHHomMat2DX, VARIANTHtuple (real) (double) (double) (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_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Successors

hom_mat2d_inverthom_mat2d_invertHomMat2dInverthom_mat2d_invertHomMat2dInvertHomMat2dInvert, affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXld, affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXld

See also

write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfo, read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfo, write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfo, read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfo

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH