Operator Reference

HALCON Operator Reference / 2D Metrology

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

clear_metrology_modelT_clear_metrology_modelClearMetrologyModelClearMetrologyModelclear_metrology_model (Operator)

clear_metrology_modelT_clear_metrology_modelClearMetrologyModelClearMetrologyModelclear_metrology_model — Delete a metrology model and free the allocated memory.

Signature

clear_metrology_model( : : MetrologyHandle : )

Herror T_clear_metrology_model(const Htuple MetrologyHandle)

void ClearMetrologyModel(const HTuple& MetrologyHandle)

void HMetrologyModel::ClearMetrologyModel() const

static void HOperatorSet.ClearMetrologyModel(HTuple metrologyHandle)

void HMetrologyModel.ClearMetrologyModel()

def clear_metrology_model(metrology_handle: HHandle) -> None

Description

clear_metrology_modelclear_metrology_modelClearMetrologyModelClearMetrologyModelclear_metrology_model deletes a metrology model that was created by create_metrology_modelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModelcreate_metrology_model, copy_metrology_modelcopy_metrology_modelCopyMetrologyModelCopyMetrologyModelcopy_metrology_model, read_metrology_modelread_metrology_modelReadMetrologyModelReadMetrologyModelread_metrology_model, or deserialize_metrology_modeldeserialize_metrology_modelDeserializeMetrologyModelDeserializeMetrologyModeldeserialize_metrology_model. Note that by deleting the model also the including metrology objects are deleted. All memory used by the metrology model and the metrology objects is freed. The handle of the model is passed in MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle. After the operator call, the metrology model is invalid.

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

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

MetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (input_control, state is modified)  metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the metrology model.

Result

The operator clear_metrology_modelclear_metrology_modelClearMetrologyModelClearMetrologyModelclear_metrology_model returns the value 2 ( H_MSG_TRUE) if a valid handle was passed and the referred metrology model can be freed correctly. Otherwise, an exception will be raised.

Possible Predecessors

get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResultget_metrology_object_result, write_metrology_modelwrite_metrology_modelWriteMetrologyModelWriteMetrologyModelwrite_metrology_model

Module

2D Metrology

---

ClassesClasses | | Operators