read_metrology_modelT_read_metrology_modelReadMetrologyModelReadMetrologyModel (Operator)

Name

read_metrology_modelT_read_metrology_modelReadMetrologyModelReadMetrologyModel — Read a metrology model from a file.

Signature

read_metrology_model( : : FileName : MetrologyHandle)

Herror T_read_metrology_model(const Htuple FileName, Htuple* MetrologyHandle)

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

void HMetrologyModel::HMetrologyModel(const HString& FileName)

void HMetrologyModel::HMetrologyModel(const char* FileName)

void HMetrologyModel::HMetrologyModel(const wchar_t* FileName)   (Windows only)

void HMetrologyModel::ReadMetrologyModel(const HString& FileName)

void HMetrologyModel::ReadMetrologyModel(const char* FileName)

void HMetrologyModel::ReadMetrologyModel(const wchar_t* FileName)   (Windows only)

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

public HMetrologyModel(string fileName)

void HMetrologyModel.ReadMetrologyModel(string fileName)

Description

read_metrology_modelread_metrology_modelReadMetrologyModelReadMetrologyModelReadMetrologyModel reads a metrology model, which has been written to file with write_metrology_modelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModelWriteMetrologyModel, from the file FileNameFileNameFileNameFileNamefileName. 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 MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. Access to the parameters of the metrology model is possible, e.g., with the operator get_metrology_object_paramget_metrology_object_paramGetMetrologyObjectParamGetMetrologyObjectParamGetMetrologyObjectParam or get_metrology_object_fuzzy_paramget_metrology_object_fuzzy_paramGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParamGetMetrologyObjectFuzzyParam.

For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.

Execution Information

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

FileNameFileNameFileNameFileNamefileName (input_control)  filename.read HTupleHTupleHtuple (string) (string) (HString) (char*)

File name.

File extension: .mtr

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (output_control)  metrology_model HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the metrology model.

Result

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

Possible Successors

get_metrology_object_indicesget_metrology_object_indicesGetMetrologyObjectIndicesGetMetrologyObjectIndicesGetMetrologyObjectIndices, apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel

See also

write_metrology_modelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModelWriteMetrologyModel

Module

2D Metrology