HALCON Website / HALCON Operator-Referenz / 2D-Messtechnik
KlassenKlassenKlassenKlassen | | | | Operatoren

get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures (Operator)

Name

get_metrology_object_measuresT_get_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures — Abfragen der Messregionen und der Ergebnisse der Kantenextraktion für die Metrology-Messobjekte eines Messmodells.

Signatur

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)

Beschreibung

Mit Hilfe des Operators get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures lassen sich die Messregionen welche mit 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 oder add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure angelegt werden, als XLD-Konturen und die Ergebnisse der Kantenextraktion, die von apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel berechnet werden, abfragen (siehe create_metrology_modelcreate_metrology_modelCreateMetrologyModelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModel für das Grundprinzip der 2D-Messtechnik). Das Messmodell ist durch das Handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert. Der Parameter IndicesIndicesIndicesIndicesIndicesindices legt fest, für welche Metrology-Messobjekte die Information abgefragt werden soll. Wird dem Parameter IndicesIndicesIndicesIndicesIndicesindices als Wert 'all'"all""all""all""all""all" übergeben, werden die Messregionen und die Ergebnisse der Kantenextraktion für alle Metrology-Messobjekte abgefragt.

Sind in den Messregionen positive und negative Kantenpositionen vorhanden (siehe generischer Parameterwert 'measure_transition'"measure_transition""measure_transition""measure_transition""measure_transition""measure_transition" des Operators set_metrology_object_paramset_metrology_object_paramSetMetrologyObjectParamset_metrology_object_paramSetMetrologyObjectParamSetMetrologyObjectParam), können diese mit dem Parameter TransitionTransitionTransitionTransitionTransitiontransition selektiert werden. Wenn TransitionTransitionTransitionTransitionTransitiontransition auf 'positive'"positive""positive""positive""positive""positive" gesetzt ist, werden nur positive Kanten abgefragt. Wenn TransitionTransitionTransitionTransitionTransitiontransition auf 'negative'"negative""negative""negative""negative""negative" gesetzt ist, werden nur negative Kanten abgefragt. Alle Kanten werden zurückgegeben, wenn TransitionTransitionTransitionTransitionTransitiontransition auf 'all'"all""all""all""all""all" gesetzt ist.

Der Operator get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures gibt für jede Messregion eine rechteckige XLD-Kontur mit der Begrenzung der Messregion im Parameter ContourContourContourContourContourcontour zurück. Zusätzlich werden die Koordinaten des Ergebnisses der Kantenextraktion in den Parametern RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn als einzelne Punkte zurückgegeben. Zu beachten ist hierbei, dass die Reihenfolge der Punktkoordinaten nicht festgelegt ist. Desweiteren gibt es keine Möglichkeit die Ergebnisse der Kantenextration den Messregionen zuzuordnen.

Achtung

Ein Messmodell 'MetrologyHandle'"MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle""MetrologyHandle" kann nur von einem Thread aus verwendet werden. Verschiedene Messmodelle können dagegen in unterschiedlichen Threads genutzt werden.

Parallelisierung

Parameter

ContourContourContourContourContourcontour (output_object)  xld_cont-array → objectHXLDContHXLDContHXLDContArrayHXLDContXHobject *

Rechteckige XLD-Konturen der Messregionen.

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

Handle des Messmodells.

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

Indizes der Metrology-Messobjekte.

Defaultwert: 'all' "all" "all" "all" "all" "all"

Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2

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

Kanten mit Hell-Dunkel-('positive') oder Dunkel-Hell-('negative')-Übergängen.

Defaultwert: 'all' "all" "all" "all" "all" "all"

Werteliste: '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)

Zeilenkoordinaten der gemessenen Kanten.

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

Spaltenkoordinaten der gemessenen Kanten.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

Modul

2D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH