add_deformable_surface_model_sampleAddDeformableSurfaceModelSampleAddDeformableSurfaceModelSampleadd_deformable_surface_model_sampleT_add_deformable_surface_model_sample

HALCON ScriptCpp++.NETPythonC

Short description

add_deformable_surface_model_sampleAddDeformableSurfaceModelSampleAddDeformableSurfaceModelSampleadd_deformable_surface_model_sampleT_add_deformable_surface_model_sample — Add a sample deformation to a deformable surface model

Signature

add_deformable_surface_model_sample( deformable_surface_model DeformableSurfaceModel, object_model_3d ObjectModel3D )void AddDeformableSurfaceModelSample( const HTuple& DeformableSurfaceModel, const HTuple& ObjectModel3D )static void HOperatorSet.AddDeformableSurfaceModelSample( HTuple deformableSurfaceModel, HTuple objectModel3D )def add_deformable_surface_model_sample( deformable_surface_model: HHandle, object_model_3d: MaybeSequence[HHandle] ) -> None

Herror T_add_deformable_surface_model_sample( const Htuple DeformableSurfaceModel, const Htuple ObjectModel3D )

static void HObjectModel3D::AddDeformableSurfaceModelSample( const HDeformableSurfaceModel& DeformableSurfaceModel, const HObjectModel3DArray& ObjectModel3D )

void HObjectModel3D::AddDeformableSurfaceModelSample( const HDeformableSurfaceModel& DeformableSurfaceModel ) const

void HDeformableSurfaceModel::AddDeformableSurfaceModelSample( const HObjectModel3DArray& ObjectModel3D ) const

void HDeformableSurfaceModel::AddDeformableSurfaceModelSample( const HObjectModel3D& ObjectModel3D ) const

static void HObjectModel3D.AddDeformableSurfaceModelSample( HDeformableSurfaceModel deformableSurfaceModel, HObjectModel3D[] objectModel3D )

void HObjectModel3D.AddDeformableSurfaceModelSample( HDeformableSurfaceModel deformableSurfaceModel )

void HDeformableSurfaceModel.AddDeformableSurfaceModelSample( HObjectModel3D[] objectModel3D )

void HDeformableSurfaceModel.AddDeformableSurfaceModelSample( HObjectModel3D objectModel3D )

Description

The operator add_deformable_surface_model_sampleAddDeformableSurfaceModelSample adds the example deformation passed in ObjectModel3DobjectModel3Dobject_model_3d to the deformable surface model DeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model. The point cloud given in ObjectModel3DobjectModel3Dobject_model_3d must have exactly as many points as the sampled deformation model, and is usually the result of the operator find_deformable_surface_modelFindDeformableSurfaceModel or refine_deformable_surface_modelRefineDeformableSurfaceModel. The deformable surface model must have been created beforehand using, for example, create_deformable_surface_modelCreateDeformableSurfaceModel. The operator re-trains the deformable surface model including the passed deformation. This allows find_deformable_surface_modelFindDeformableSurfaceModel to find deformations that are similar to the one given in ObjectModel3DobjectModel3Dobject_model_3d.

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 supports canceling timeouts and interrupts.

This operator modifies the state of the following input parameter:

• DeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

DeformableSurfaceModeldeformableSurfaceModeldeformable_surface_model (input_control, state is modified) deformable_surface_model → (handle)HTuple (HHandle)HDeformableSurfaceModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the deformable surface model.

ObjectModel3DobjectModel3Dobject_model_3d (input_control) object_model_3d(-array) → (handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)MaybeSequence[HHandle]Htuple (handle)

Handle of the deformed 3D object model.

Result

add_deformable_surface_model_sampleAddDeformableSurfaceModelSample returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

create_deformable_surface_modelCreateDeformableSurfaceModel, find_deformable_surface_modelFindDeformableSurfaceModel, refine_deformable_surface_modelRefineDeformableSurfaceModel

Possible successors

find_deformable_surface_modelFindDeformableSurfaceModel, refine_deformable_surface_modelRefineDeformableSurfaceModel, get_deformable_surface_model_paramGetDeformableSurfaceModelParam, write_deformable_surface_modelWriteDeformableSurfaceModel, clear_deformable_surface_modelClearDeformableSurfaceModel

Alternatives

read_deformable_surface_modelReadDeformableSurfaceModel

See also

find_deformable_surface_modelFindDeformableSurfaceModel, refine_deformable_surface_modelRefineDeformableSurfaceModel, read_deformable_surface_modelReadDeformableSurfaceModel, create_deformable_surface_modelCreateDeformableSurfaceModel, write_deformable_surface_modelWriteDeformableSurfaceModel, clear_deformable_surface_modelClearDeformableSurfaceModel

Module

3D Metrology