read_contour_xld_arc

Herror ::read_contour_xld_arc_info ( Hobject *Contours, const HTuple &FileName ) HXLDCont HXLDCont::ReadContourXldArcInfo ( const HTuple &FileName ) HXLDContArray HXLDContArray::ReadContourXldArcInfo ( const HTuple &FileName )

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

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

Parameters

`Contours` (output_object)	xld_cont(-array) `->` Hobject : HXLDCont(Array)*
Read XLD contours.

`FileName` (input_control)	filename `->` HTuple.char *
Name of the ARC/INFO file.

Example

/* 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_info returns the value H_MSG_TRUE. Otherwise an exception is raised.

Possible Successors

::hom_mat2d_invert, ::affine_trans_contour_xld

Module

Sub-pixel operators