ClassesClassesClassesClasses | | | | Operators

read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfo (Operator)

Name

read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfo — Read XLD polygons from a file in ARC/INFO generate format.

Signature

read_polygon_xld_arc_info( : Polygons : FileName : )

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

Herror T_read_polygon_xld_arc_info(Hobject* Polygons, const Htuple FileName)

Herror read_polygon_xld_arc_info(Hobject* Polygons, const HTuple& FileName)

HXLDPoly HXLDPoly::ReadPolygonXldArcInfo(const HTuple& FileName)

HXLDPolyArray HXLDPolyArray::ReadPolygonXldArcInfo(const HTuple& FileName)

void ReadPolygonXldArcInfo(HObject* Polygons, const HTuple& FileName)

void HXLDPoly::ReadPolygonXldArcInfo(const HString& FileName)

void HXLDPoly::ReadPolygonXldArcInfo(const char* FileName)

void HOperatorSetX.ReadPolygonXldArcInfo(
[out] IHUntypedObjectX*Polygons, [in] VARIANT FileName)

void HXLDPolyX.ReadPolygonXldArcInfo([in] BSTR FileName)

static void HOperatorSet.ReadPolygonXldArcInfo(out HObject polygons, HTuple fileName)

void HXLDPoly.ReadPolygonXldArcInfo(string fileName)

Description

read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfo reads the lines stored in ARC/INFO generate format in the file FileNameFileNameFileNameFileNameFileNamefileName, and returns them as XLD polygons in PolygonsPolygonsPolygonsPolygonsPolygonspolygons. To find the file FileNameFileNameFileNameFileNameFileNamefileName, all directories contained in the HALCON system variable 'image_dir'"image_dir""image_dir""image_dir""image_dir""image_dir" (usually this is the content of the environment variable HALCONIMAGES) are searched (see read_imageread_imageReadImageread_imageReadImageReadImage). The returned polygons are in world coordinates. They can be transformed to the image coordinate system with the operator affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXld. The necessary transformation matrix can be generated by using read_world_fileread_world_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile to read the transformation matrix from image to world coordinates, and inverting this matrix by calling hom_mat2d_inverthom_mat2d_invertHomMat2dInverthom_mat2d_invertHomMat2dInvertHomMat2dInvert.

Parallelization

Parameters

PolygonsPolygonsPolygonsPolygonsPolygonspolygons (output_object)  xld_poly(-array) objectHXLDPolyHXLDPolyHXLDPolyHXLDPolyXHobject *

Read XLD polygons.

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name of the ARC/INFO file.

Example (HDevelop)

* 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)

Result

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

Possible Successors

hom_mat2d_inverthom_mat2d_invertHomMat2dInverthom_mat2d_invertHomMat2dInvertHomMat2dInvert, affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXld

See also

read_world_fileread_world_fileReadWorldFileread_world_fileReadWorldFileReadWorldFile, write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfo, read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfo

Module

Foundation


ClassesClassesClassesClasses | | | | Operators