write_polygon_xld_arc_info ( Polygons : : FileName : )

Write XLD polygons to a file in ARC/INFO generate format.

write_polygon_xld_arc_info writes the XLD polygons Polygons to an ARC/INFO generate format file with name FileName. If no absolute path is given in FileName, the output file is created in the current directory of the HALCON process. The polygons must have been transformed to the world coordinate system with affine_trans_polygon_xld beforehand. The necessary transformation can be read from an ARC/INFO world file with read_world_file.


Attention

The XLD contours that are possibly referenced by Polygons are not stored in the ARC/INFO file, since this is not possible with the ARC/INFO generate file format. Therefore, when the polygons are read again using read_polygon_xld_arc_info, this information is lost, and no references to contours are generated for the polygons. Hence, operators that access the contours associated with a polygon, e.g., split_contours_xld will not work correctly.


Parameters

Polygons (input_object)
xld_poly(-array) -> object
XLD polygons to be written.

FileName (input_control)
filename -> string
Name of the ARC/INFO file.


Example
/* Read transformation and image */
read_world_file ('image.tfw', WorldTransformation)
read_image (Image, 'image.tif')
/* Segment image */
...
/* Write result */
affine_trans_polygon_xld (Polygons, PolygonsWorld, WorldTransformation)
write_polygon_xld_arc_info (PolygonsWorld, 'result.gen')

Result

If the parameters are correct and the file could be written, the operator write_polygon_xld_arc_info returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.


Parallelization Information

write_polygon_xld_arc_info is reentrant and processed without parallelization.


Possible Predecessors

affine_trans_polygon_xld


See also

read_world_file, read_polygon_xld_arc_info, write_contour_xld_arc_info


Module

Sub-pixel operators



Copyright © 1996-2005 MVTec Software GmbH