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

clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObject (Operator)

Name

clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObject — Löschen von Metrology-Messobjekten und Freigabe des verwendeten Speichers.

Signatur

clear_metrology_object( : : MetrologyHandle, Index : )

Herror T_clear_metrology_object(const Htuple MetrologyHandle, const Htuple Index)

void ClearMetrologyObject(const HTuple& MetrologyHandle, const HTuple& Index)

void HMetrologyModel::ClearMetrologyObject(const HTuple& Index) const

void HMetrologyModel::ClearMetrologyObject(const HString& Index) const

void HMetrologyModel::ClearMetrologyObject(const char* Index) const

void HMetrologyModel::ClearMetrologyObject(const wchar_t* Index) const   (Nur Windows)

static void HOperatorSet.ClearMetrologyObject(HTuple metrologyHandle, HTuple index)

void HMetrologyModel.ClearMetrologyObject(HTuple index)

void HMetrologyModel.ClearMetrologyObject(string index)

Beschreibung

clear_metrology_objectclear_metrology_objectClearMetrologyObjectClearMetrologyObjectClearMetrologyObject löscht in einem Messmodell z.B. mit add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure, add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure, add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure oder add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure angelegte Metrology-Messobjekte und gibt den von den Metrology-Messobjekten referenzierten Speicherplatz wieder frei.

Das Handle des Messmodells muss in MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle übergeben werden. Der Index der zu löschenden Metrology-Messobjekte muss in IndexIndexIndexIndexindex übergeben werden. Wird für den Parameter IndexIndexIndexIndexindex als Wert 'all'"all""all""all""all" übergeben, werden alle Metrology-Messobjekte gelöscht. Nach dem Aufruf sind die Metrology-Messobjekte ungültig.

Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel 2D-Messtechnik beschrieben.

Ausführungsinformationen

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.

Parameter

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control, Zustand wird modifiziert)  metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des Messmodells.

IndexIndexIndexIndexindex (input_control)  integer(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Index der Metrology-Messobjekte.

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

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

Ergebnis

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

Modul

2D Metrology

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH