read_world_fileT_read_world_fileReadWorldFileReadWorldFile (Operator)
Name
read_world_fileT_read_world_fileReadWorldFileReadWorldFile — Lesen der Geokodierung aus einem ARC/INFO World File.
Signatur
Beschreibung
read_world_fileread_world_fileReadWorldFileReadWorldFileReadWorldFile liest die Geokodierung aus dem ARC/INFO
World File mit Namen FileNameFileNameFileNameFileNamefileName aus, und liefert sie als
homogene 2D-Transformationsmatrix in WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation
zurück. Dabei werden alle Verzeichnisse, die in der
HALCON-Systemvariablen 'image_dir'"image_dir""image_dir""image_dir""image_dir" bzw. in der
Umgebungsvariablen HALCONIMAGES enthalten sind, nach der Datei
FileNameFileNameFileNameFileNamefileName durchsucht (siehe read_imageread_imageReadImageReadImageReadImage). Die
Transformationsmatrix kann verwendet werden, um XLD-Konturen vor dem
Schreiben mit write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfoWriteContourXldArcInfo in Weltkoordinaten
zu transformieren. Wenn die Matrix WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation mit
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInvert invertiert wird, kann die so entstehende
Matrix verwendet werden, um Konturen, die mit
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfoReadContourXldArcInfo 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
FileNameFileNameFileNameFileNamefileName (input_control) filename.read → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name des ARC/INFO World Files.
WorldTransformationWorldTransformationWorldTransformationWorldTransformationworldTransformation (output_control) hom_mat2d → HHomMat2D, HTupleHTupleHtuple (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_fileReadWorldFileReadWorldFileReadWorldFile den Wert
2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
hom_mat2d_inverthom_mat2d_invertHomMat2dInvertHomMat2dInvertHomMat2dInvert,
affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXldAffineTransContourXld,
affine_trans_polygon_xldaffine_trans_polygon_xldAffineTransPolygonXldAffineTransPolygonXldAffineTransPolygonXld
Siehe auch
write_contour_xld_arc_infowrite_contour_xld_arc_infoWriteContourXldArcInfoWriteContourXldArcInfoWriteContourXldArcInfo,
read_contour_xld_arc_inforead_contour_xld_arc_infoReadContourXldArcInfoReadContourXldArcInfoReadContourXldArcInfo,
write_polygon_xld_arc_infowrite_polygon_xld_arc_infoWritePolygonXldArcInfoWritePolygonXldArcInfoWritePolygonXldArcInfo,
read_polygon_xld_arc_inforead_polygon_xld_arc_infoReadPolygonXldArcInfoReadPolygonXldArcInfoReadPolygonXldArcInfo
Modul
Foundation