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

get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures (Operator)

Name

get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures — Get the measure regions and the results of the edge location for the metrology objects of a metrology model.

Signature

get_metrology_object_measures( : Contour : MetrologyHandle, Indices, Transition : Row, Column)

Herror T_get_metrology_object_measures(Hobject* Contour, const Htuple MetrologyHandle, const Htuple Indices, const Htuple Transition, Htuple* Row, Htuple* Column)

Herror get_metrology_object_measures(Hobject* Contour, const HTuple& MetrologyHandle, const HTuple& Indices, const HTuple& Transition, HTuple* Row, HTuple* Column)

HXLDContArray HMetrologyModel::GetMetrologyObjectMeasures(const HTuple& Indices, const HTuple& Transition, HTuple* Row, HTuple* Column) const

void GetMetrologyObjectMeasures(HObject* Contour, const HTuple& MetrologyHandle, const HTuple& Indices, const HTuple& Transition, HTuple* Row, HTuple* Column)

HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const HTuple& Indices, const HString& Transition, HTuple* Row, HTuple* Column) const

HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const HString& Indices, const HString& Transition, HTuple* Row, HTuple* Column) const

HXLDCont HMetrologyModel::GetMetrologyObjectMeasures(const char* Indices, const char* Transition, HTuple* Row, HTuple* Column) const

void HOperatorSetX.GetMetrologyObjectMeasures(
[out] IHUntypedObjectX** Contour, [in] VARIANT MetrologyHandle, [in] VARIANT Indices, [in] VARIANT Transition, [out] VARIANT* Row, [out] VARIANT* Column)

IHXLDContX* HMetrologyModelX.GetMetrologyObjectMeasures(
[in] VARIANT Indices, [in] BSTR Transition, [out] VARIANT* Row, [out] VARIANT* Column)

static void HOperatorSet.GetMetrologyObjectMeasures(out HObject contour, HTuple metrologyHandle, HTuple indices, HTuple transition, out HTuple row, out HTuple column)

HXLDCont HMetrologyModel.GetMetrologyObjectMeasures(HTuple indices, string transition, out HTuple row, out HTuple column)

HXLDCont HMetrologyModel.GetMetrologyObjectMeasures(string indices, string transition, out HTuple row, out HTuple column)

Description

get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures allows to access the measure regions of the metrology objects that were created with add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure, add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure, add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure, or add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure as XLD contours and the results of the edge location that was performed by apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel (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 determines for which metrology objects the information is accessed. With IndicesIndicesIndicesIndicesIndicesindices set to 'all'"all""all""all""all""all", the measure regions and the results of the edge location for all metrology objects are accessed.

If positive and negative edges are available in the measure regions (see the generic parameter value 'measure_transition'"measure_transition""measure_transition""measure_transition""measure_transition""measure_transition" of the operator set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParam), with the parameter TransitionTransitionTransitionTransitionTransitiontransition the desired edges (positive or negative) can be selected. If TransitionTransitionTransitionTransitionTransitiontransition is set to 'positive'"positive""positive""positive""positive""positive", only positive edges are returned. If TransitionTransitionTransitionTransitionTransitiontransition is set to 'negative'"negative""negative""negative""negative""negative", only negative edges are returned. All edges are returned if the parameter TransitionTransitionTransitionTransitionTransitiontransition ist set to 'all'"all""all""all""all""all".

The operator get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures returns for each measure region one rectangular XLD contour with the boundary of the measure region in the parameter ContourContourContourContourContourcontour. Additionally, the coordinates of the results of the edge location are returned as single points in the parameters RowRowRowRowRowrow and ColumnColumnColumnColumnColumncolumn. Note that the order for the values of these points is not defined. Furthermore, there is no possibility to assign the results of the edge location to specific measure regions.

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

ContourContourContourContourContourcontour (output_object)  xld_cont-array → objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Rectangular XLD Contours of measure regions.

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 (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong) (BSTR / Hlong) (char* / Hlong)

Indices of the metrology objects.

Default value: 'all' "all" "all" "all" "all" "all"

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

TransitionTransitionTransitionTransitionTransitiontransition (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Select light/dark or dark/light edges.

Default value: 'all' "all" "all" "all" "all" "all"

List of values: 'all'"all""all""all""all""all", 'negative'"negative""negative""negative""negative""negative", 'positive'"positive""positive""positive""positive""positive"

RowRowRowRowRowrow (output_control)  point.y-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Row coordinates of the measured edges.

ColumnColumnColumnColumnColumncolumn (output_control)  point.x-array → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Column coordinates of the measured edges.

Result

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

Possible Predecessors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

Module

2D Metrology

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