get_sheet_of_light_resultT_get_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResult (Operator)

Name

get_sheet_of_light_resultT_get_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResult — Get the iconic results of a measurement performed with the sheet-of light technique.

Signature

Description

The operator get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResultGetSheetOfLightResult 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 ResultNameResultNameResultNameResultNameresultName as described below:

Non-calibrated results:

'disparity'"disparity""disparity""disparity""disparity":

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.

'score'"score""score""score""score":

the score values computed according to the value of the parameter 'score_type''score_type''score_type''score_type''scoreType' is returned. If the parameter 'score_type''score_type''score_type''score_type''scoreType' has been set to 'none'"none""none""none""none", no score value is computed during the measurement, therefore the returned image is empty. Refer to create_sheet_of_light_modelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModelCreateSheetOfLightModel and set_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParamSetSheetOfLightParam for details on the possible values of the model parameter 'score_type''score_type''score_type''score_type''scoreType'.

Calibrated results:

'x'"x""x""x""x":

The calibrated X-coordinates of the reconstructed surface is returned as an image.

'y'"y""y""y""y":

The calibrated Y-coordinates of the reconstructed surface is returned as an image.

'z'"z""z""z""z":

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 ResultNameResultNameResultNameResultNameresultName to 'X'"X""X""X""X", 'Y'"Y""Y""Y""Y" or 'Z'"Z""Z""Z""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''scale''scale''scale''scale'. (see create_sheet_of_light_modelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModelCreateSheetOfLightModel and set_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParamSetSheetOfLightParam for details on the possible values of the model parameter 'scale''scale''scale''scale''scale'.)

The operator get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResultGetSheetOfLightResult returns an empty object if the desired result has not been computed.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

The operator get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResultGetSheetOfLightResult returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.

Module

3D Metrology