read_deformable_surface_modelT_read_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModel (Operator)
Name
read_deformable_surface_modelT_read_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModel — Liest ein deformierbares Oberflächenmodell aus einer Datei.
Signatur
Beschreibung
read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModel liest ein deformierbares
Oberflächenmodell welches
zuvor mittels write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModel geschrieben wurde aus
der Datei FileNameFileNameFileNameFileNamefileName ein.
Das Handle des eingelesenen deformierbaren Oberflächenmodells wird in
DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel zurückgegeben.
Enthält FileNameFileNameFileNameFileNamefileName keine absolute Pfadangabe, so wird die
Datei im aktuellen Verzeichniss des HALCON-Prozesses gesucht.
Die Standard-Dateiendung für deformierbare Oberflächenmodelle in HALCON
ist 'dsfm'.
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 → HTupleHTupleHtuple (string) (string) (HString) (char*)
Dateiname der DSFM-Datei.
Dateiendung: .dsfm
DeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModelDeformableSurfaceModeldeformableSurfaceModel (output_control) deformable_surface_model → HDeformableSurfaceModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des gelesenen deformierbaren
Oberflächenmodells.
Ergebnis
Wenn alle Parameter korrekt sind und die Datei gelesen werden konnte
liefert read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModel 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
write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModel
Nachfolger
find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel,
refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel,
get_deformable_surface_model_paramget_deformable_surface_model_paramGetDeformableSurfaceModelParamGetDeformableSurfaceModelParamGetDeformableSurfaceModelParam,
clear_deformable_surface_modelclear_deformable_surface_modelClearDeformableSurfaceModelClearDeformableSurfaceModelClearDeformableSurfaceModel
Alternativen
create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModel
Siehe auch
create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModel,
write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModel
Modul
3D Metrology