read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info (Operator)
Name
read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info — Lesen von XLD-Polygonen im ARC/INFO-Generate-Format.
Signatur
def read_polygon_xld_arc_info(file_name: str) -> HObject
Beschreibung
read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info liest die in der Datei
FileNameFileNameFileNameFileNamefileNamefile_name im ARC/INFO-Generate-Format gespeicherten Linien
ein und liefert sie als XLD-Polygone in PolygonsPolygonsPolygonsPolygonspolygonspolygons zurück.
Dabei werden alle Verzeichnisse, die in der HALCON-Systemvariablen
'image_dir'"image_dir""image_dir""image_dir""image_dir""image_dir" bzw. in der Umgebungsvariablen HALCONIMAGES
enthalten sind, nach der Datei FileNameFileNameFileNameFileNamefileNamefile_name durchsucht (siehe
read_imageread_imageReadImageReadImageReadImageread_image). Die eingelesenen Polygone liegen im
Weltkoordinatensystem vor. Der Operator
affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXldaffine_trans_polygon_xld kann verwendet werden, um sie in
das Bildkoordinatensystem zu transformieren. Die dazu notwendige
Transformationsmatrix kann erzeugt werden, indem mit
read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFileread_world_file aus einem ARC/INFO World File die
Transformationsmatrix von Bild- nach Weltkoordinatensystem gelesen
wird, und diese mit hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInverthom_mat2d_invert invertiert wird.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
PolygonsPolygonsPolygonsPolygonspolygonspolygons (output_object) xld_poly(-array) → objectHXLDPolyHObjectHXLDPolyHobject *
Eingelesene XLD-Polygone.
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der ARC/INFO-Datei.
Beispiel (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)
Ergebnis
Wenn die Parameter korrekt sind und die angegebene Datei gelesen
werden konnte, liefert read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info den Wert
2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInverthom_mat2d_invert,
affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXldaffine_trans_polygon_xld
Siehe auch
read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFileread_world_file,
write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info,
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info
Modul
Foundation