get_sheet_of_light_result — Get the iconic results of a measurement performed with the sheet-of light
technique.
get_sheet_of_light_result( : ResultValue : SheetOfLightModelID, ResultName : )
The operator get_sheet_of_light_result provides access to the
results of the calibrated and uncalibrated measurements performed with
a given sheet-of-light model. The different kinds of results can be
selected by setting the value of the parameter ResultName
as described below:
Non-calibrated results:
the measured disparity i.e., the subpixel row value at which the profile was detected is returned for each pixel. The disparity values can be considered as non-calibrated pseudo-range values.
the score values computed according to the value of the parameter
'score_type' is returned. If the parameter
'score_type' has been set to 'none', no score
value is computed during the measurement, therefore the returned
image is empty. Refer to create_sheet_of_light_model and
set_sheet_of_light_param for details on the possible
values of the model parameter 'score_type'.
Calibrated results:
The calibrated X-coordinates of the reconstructed surface is returned as an image.
The calibrated Y-coordinates of the reconstructed surface is returned as an image.
The calibrated Z-coordinates of the reconstructed surface is returned as an image.
Please, note that the pixel values of the images returned when setting
ResultName to 'x', 'y' or 'z' have
the semantic of coordinates with respect to the world coordinate
system that is implicitly defined during the calibration of the system.
The unit of the returned coordinates depends on the value of the
parameter 'scale'. (see create_sheet_of_light_model
and set_sheet_of_light_param for details on the possible
values of the model parameter 'scale'.)
The operator get_sheet_of_light_result returns an empty object
if the desired result has not been computed.
ResultValue (output_object) singlechannelimage → object (real)
Desired measurement result.
SheetOfLightModelID (input_control) sheet_of_light_model → (handle)
Handle of the sheet-of-light model to be used.
ResultName (input_control) string(-array) → (string)
Specify which result of the measurement shall be provided.
Default: 'disparity'
List of values: 'disparity', 'score', 'x', 'y', 'z'
The operator get_sheet_of_light_result returns the value 2 (
H_MSG_TRUE)
if the given parameters are correct.
Otherwise, an exception will be raised.
3D Metrology