ClassesClassesClassesClasses | | | | Operators

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d (Operator)

Name

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_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

get_sheet_of_light_result_object_model_3d( : : SheetOfLightModelID : ObjectModel3D)

Herror get_sheet_of_light_result_object_model_3d(const Hlong SheetOfLightModelID, Hlong* ObjectModel3D)

Herror T_get_sheet_of_light_result_object_model_3d(const Htuple SheetOfLightModelID, Htuple* ObjectModel3D)

Herror get_sheet_of_light_result_object_model_3d(const HTuple& SheetOfLightModelID, Hlong* ObjectModel3D)

void HObjectModel3D::GetSheetOfLightResultObjectModel3d(const HSheetOfLightModel& SheetOfLightModelID)

HObjectModel3D HSheetOfLightModel::GetSheetOfLightResultObjectModel3d() const

void GetSheetOfLightResultObjectModel3d(const HTuple& SheetOfLightModelID, HTuple* ObjectModel3D)

void HObjectModel3D::GetSheetOfLightResultObjectModel3d(const HSheetOfLightModel& SheetOfLightModelID)

HObjectModel3D HSheetOfLightModel::GetSheetOfLightResultObjectModel3d() const

void HOperatorSetX.GetSheetOfLightResultObjectModel3d(
[in] VARIANT SheetOfLightModelID, [out] VARIANT* ObjectModel3D)

void HObjectModel3DX.GetSheetOfLightResultObjectModel3d([in] IHSheetOfLightModelX* SheetOfLightModelID)

IHObjectModel3DX* HSheetOfLightModelX.GetSheetOfLightResultObjectModel3d()

static void HOperatorSet.GetSheetOfLightResultObjectModel3d(HTuple sheetOfLightModelID, out HTuple objectModel3D)

void HObjectModel3D.GetSheetOfLightResultObjectModel3d(HSheetOfLightModel sheetOfLightModelID)

HObjectModel3D HSheetOfLightModel.GetSheetOfLightResultObjectModel3d()

Description

The operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_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 SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID. The calibration extent of the sheet-of-light model ('calibration'"calibration""calibration""calibration""calibration""calibration") must have been set to 'xyz'"xyz""xyz""xyz""xyz""xyz" or 'offset_scale'"offset_scale""offset_scale""offset_scale""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 ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D. 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_resultGetSheetOfLightResultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResult in order to retrieve the 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", and 'z'"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_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d with suitable parameters. Refer to xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_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''scale' that was set for the sheet-of-light model before applying the measurement. See create_sheet_of_light_modelcreate_sheet_of_light_modelCreateSheetOfLightModelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModel and set_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParam for details on the possible values of the model parameter 'scale''scale''scale''scale''scale''scale'. The operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_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.

Note that if a 3D object model is no longer needed or should be overwritten, the memory has to be freed first by calling the operator clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d.

Parallelization

Parameters

SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID (input_control)  sheet_of_light_model HSheetOfLightModel, HTupleHTupleHSheetOfLightModel, HTupleHSheetOfLightModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle for accessing the sheet-of-light model.

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (output_control)  object_model_3d HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the resulting 3D object model.

Result

The operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_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_modelCreateSheetOfLightModelcreate_sheet_of_light_modelCreateSheetOfLightModelCreateSheetOfLightModel, measure_profile_sheet_of_lightmeasure_profile_sheet_of_lightMeasureProfileSheetOfLightmeasure_profile_sheet_of_lightMeasureProfileSheetOfLightMeasureProfileSheetOfLight

Possible Successors

clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d

Module

3D Metrology


ClassesClassesClassesClasses | | | | Operators