read_surface_model
— Liest ein Oberflächenmodell aus einer Datei.
read_surface_model( : : FileName : SurfaceModelID)
read_surface_model
liest ein Oberflächenmodell welches zuvor
mittels write_surface_model
geschrieben wurde aus der Datei
FileName
ein.
Das Handle des eingelesenen Oberflächenmodells wird in
SurfaceModelID
zurückgegeben.
Enthält FileName
keine absolute Pfadangabe, so wird die
Datei im aktuellen Verzeichniss des HALCON-Prozesses gesucht.
Die Standard-Dateiendung für Oberflächenmodelle in HALCON ist 'sfm'.
Existiert die Datei FileName
nicht, so wird diese
Standard-Dateiendung angehängt und erneut gesucht.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
FileName
(input_control) filename.read →
(string)
Dateiname der SFM-Datei.
Dateiendung: .sfm
SurfaceModelID
(output_control) surface_model →
(handle)
Handle des gelesenen Oberflächenmodells.
Wenn alle Parameter korrekt sind und die Datei gelesen werden konnte
liefert read_surface_model
den Wert 2 (H_MSG_TRUE).
Wenn die Datei kein Oberflächenmodell enthält wird der Fehler 9506
zurückgegeben.
Enthält die Datei ein Oberflächenmodell in einer Version, die nicht mit
dieser HALCON-Version gelesen werden kann, wird der Fehler 9507
zurückgegeben.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
read_object_model_3d
,
xyz_to_object_model_3d
find_surface_model
,
refine_surface_model_pose
,
get_surface_model_param
,
clear_surface_model
,
find_surface_model_image
,
refine_surface_model_pose_image
create_surface_model
,
write_surface_model
3D Metrology