read_surface_modelT_read_surface_modelReadSurfaceModelReadSurfaceModelread_surface_model (Operator)
Name
read_surface_modelT_read_surface_modelReadSurfaceModelReadSurfaceModelread_surface_model — Liest ein Oberflächenmodell aus einer Datei.
Signatur
def read_surface_model(file_name: str) -> HHandle
Beschreibung
read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModelread_surface_model liest ein Oberflächenmodell welches zuvor
mittels write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModelwrite_surface_model geschrieben wurde aus der Datei
FileNameFileNameFileNameFileNamefileNamefile_name ein.
Das Handle des eingelesenen Oberflächenmodells wird in
SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelIDsurface_model_id zurückgegeben.
Enthält FileNameFileNameFileNameFileNamefileNamefile_name keine absolute Pfadangabe, so wird die
Datei im aktuellen Verzeichnis des HALCON-Prozesses gesucht.
Die Standard-Dateiendung für Oberflächenmodelle in HALCON ist 'sfm'.
Existiert die Datei FileNameFileNameFileNameFileNamefileNamefile_name nicht, so wird diese
Standard-Dateiendung angehängt und erneut gesucht.
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.
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.
Parameter
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Dateiname der SFM-Datei.
Dateiendung: .sfm
SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelIDsurface_model_id (output_control) surface_model → HSurfaceModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des gelesenen Oberflächenmodells.
Ergebnis
Wenn alle Parameter korrekt sind und die Datei gelesen werden konnte
liefert read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModelread_surface_model den Wert 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.
Vorgänger
read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3dread_object_model_3d,
xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3dxyz_to_object_model_3d
Nachfolger
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModelfind_surface_model,
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPoserefine_surface_model_pose,
get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParamget_surface_model_param,
clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModelclear_surface_model,
find_surface_model_imagefind_surface_model_imageFindSurfaceModelImageFindSurfaceModelImageFindSurfaceModelImagefind_surface_model_image,
refine_surface_model_pose_imagerefine_surface_model_pose_imageRefineSurfaceModelPoseImageRefineSurfaceModelPoseImageRefineSurfaceModelPoseImagerefine_surface_model_pose_image
Alternativen
create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model
Siehe auch
create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModelcreate_surface_model,
write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModelwrite_surface_model
Modul
3D Metrology