Skip to content

create_metrology_modelCreateMetrologyModelCreateMetrologyModelcreate_metrology_modelT_create_metrology_model🔗

Short description🔗

create_metrology_modelCreateMetrologyModelCreateMetrologyModelcreate_metrology_modelT_create_metrology_model — Create the data structure that is needed to measure geometric shapes.

Signature🔗

create_metrology_model( out metrology_model MetrologyHandle )void CreateMetrologyModel( HTuple* MetrologyHandle )static void HOperatorSet.CreateMetrologyModel( out HTuple metrologyHandle )def create_metrology_model( ) -> HHandle

Herror T_create_metrology_model( Htuple* MetrologyHandle )

void HMetrologyModel::HMetrologyModel( )

public HMetrologyModel( )

void HMetrologyModel::CreateMetrologyModel( )

void HMetrologyModel.CreateMetrologyModel( )

Description🔗

create_metrology_modelCreateMetrologyModel creates a metrology model, i.e., the data structure that is needed to measure objects with a specific geometric shape (metrology object) via 2D metrology, and returns it in the handle MetrologyHandlemetrologyHandlemetrology_handle.

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

Attention🔗

Note, that after calling the operator create_metrology_modelCreateMetrologyModel the operator set_metrology_model_image_sizeSetMetrologyModelImageSize should be called for efficiency reasons.

Execution information🔗

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 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🔗

MetrologyHandlemetrologyHandlemetrology_handle (output_control) metrology_model → (handle)HTuple (HHandle)HMetrologyModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the metrology model.

Example🔗

(HDevelop)

read_image (Image, 'fabrik')
create_metrology_model (MetrologyHandle)
get_image_size (Image, Width, Height)
set_metrology_model_image_size (MetrologyHandle, Width, Height)
add_metrology_object_rectangle2_measure (MetrologyHandle, 270, 230, 0, 30, \
                                  25, 10, 2, 1, 30, [], [], Index)
apply_metrology_model (Image, MetrologyHandle)
get_metrology_object_result (MetrologyHandle, Index, 'all', 'result_type', \
                      'all_param', Rectangle)
get_metrology_object_result_contour (Contour, MetrologyHandle, \
                                    Index, 'all', 1.5)

Result🔗

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

Combinations with other operators🔗

Combinations

Possible successors

set_metrology_model_image_sizeSetMetrologyModelImageSize

Module🔗

2D Metrology