write_polygon_xld_arc

Herror ::write_polygon_xld_arc_info ( Hobject Polygons, const HTuple &FileName ) void HXLDPoly::WritePolygonXldArcInfo ( const HTuple &FileName ) const void HXLDPolyArray::WritePolygonXldArcInfo ( const HTuple &FileName ) const

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) `->` Hobject: HXLDPoly(Array)
XLD polygons to be written.

`FileName` (input_control)	filename `->` HTuple.char *
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 H_MSG_TRUE. Otherwise an exception is raised.

Possible Predecessors

::affine_trans_polygon_xld

Module

Sub-pixel operators