Operator Reference

HALCON Operator Reference / File / XLD
ClassesClasses | | Operators

write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info (Operator)

write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info — 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)

def write_polygon_xld_arc_info(polygons: HObject, file_name: str) -> None

Description

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

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_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_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_xldsplit_contours_xldSplitContoursXldSplitContoursXldsplit_contours_xld will not work correctly.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

PolygonsPolygonsPolygonspolygonspolygons (input_object)  xld_poly(-array) → objectHXLDPolyHObjectHObjectHobject

XLD polygons to be written.

FileNameFileNameFileNamefileNamefile_name (input_control)  filename.write → HTuplestrHTupleHtuple (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_infoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info returns the value 2 ( H_MSG_TRUE) . Otherwise an exception is raised.

Possible Predecessors

affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldaffine_trans_polygon_xld

See also

read_world_fileread_world_fileReadWorldFileReadWorldFileread_world_file, read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info, write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info

Module

Foundation

ClassesClasses | | Operators