HALCON Website / HALCON Operator Reference / 2D Metrology
ClassesClassesClassesClasses | | | | Operators

get_metrology_object_num_instancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesGetMetrologyObjectNumInstances (Operator)

Name

get_metrology_object_num_instancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesGetMetrologyObjectNumInstances — Get the number of instances of the metrology objects of a metrology model.

Signature

get_metrology_object_num_instances( : : MetrologyHandle, Indices : NumInstances)

Herror get_metrology_object_num_instances(const Hlong MetrologyHandle, const Hlong Indices, double* NumInstances)

Herror T_get_metrology_object_num_instances(const Htuple MetrologyHandle, const Htuple Indices, Htuple* NumInstances)

Herror get_metrology_object_num_instances(const HTuple& MetrologyHandle, const HTuple& Indices, double* NumInstances)

Herror get_metrology_object_num_instances(const HTuple& MetrologyHandle, const HTuple& Indices, HTuple* NumInstances)

HTuple HMetrologyModel::GetMetrologyObjectNumInstances(const HTuple& Indices) const

void GetMetrologyObjectNumInstances(const HTuple& MetrologyHandle, const HTuple& Indices, HTuple* NumInstances)

HTuple HMetrologyModel::GetMetrologyObjectNumInstances(const HTuple& Indices) const

double HMetrologyModel::GetMetrologyObjectNumInstances(Hlong Indices) const

void HOperatorSetX.GetMetrologyObjectNumInstances(
[in] VARIANT MetrologyHandle, [in] VARIANT Indices, [out] VARIANT* NumInstances)

VARIANT HMetrologyModelX.GetMetrologyObjectNumInstances([in] VARIANT Indices)

static void HOperatorSet.GetMetrologyObjectNumInstances(HTuple metrologyHandle, HTuple indices, out HTuple numInstances)

HTuple HMetrologyModel.GetMetrologyObjectNumInstances(HTuple indices)

double HMetrologyModel.GetMetrologyObjectNumInstances(int indices)

Description

get_metrology_object_num_instancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesget_metrology_object_num_instancesGetMetrologyObjectNumInstancesGetMetrologyObjectNumInstances allows to access the number of instances (results) of measurements applied by apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel for the metrology objects (see create_metrology_modelcreate_metrology_modelCreateMetrologyModelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModel for the basic principle of 2D metrology). The metrology model is defined by the handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The parameter IndicesIndicesIndicesIndicesIndicesindices specifies for which metrology object the instances are queried. For IndicesIndicesIndicesIndicesIndicesindices set to 'all'"all""all""all""all""all", the number of instances of all metrology objects are returned. The number of instances is returned in NumInstancesNumInstancesNumInstancesNumInstancesNumInstancesnumInstances for each metrology object that was passed in IndicesIndicesIndicesIndicesIndicesindices.

Attention

A metrology model 'MetrologyHandle'"MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle" cannot be shared between two or more user's threads. Different metrology models can be used independently and safely in different threads.

Parallelization

Parameters

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control)  metrology_model → HMetrologyModel, HTupleHTupleHMetrologyModel, HTupleHMetrologyModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the metrology model.

IndicesIndicesIndicesIndicesIndicesindices (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Indices of the metrology objects.

Default value: 0

Suggested values: 'all'"all""all""all""all""all", 0, 1, 2

NumInstancesNumInstancesNumInstancesNumInstancesNumInstancesnumInstances (output_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Number of Instances of the metrology objects.

Result

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

Possible Predecessors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

Possible Successors

clear_metrology_modelclear_metrology_modelClearMetrologyModelclear_metrology_modelClearMetrologyModelClearMetrologyModel

See also

get_metrology_object_indicesget_metrology_object_indicesGetMetrologyObjectIndicesget_metrology_object_indicesGetMetrologyObjectIndicesGetMetrologyObjectIndices

Module

2D Metrology

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH