Skip to content

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3dget_sheet_of_light_result_object_model_3dT_get_sheet_of_light_result_object_model_3d🔗

Short description🔗

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

Signature🔗

get_sheet_of_light_result_object_model_3d( sheet_of_light_model SheetOfLightModelID, out object_model_3d ObjectModel3D )get_sheet_of_light_result_object_model_3d( : : SheetOfLightModelID : ObjectModel3D )void GetSheetOfLightResultObjectModel3d( const HTuple& SheetOfLightModelID, HTuple* ObjectModel3D )static void HOperatorSet.GetSheetOfLightResultObjectModel3d( HTuple sheetOfLightModelID, out HTuple objectModel3D )def get_sheet_of_light_result_object_model_3d( sheet_of_light_model_id: HHandle ) -> HHandle

Herror T_get_sheet_of_light_result_object_model_3d( const Htuple SheetOfLightModelID, Htuple* ObjectModel3D )

void HObjectModel3D::GetSheetOfLightResultObjectModel3d( const HSheetOfLightModel& SheetOfLightModelID )

HObjectModel3D HSheetOfLightModel::GetSheetOfLightResultObjectModel3d( ) const

void HObjectModel3D.GetSheetOfLightResultObjectModel3d( HSheetOfLightModel sheetOfLightModelID )

HObjectModel3D HSheetOfLightModel.GetSheetOfLightResultObjectModel3d( )

Description🔗

The operator get_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3d 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 SheetOfLightModelIDsheetOfLightModelIDsheet_of_light_model_id. The calibration extent of the sheet-of-light model ('calibration'"calibration") must have been set to 'xyz'"xyz" or 'offset_scale'"offset_scale" 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 ObjectModel3DobjectModel3Dobject_model_3d. 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_resultGetSheetOfLightResult in order to retrieve the 'x'"x", 'y'"y", and 'z'"z" coordinates from the sheet-of-light model and then call the operator xyz_to_object_model_3dXyzToObjectModel3d with suitable parameters. Refer to xyz_to_object_model_3dXyzToObjectModel3d for more information about 3D object models.

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

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters🔗

SheetOfLightModelIDsheetOfLightModelIDsheet_of_light_model_id (input_control) sheet_of_light_model → (handle)(handle)HTuple (HHandle)HSheetOfLightModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle for accessing the sheet-of-light model.

ObjectModel3DobjectModel3Dobject_model_3d (output_control) object_model_3d → (handle)(handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the resulting 3D object model.

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

create_sheet_of_light_modelCreateSheetOfLightModel, measure_profile_sheet_of_lightMeasureProfileSheetOfLight, calibrate_sheet_of_lightCalibrateSheetOfLight

Possible successors

clear_object_model_3dClearObjectModel3d

Module🔗

3D Metrology