Operator Reference

HALCON Operator Reference / File / XLD
ClassesClasses | | Operators

read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info (Operator)

read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info — Read XLD contours to a file in ARC/INFO generate format.

Signature

read_contour_xld_arc_info( : Contours : FileName : )

Herror read_contour_xld_arc_info(Hobject* Contours, const char* FileName)

Herror T_read_contour_xld_arc_info(Hobject* Contours, const Htuple FileName)

void ReadContourXldArcInfo(HObject* Contours, const HTuple& FileName)

void HXLDCont::ReadContourXldArcInfo(const HString& FileName)

void HXLDCont::ReadContourXldArcInfo(const char* FileName)

void HXLDCont::ReadContourXldArcInfo(const wchar_t* FileName)   ( Windows only)

static void HOperatorSet.ReadContourXldArcInfo(out HObject contours, HTuple fileName)

void HXLDCont.ReadContourXldArcInfo(string fileName)

def read_contour_xld_arc_info(file_name: str) -> HObject

Description

read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info reads the lines stored in ARC/INFO generate format in the file FileNameFileNameFileNamefileNamefile_name, and returns them as XLD contours in ContoursContoursContourscontourscontours. 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). The returned contours are in world coordinates. They can be transformed to the image coordinate system with the operator affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXldaffine_trans_contour_xld. The necessary transformation matrix can be generated by using read_world_fileread_world_fileReadWorldFileReadWorldFileread_world_file to read the transformation matrix from image to world coordinates, and inverting this matrix by calling hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInverthom_mat2d_invert.

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

ContoursContoursContourscontourscontours (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Read XLD contours.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the ARC/INFO file.

Example (HDevelop)

* Read the transformation and invert it
read_world_file ('image.tfw', WorldTransformation)
hom_mat2d_invert (WorldTransformation, ImageTransformation)
* Read the image
read_image (Image, 'image.tif')
* Read the line data
read_contour_xld_arc_info (LinesWorld, 'lines.gen')
* Transform the line data to image coordinates
affine_trans_contour_xld (LinesWorld, Lines, ImageTransformation)

Result

If the parameters are correct and the file could be read, the operator read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info 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

See also

read_world_fileread_world_fileReadWorldFileReadWorldFileread_world_file, write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info, read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info

Module

Foundation

ClassesClasses | | Operators