read_measureT_read_measureReadMeasureReadMeasureread_measure (Operator)

Name

read_measureT_read_measureReadMeasureReadMeasureread_measure — Einlesen eines Messobjekts aus einer Datei.

Signatur

read_measure( : : FileName : MeasureHandle)

Beschreibung

read_measureread_measureReadMeasureReadMeasureread_measure liest ein Messobjekt, welches mit write_measurewrite_measureWriteMeasureWriteMeasurewrite_measure geschrieben wurde, aus der Datei FileNameFileNameFileNamefileNamefile_name ein. Die Dateiendung für ein Messobjekt in HALCON ist 'mtr'. Die im gelesenen Messobjekt vorhanden Werte werden in einem Messobjekt mit dem Handle MeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle 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

FileNameFileNameFileNamefileNamefile_name (input_control) filename.read → (string)

Name der Datei.

Dateiendung: .msr

MeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (output_control) measure → (handle)

Handle des Messobjekts.

Ergebnis

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

Nachfolger

measure_posmeasure_posMeasurePosMeasurePosmeasure_pos, measure_pairsmeasure_pairsMeasurePairsMeasurePairsmeasure_pairs

Siehe auch

write_measurewrite_measureWriteMeasureWriteMeasurewrite_measure

Modul

1D Metrology

Operatoren