read_measure
— Einlesen eines Messobjekts aus einer Datei.
read_measure( : : FileName : MeasureHandle)
read_measure
liest ein Messobjekt, welches mit
write_measure
geschrieben wurde, aus der Datei
FileName
ein. Die Dateiendung für ein Messobjekt
in HALCON ist 'mtr'. Die im gelesenen Messobjekt vorhanden Werte
werden in einem Messobjekt mit dem Handle
MeasureHandle
gespeichert.
Das Konzept der 1D-Vermessung ist bei der Einleitung zu Kapitel 1D-Vermessung beschrieben.
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.
FileName
(input_control) filename.read →
(string)
Name der Datei.
Dateiendung: .msr
MeasureHandle
(output_control) measure →
(handle)
Handle des Messobjekts.
Sind die Parameterwerte korrekt, dann liefert
read_measure
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
1D Metrology