set_profile_sheet_of_lightT_set_profile_sheet_of_lightSetProfileSheetOfLightset_profile_sheet_of_lightSetProfileSheetOfLightSetProfileSheetOfLight (Operator)

Name

set_profile_sheet_of_lightT_set_profile_sheet_of_lightSetProfileSheetOfLightset_profile_sheet_of_lightSetProfileSheetOfLightSetProfileSheetOfLight — Set sheet of light profiles by measured disparities.

Signature

set_profile_sheet_of_light(ProfileDisparityImage : : SheetOfLightModelID, MovementPoses : )

Description

set_profile_sheet_of_lightset_profile_sheet_of_lightSetProfileSheetOfLightset_profile_sheet_of_lightSetProfileSheetOfLightSetProfileSheetOfLight adds sheet-of-light profiles to the sheet-of-light model SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID. The profiles are specified as rows in a disparity image in ProfileDisparityImageProfileDisparityImageProfileDisparityImageProfileDisparityImageProfileDisparityImageprofileDisparityImage. Each of the profiles can have an individual Pose set in MovementPosesMovementPosesMovementPosesMovementPosesMovementPosesmovementPoses which is interpreted as relative movement to the previous row. If no pose is set, the default transformation is used, which can be set by set_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParam. If only one pose is set, this pose will become the default transformation.

Attention

This operator changes the data in the handle. Therefore one and the same sheet-of-light model cannot be used concurrently in different threads when using this operator. If you want to use the same handle in multiple threads you have to synchronize the threads to assure that they do not access the same handle simultaneously. Different sheet-of-light models can be used independently and safely in different threads.

Parallelization

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

Parameters

ProfileDisparityImageProfileDisparityImageProfileDisparityImageProfileDisparityImageProfileDisparityImageprofileDisparityImage (input_object) singlechannelimage → object (byte / uint2 / real)

Disparity image that contains several profiles.

SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID (input_control) sheet_of_light_model → (integer)

Handle of the sheet-of-light model.

MovementPosesMovementPosesMovementPosesMovementPosesMovementPosesmovementPoses (input_control) number-array → (integer / real)

Poses describing the movement of the scene under measurement between the previously processed profile image and the current profile image.

Result

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

Possible Successors

get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResult, get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d

Module

3D Metrology

Operators