HALCON Website / HALCON Operator Reference / 2D Metrology
ClassesClassesClassesClasses | | | | Operators

read_metrology_modelread_metrology_modelReadMetrologyModelread_metrology_modelReadMetrologyModelReadMetrologyModel (Operator)

Name

read_metrology_modelread_metrology_modelReadMetrologyModelread_metrology_modelReadMetrologyModelReadMetrologyModel — Read a metrology model from a file.

Signature

read_metrology_model( : : FileName : MetrologyHandle)

Herror read_metrology_model(const char* FileName, Hlong* MetrologyHandle)

Herror T_read_metrology_model(const Htuple FileName, Htuple* MetrologyHandle)

Herror read_metrology_model(const HTuple& FileName, Hlong* MetrologyHandle)

void HMetrologyModel::ReadMetrologyModel(const HTuple& FileName)

void ReadMetrologyModel(const HTuple& FileName, HTuple* MetrologyHandle)

void HMetrologyModel::HMetrologyModel(const HString& FileName)

void HMetrologyModel::HMetrologyModel(const char* FileName)

void HMetrologyModel::ReadMetrologyModel(const HString& FileName)

void HMetrologyModel::ReadMetrologyModel(const char* FileName)

void HOperatorSetX.ReadMetrologyModel(
[in] VARIANT FileName, [out] VARIANT* MetrologyHandle)

void HMetrologyModelX.ReadMetrologyModel([in] BSTR FileName)

static void HOperatorSet.ReadMetrologyModel(HTuple fileName, out HTuple metrologyHandle)

public HMetrologyModel(string fileName)

void HMetrologyModel.ReadMetrologyModel(string fileName)

Description

read_metrology_modelread_metrology_modelReadMetrologyModelread_metrology_modelReadMetrologyModelReadMetrologyModel reads a metrology model, which has been written to file with write_metrology_modelwrite_metrology_modelWriteMetrologyModelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModel, from the file FileNameFileNameFileNameFileNameFileNamefileName (see create_metrology_modelcreate_metrology_modelCreateMetrologyModelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModel for the basic principle of 2D metrology). The default HALCON file extension for a metrology model is 'mtr'. The values contained in the read metrology model are stored in a metrology model with the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. Access to the parameters of the metrology model is possible, e.g., with the operator get_metrology_object_paramget_metrology_object_paramGetMetrologyObjectParamget_metrology_object_paramGetMetrologyObjectParamGetMetrologyObjectParam or get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParam.

Parallelization

Parameters

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

File name.

File extension: .mtr

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (output_control)  metrology_model → HMetrologyModel, HTupleHTupleHMetrologyModel, HTupleHMetrologyModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the metrology model.

Result

If the parameters are valid, the operator read_metrology_modelread_metrology_modelReadMetrologyModelread_metrology_modelReadMetrologyModelReadMetrologyModel returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Successors

get_metrology_object_indicesget_metrology_object_indicesGetMetrologyObjectIndicesget_metrology_object_indicesGetMetrologyObjectIndicesGetMetrologyObjectIndices, apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

See also

write_metrology_modelwrite_metrology_modelWriteMetrologyModelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModel

Module

2D Metrology

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH