read_measureT_read_measureReadMeasureReadMeasure (Operator)

Name

read_measureT_read_measureReadMeasureReadMeasure — Einlesen eines Messobjekts aus einer Datei.

Signatur

read_measure( : : FileName : MeasureHandle)

Beschreibung

read_measureread_measureReadMeasureReadMeasureReadMeasure liest ein Messobjekt, welches mit write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasure geschrieben wurde, aus der Datei FileNameFileNameFileNameFileNamefileName ein. Die Dateiendung für ein Messobjekt in HALCON ist 'mtr'. Die im gelesenen Messobjekt vorhanden Werte werden in einem Messobjekt mit dem Handle MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle gespeichert.

Das Konzept der 1D-Vermessung ist bei der Einleitung zu Kapitel 1D-Vermessung beschrieben.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Name der Datei.

Dateiendung: .msr

MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (output_control) measure → (handle)

Handle des Messobjekts.

Ergebnis

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

Nachfolger

measure_posmeasure_posMeasurePosMeasurePosMeasurePos, measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairs

Siehe auch

write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasure

Modul

1D Metrology

Operatoren