read_polygon_xld_arc_info — Read XLD polygons from a file in ARC/INFO generate format.
read_polygon_xld_arc_info reads the lines stored in ARC/INFO
generate format in the file
FileName, and returns them as
XLD polygons in
Polygons. 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 polygons are in world
coordinates. They can be transformed to the image coordinate system
with the operator
affine_trans_polygon_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
Read XLD polygons.
Name of the ARC/INFO file.
* 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_polygon_xld_arc_info (LinesWorld, 'lines.gen') * Transform the line data to image coordinates affine_trans_polygon_xld (LinesWorld, Lines, ImageTransformation)
If the parameters are correct and the file could be read, the
read_polygon_xld_arc_info returns the value 2 (H_MSG_TRUE).
Otherwise an exception is raised.