get_sheet_of_light_result
— Zugriff auf die ikonischen Ergebnisse einer Lichtschnittmessung.
get_sheet_of_light_result( : ResultValue : SheetOfLightModelID, ResultName : )
Der Operator get_sheet_of_light_result
ermöglicht den Zugriff auf
die in einem Lichtschnittmodell gespeicherten ikonischen Messergebnisse.
Die verschiedenen Messergebnisse können, wie unten erläutert, mit dem
Parameter ResultName
spezifiziert werden:
Nicht-kalibrierte Ergebnisse:
das gemessene Disparitätsbild, d.h. die subpixelgenaue Position der detektierten Profile. Die Disparitätswerte können als nicht-kalibrierte Pseudo-Entfernungswerte betrachtet werden.
die Bewertungsmerkmale des gemessenen Disparitätsbildes werden
zurückgeliefert. Diese werden entsprechend dem Wert des Modellparameters
'score_type' berechnet. Wurde 'score_type' auf
'none' gesetzt, so wird ein leeres Bild zurückgeliefert. Die
Referenzdokumentation des Operators set_sheet_of_light_param
liefert
Details über die möglichen Werte des Parameters 'score_type'
.
Kalibrierte Ergebnisse:
Die kalibrierten X-Koordinaten der 3D-Punkte der rekonstruierten Oberfläche. Die Koordinaten werden als Pixelwerte zurückgeliefert.
Die kalibrierten Y-Koordinaten der 3D-Punkte der rekonstruierten Oberfläche. Die Koordinaten werden als Pixelwerte zurückgeliefert.
Die kalibrierten Z-Koordinaten der 3D-Punkte der rekonstruierten Oberfläche. Die Koordinaten werden als Pixelwerte zurückgeliefert.
Beachten Sie, dass bei den Bildern die zurückgeliefert werden, wenn
ResultName
auf 'x' , 'y' oder 'z' gesetzt
wurde, die Pixelwerte die Semantik von Koordinaten haben. Diese Koordinaten
beziehen sich auf das Weltkoordinatensystem, das implizit durch die Festlegung
der Pose der Kamera bestimmt wurde. Die Einheit dieser Koordinaten ist vom Wert
des Parameters 'scale'
abhängig. Der Operator
set_sheet_of_light_param
liefert weitere Details über die möglichen Werte
des Parameters 'scale'
.
get_sheet_of_light_result
liefert ein leeres Objekt zurück, wenn das
angeforderte Ergebnis nicht berechnet wurde und im Lichtschnitt-Modell nicht
vorhanden ist.
ResultValue
(output_object) singlechannelimage →
object (real)
Gewünschtes Messergebnis.
SheetOfLightModelID
(input_control) sheet_of_light_model →
(handle)
Handle des zu verwendenden Lichtschnitt-Modells.
ResultName
(input_control) string(-array) →
(string)
Messergebnis, das ausgegeben werden soll.
Defaultwert: 'disparity'
Werteliste: 'disparity' , 'score' , 'x' , 'y' , 'z'
get_sheet_of_light_result
liefert den Wert 2 (H_MSG_TRUE), falls die
übergebenen Parameter korrekt sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
3D Metrology