read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file (Operator)
Name
read_world_fileT_read_world_fileReadWorldFileReadWorldFileread_world_file — Lesen der Geokodierung aus einem ARC/INFO World File.
Signatur
def read_world_file(file_name: str) -> Sequence[float]
Beschreibung
read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFileread_world_file liest die Geokodierung aus dem ARC/INFO
World File mit Namen FileNameFileNameFileNameFileNamefileNamefile_name aus, und liefert sie als
homogene 2D-Transformationsmatrix in WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation
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
Transformationsmatrix kann verwendet werden, um XLD-Konturen vor dem
Schreiben mit write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info in Weltkoordinaten
zu transformieren. Wenn die Matrix WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation mit
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInverthom_mat2d_invert invertiert wird, kann die so entstehende
Matrix verwendet werden, um Konturen, die mit
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info eingelesen worden sind, in das
Bildkoordinatensystem zu transformieren.
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
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name des ARC/INFO World Files.
WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformationworld_transformation (output_control) hom_mat2d → HHomMat2D, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Transformationsmatrix von Bild- in Weltkoordinaten.
Ergebnis
Wenn die Parameter korrekt sind und das angegebene World File
gelesen werden konnte, liefert read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFileread_world_file den Wert
2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInverthom_mat2d_invert,
affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXldAffineTransContourXldaffine_trans_contour_xld,
affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXldaffine_trans_polygon_xld
Siehe auch
write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfoWriteContourXldArcInfowrite_contour_xld_arc_info,
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfoReadContourXldArcInforead_contour_xld_arc_info,
write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfoWritePolygonXldArcInfowrite_polygon_xld_arc_info,
read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInforead_polygon_xld_arc_info
Modul
Foundation