write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfo (Operator)

Name

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

Signature

write_polygon_xld_arc_info(Polygons : : FileName : )

Herror write_polygon_xld_arc_info(const Hobject Polygons, const char* FileName)

Herror T_write_polygon_xld_arc_info(const Hobject Polygons, const Htuple FileName)

void WritePolygonXldArcInfo(const HObject& Polygons, const HTuple& FileName)

void HXLDPoly::WritePolygonXldArcInfo(const HString& FileName) const

void HXLDPoly::WritePolygonXldArcInfo(const char* FileName) const

void HXLDPoly::WritePolygonXldArcInfo(const wchar_t* FileName) const   (Windows only)

static void HOperatorSet.WritePolygonXldArcInfo(HObject polygons, HTuple fileName)

void HXLDPoly.WritePolygonXldArcInfo(string fileName)

Description

write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfoWritePolygonXldArcInfo writes the XLD polygons PolygonsPolygonsPolygonsPolygonspolygons to an ARC/INFO generate format file with name FileNameFileNameFileNameFileNamefileName. If no absolute path is given in FileNameFileNameFileNameFileNamefileName, 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_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXld beforehand. The necessary transformation can be read from an ARC/INFO world file with read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFile.

Attention

The XLD contours that are possibly referenced by PolygonsPolygonsPolygonsPolygonspolygons 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_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInfo, 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_xldsplit_contours_xldSplitContoursXldSplitContoursXldSplitContoursXld will not work correctly.

Execution Information

Parameters

PolygonsPolygonsPolygonsPolygonspolygons (input_object)  xld_poly(-array) objectHXLDPolyHXLDPolyHobject

XLD polygons to be written.

FileNameFileNameFileNameFileNamefileName (input_control)  filename.write HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the ARC/INFO file.

Example (HDevelop)

* 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_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfoWritePolygonXldArcInfo returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXld

See also

read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFile, read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInfo, write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfoWriteContourXldArcInfo

Module

Foundation