HALCON Website / HALCON Operator-Referenz / 3D-Matching / Oberflächenbasiert
KlassenKlassenKlassenKlassen | | | | Operatoren

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel (Operator)

Name

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel — Liest ein Oberflächenmodell aus einer Datei.

Signatur

read_surface_model( : : FileName : SurfaceModelID)

Herror read_surface_model(const char* FileName, Hlong* SurfaceModelID)

Herror T_read_surface_model(const Htuple FileName, Htuple* SurfaceModelID)

Herror read_surface_model(const HTuple& FileName, Hlong* SurfaceModelID)

void HSurfaceModel::ReadSurfaceModel(const HTuple& FileName)

void ReadSurfaceModel(const HTuple& FileName, HTuple* SurfaceModelID)

void HSurfaceModel::HSurfaceModel(const HString& FileName)

void HSurfaceModel::HSurfaceModel(const char* FileName)

void HSurfaceModel::ReadSurfaceModel(const HString& FileName)

void HSurfaceModel::ReadSurfaceModel(const char* FileName)

void HOperatorSetX.ReadSurfaceModel(
[in] VARIANT FileName, [out] VARIANT* SurfaceModelID)

void HSurfaceModelX.ReadSurfaceModel([in] BSTR FileName)

static void HOperatorSet.ReadSurfaceModel(HTuple fileName, out HTuple surfaceModelID)

public HSurfaceModel(string fileName)

void HSurfaceModel.ReadSurfaceModel(string fileName)

Beschreibung

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel liest ein Oberflächenmodell welches zuvor mittels write_surface_modelwrite_surface_modelWriteSurfaceModelwrite_surface_modelWriteSurfaceModelWriteSurfaceModel geschrieben wurde aus der Datei FileNameFileNameFileNameFileNameFileNamefileName ein. Das Handle des eingelesenen Oberflächenmodells wird in SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID zurückgegeben. Enthält FileNameFileNameFileNameFileNameFileNamefileName 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 FileNameFileNameFileNameFileNameFileNamefileName nicht, so wird diese Standard-Dateiendung angehängt und erneut gesucht.

Parallelisierung

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

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Dateiname der SFM-Datei.

Dateiendung: .sfm

SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID (output_control)  surface_model → HSurfaceModel, HTupleHTupleHSurfaceModel, HTupleHSurfaceModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des gelesenen Oberflächenmodells.

Ergebnis

Wenn alle Parameter korrekt sind und die Datei gelesen werden konnte liefert read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel 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_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d

Nachfolger

find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose, get_surface_model_paramget_surface_model_paramGetSurfaceModelParamget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParam, clear_surface_modelclear_surface_modelClearSurfaceModelclear_surface_modelClearSurfaceModelClearSurfaceModel

Alternativen

create_surface_modelcreate_surface_modelCreateSurfaceModelcreate_surface_modelCreateSurfaceModelCreateSurfaceModel

Siehe auch

create_surface_modelcreate_surface_modelCreateSurfaceModelcreate_surface_modelCreateSurfaceModelCreateSurfaceModel, write_surface_modelwrite_surface_modelWriteSurfaceModelwrite_surface_modelWriteSurfaceModelWriteSurfaceModel

Modul

3D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH