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( : Contours : MetrologyHandle, Index, Transition : Row, Column)

Herror T_get_metrology_object_measures(Hobject* Contours, const Htuple MetrologyHandle, const Htuple Index, const Htuple Transition, Htuple* Row, Htuple* Column)

Herror get_metrology_object_measures(Hobject* Contours, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Transition, HTuple* Row, HTuple* Column)

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

void GetMetrologyObjectMeasures(HObject* Contours, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Transition, HTuple* Row, HTuple* Column)

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

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

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

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

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

static void HOperatorSet.GetMetrologyObjectMeasures(out HObject contours, HTuple metrologyHandle, HTuple index, HTuple transition, out HTuple row, out HTuple column)

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

HXLDCont HMetrologyModel.GetMetrologyObjectMeasures(string index, 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_genericadd_metrology_object_genericAddMetrologyObjectGenericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGeneric, add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure, etc. angelegt werden, als XLD-Konturen und die Ergebnisse der Kantenextraktion, die von apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel berechnet werden, in Bildkoordinaten 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 IndexIndexIndexIndexIndexindex legt fest, für welche Metrology-Messobjekte die Information abgefragt werden soll. Wird dem Parameter IndexIndexIndexIndexIndexindex 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 ContoursContoursContoursContoursContourscontours zurück. Nach einem Aufruf von apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel werden zusätzlich die Bildkoordinaten 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. Wird get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures vor apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel aufgerufen, bleiben die Parameter RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn leer.

Parallelisierung

Parameter

ContoursContoursContoursContoursContourscontours (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.

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

Index 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

Siehe auch

add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGeneric, 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, add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure, add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure

Modul

2D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH