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

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*)

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 12.0.2 Copyright © 1996-2016 MVTec Software GmbH