get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d (Operator)

Name

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d — Get the result of a calibrated measurement performed with the sheet-of-light technique as a 3D object model.

Signature

Description

The operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d returns the result of a fully calibrated sheet-of-light measurement as a 3D object model. The handle of the sheet-of-light model with which the measurement is performed must be passed to SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID. The calibration extend of the sheet-of-light model ('calibration'"calibration""calibration""calibration""calibration") must have been set to 'xyz'"xyz""xyz""xyz""xyz" before applying the measurement, otherwise the computed coordinates cannot be returned as a 3D object model and an exception is raised.

The handle of the 3D object model resulting from the measurement is returned in ObjectModel3DIDObjectModel3DIDObjectModel3DIDObjectModel3DIDobjectModel3DID. For the 3D points within this 3D object model no triangular meshing is available, therefore no faces are stored in the 3D object model. If a 3D object model with triangular meshing is required for the subsequent processing, use the operator get_sheet_of_light_resultget_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResult in order to retrieve the 'x'"x""x""x""x", 'y'"y""y""y""y", and 'z'"z""z""z""z" coordinates from the sheet-of-light model and then call the operator xyz_to_object_model_3dxyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d with suitable parameters. Refer to xyz_to_object_model_3dxyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d for more information about 3D object models.

The unit of the returned coordinates depends on the value of the parameter 'scale''scale''scale''scale''scale' that was set for the sheet-of-light model before applying the measurement. See create_sheet_of_light_modelcreate_sheet_of_light_modelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModel and set_sheet_of_light_paramset_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParam for details on the possible values of the model parameter 'scale''scale''scale''scale''scale'. The operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d returns a handle to an empty 3D object model if the desired result has not been measured yet.

Parallelization

• 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_result_object_model_3dget_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.

Possible Predecessors

create_sheet_of_light_modelcreate_sheet_of_light_modelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModel, measure_profile_sheet_of_lightmeasure_profile_sheet_of_lightmeasure_profile_sheet_of_lightMeasureProfileSheetOfLightMeasureProfileSheetOfLight

Module

3D Metrology