read_measureT_read_measureReadMeasureReadMeasureread_measure (Operator)
Name
read_measureT_read_measureReadMeasureReadMeasureread_measure — Einlesen eines Messobjekts aus einer Datei.
Signatur
Beschreibung
read_measureread_measureReadMeasureReadMeasureReadMeasureread_measure liest ein Messobjekt, welches mit
write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasurewrite_measure geschrieben wurde, aus der Datei
FileNameFileNameFileNameFileNamefileNamefile_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
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_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
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der Datei.
Dateiendung: .msr
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (output_control) measure → HMeasure, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Messobjekts.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
read_measureread_measureReadMeasureReadMeasureReadMeasureread_measure den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Nachfolger
measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos,
measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs
Siehe auch
write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasurewrite_measure
Modul
1D Metrology