write_metrology_modelT_write_metrology_modelWriteMetrologyModelWriteMetrologyModel (Operator)

Name

write_metrology_modelT_write_metrology_modelWriteMetrologyModelWriteMetrologyModel — Write a metrology model to a file.

Signature

write_metrology_model( : : MetrologyHandle, FileName : )

Herror T_write_metrology_model(const Htuple MetrologyHandle, const Htuple FileName)

void WriteMetrologyModel(const HTuple& MetrologyHandle, const HTuple& FileName)

void HMetrologyModel::WriteMetrologyModel(const HString& FileName) const

void HMetrologyModel::WriteMetrologyModel(const char* FileName) const

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

static void HOperatorSet.WriteMetrologyModel(HTuple metrologyHandle, HTuple fileName)

void HMetrologyModel.WriteMetrologyModel(string fileName)

Description

write_metrology_modelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModelWriteMetrologyModel writes a metrology model to the file FileNameFileNameFileNameFileNamefileName. The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The metrology model can be read with read_metrology_modelread_metrology_modelReadMetrologyModelReadMetrologyModelReadMetrologyModel. The default HALCON file extension for a metrology model is 'mtr'.

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

Attention

Note that only the input values are saved, i.e., no measure regions and no results obtained by the operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel are saved.

Execution Information

Parameters

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

Handle of the metrology model.

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

File name.

File extension: .mtr

Result

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

Possible Predecessors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel

Possible Successors

clear_metrology_modelclear_metrology_modelClearMetrologyModelClearMetrologyModelClearMetrologyModel

See also

read_metrology_modelread_metrology_modelReadMetrologyModelReadMetrologyModelReadMetrologyModel

Module

2D Metrology