get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult (Operator)

Name

get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult — Get details of a result from deformable surface based matching.

Signature

Description

The operator get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult returns details about the results of deformable surface based matching or the deformable surface refinement. The results are stored in DeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultdeformableSurfaceMatchingResult, which must have been created by find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel or refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel.

The parameter ResultNameResultNameResultNameResultNameresultName is used to select which result detail shall be returned. For some result details, ResultIndexResultIndexResultIndexResultIndexresultIndex selects the index of the result detail. ResultIndexResultIndexResultIndexResultIndexresultIndex is ignored for certain values of ResultNameResultNameResultNameResultNameresultName.

The following values are possible for ResultNameResultNameResultNameResultNameresultName:

'sampled_scene'"sampled_scene""sampled_scene""sampled_scene""sampled_scene":

A 3D object model handle is returned that contains the sampled scene points that were used in the matching or refinement. This is helpful for tuning the sampling distance of the scene (see parameter RelSamplingDistance of operators find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel and refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel). The parameter ResultIndexResultIndexResultIndexResultIndexresultIndex is ignored. The returned ObjectModel3D handle must be freed with clear_object_model_3dclear_object_model_3dClearObjectModel3dClearObjectModel3dClearObjectModel3d.

'rigid_pose'"rigid_pose""rigid_pose""rigid_pose""rigid_pose":

If DeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultdeformableSurfaceMatchingResult was created by find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel, a rigid pose is returned that approximates the deformable matching result. The parameter ResultIndexResultIndexResultIndexResultIndexresultIndex is ignored. This parameter is not available if DeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultDeformableSurfaceMatchingResultdeformableSurfaceMatchingResult was created by refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel.

'reference_point_x'"reference_point_x""reference_point_x""reference_point_x""reference_point_x":

'reference_point_y'"reference_point_y""reference_point_y""reference_point_y""reference_point_y":

'reference_point_z'"reference_point_z""reference_point_z""reference_point_z""reference_point_z":

Returns the x-, y- or z-coordinates of a transformed reference point. The reference point must have been added to the deformable surface model using the operator add_deformable_surface_model_reference_pointadd_deformable_surface_model_reference_pointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePointAddDeformableSurfaceModelReferencePoint. The indices of the reference points to be returned are passed in ResultIndexResultIndexResultIndexResultIndexresultIndex. If 'all'"all""all""all""all" is passed in ResultIndexResultIndexResultIndexResultIndexresultIndex, the position of all reference points is returned.

'deformed_model'"deformed_model""deformed_model""deformed_model""deformed_model":

Returns a deformed variant of the 3D object model that was originally passed to create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModel. The 3D object model is deformed with the reconstructed deformation. Triangles, polygons and extended attributes contained in the original 3D object model are maintained. The parameter ResultIndexResultIndexResultIndexResultIndexresultIndex is ignored. The returned ObjectModel3D handle must be freed with clear_object_model_3dclear_object_model_3dClearObjectModel3dClearObjectModel3dClearObjectModel3d.

'deformed_sampled_model'"deformed_sampled_model""deformed_sampled_model""deformed_sampled_model""deformed_sampled_model":

Returns a deformed variant of the 3D object model that was sampled by create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModel. The returned 3D object model has the same number of points as the original, undeformed sampled model, and the points are in the same order. Details about the sampling are described in create_deformable_surface_modelcreate_deformable_surface_modelCreateDeformableSurfaceModelCreateDeformableSurfaceModelCreateDeformableSurfaceModel. The original, undeformed sampled model can be obtained with get_deformable_surface_model_paramget_deformable_surface_model_paramGetDeformableSurfaceModelParamGetDeformableSurfaceModelParamGetDeformableSurfaceModelParam. The parameter ResultIndexResultIndexResultIndexResultIndexresultIndex is ignored. The returned ObjectModel3D handle must be freed with clear_object_model_3dclear_object_model_3dClearObjectModel3dClearObjectModel3dClearObjectModel3d.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on internal data level.

Parameters

Result

If the handle of the result is valid, the operator get_deformable_surface_matching_resultget_deformable_surface_matching_resultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResultGetDeformableSurfaceMatchingResult returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel, refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel

Possible Successors

clear_deformable_surface_modelclear_deformable_surface_modelClearDeformableSurfaceModelClearDeformableSurfaceModelClearDeformableSurfaceModel

See also

find_deformable_surface_modelfind_deformable_surface_modelFindDeformableSurfaceModelFindDeformableSurfaceModelFindDeformableSurfaceModel, refine_deformable_surface_modelrefine_deformable_surface_modelRefineDeformableSurfaceModelRefineDeformableSurfaceModelRefineDeformableSurfaceModel, read_deformable_surface_modelread_deformable_surface_modelReadDeformableSurfaceModelReadDeformableSurfaceModelReadDeformableSurfaceModel, write_deformable_surface_modelwrite_deformable_surface_modelWriteDeformableSurfaceModelWriteDeformableSurfaceModelWriteDeformableSurfaceModel, clear_deformable_surface_modelclear_deformable_surface_modelClearDeformableSurfaceModelClearDeformableSurfaceModelClearDeformableSurfaceModel

Module

3D Metrology