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

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 11.0.5 Copyright © 1996-2015 MVTec Software GmbH