get_sheet_of_light_result — Get the iconic results of a measurement performed with the sheet-of light technique.
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:
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'.
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 implicitely 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.
Desired measurement result.
Handle of the sheet-of-light model to be used.
Specify which result of the measurement shall be provided.
Default value: '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.