read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModel (Operator)

Name

read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModel — Liest ein Oberflächenmodell aus einer Datei.

Signatur

read_surface_model( : : FileName : SurfaceModelID)

Beschreibung

read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModel liest ein Oberflächenmodell welches zuvor mittels write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModel geschrieben wurde aus der Datei FileNameFileNameFileNameFileNamefileName ein. Das Handle des eingelesenen Oberflächenmodells wird in SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID zurückgegeben. Enthält FileNameFileNameFileNameFileNamefileName 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 FileNameFileNameFileNameFileNamefileName 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

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Dateiname der SFM-Datei.

Dateiendung: .sfm

SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID (output_control) surface_model → (integer)

Handle des gelesenen Oberflächenmodells.

Ergebnis

Wenn alle Parameter korrekt sind und die Datei gelesen werden konnte liefert read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModel 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.

Vorgänger

read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d

Nachfolger

find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose, get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParam, clear_surface_modelclear_surface_modelClearSurfaceModelClearSurfaceModelClearSurfaceModel, find_surface_model_imagefind_surface_model_imageFindSurfaceModelImageFindSurfaceModelImageFindSurfaceModelImage, refine_surface_model_pose_imagerefine_surface_model_pose_imageRefineSurfaceModelPoseImageRefineSurfaceModelPoseImageRefineSurfaceModelPoseImage