ClassesClassesClassesClasses | | | | Operators

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel (Operator)

Name

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel — Read a surface model from a file.

Signature

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)

Description

The operator read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel reads the surface model, which has been written with write_surface_modelwrite_surface_modelWriteSurfaceModelwrite_surface_modelWriteSurfaceModelWriteSurfaceModel, from the file FileNameFileNameFileNameFileNameFileNamefileName. The handle of the surface model is returned in SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID. If no absolute path is given in FileNameFileNameFileNameFileNameFileNamefileName, the file is searched in the current directory of the HALCON process. The default HALCON file extension for the surface model (SFM) file is 'sfm'. If no file named FileNameFileNameFileNameFileNameFileNamefileName exists, the default file extension is appended to FileNameFileNameFileNameFileNameFileNamefileName.

Parallelization

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

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

Name of the SFM file.

File extension: .sfm

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

Handle of the read surface model.

Result

read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel returns 2 (H_MSG_TRUE) if all parameters are correct and the file can be read. If the file is not a surface model file, the error 9506 is raised. If the file has a version that can not be read by this version of HALCON, the error 9507 is raised. If necessary, an exception is raised.

Possible Predecessors

read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d, xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d

Possible Successors

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, find_surface_model_imagefind_surface_model_imageFindSurfaceModelImagefind_surface_model_imageFindSurfaceModelImageFindSurfaceModelImage, refine_surface_model_pose_imagerefine_surface_model_pose_imageRefineSurfaceModelPoseImagerefine_surface_model_pose_imageRefineSurfaceModelPoseImageRefineSurfaceModelPoseImage

Alternatives

create_surface_modelcreate_surface_modelCreateSurfaceModelcreate_surface_modelCreateSurfaceModelCreateSurfaceModel

See also

create_surface_modelcreate_surface_modelCreateSurfaceModelcreate_surface_modelCreateSurfaceModelCreateSurfaceModel, write_surface_modelwrite_surface_modelWriteSurfaceModelwrite_surface_modelWriteSurfaceModelWriteSurfaceModel

Module

3D Metrology


ClassesClassesClassesClasses | | | | Operators