set_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginset_deformable_model_originT_set_deformable_model_origin

HALCON ScriptCpp++.NETPythonC

Short description

set_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginset_deformable_model_originT_set_deformable_model_origin — Set the origin (reference point) of a deformable model.

Signature

set_deformable_model_origin( deformable_model ModelID, point.y Row, point.x Column )void SetDeformableModelOrigin( const HTuple& ModelID, const HTuple& Row, const HTuple& Column )static void HOperatorSet.SetDeformableModelOrigin( HTuple modelID, HTuple row, HTuple column )def set_deformable_model_origin( model_id: HHandle, row: float, column: float ) -> None

Herror T_set_deformable_model_origin( const Htuple ModelID, const Htuple Row, const Htuple Column )

void HDeformableModel::SetDeformableModelOrigin( double Row, double Column ) const

void HDeformableModel.SetDeformableModelOrigin( double row, double column )

Description

The operator set_deformable_model_originSetDeformableModelOrigin sets the origin (reference point) of the deformable model ModelIDmodelIDmodel_id to a new value. The origin is specified relative to the center of gravity of the domain (region) of the image that was used to create the deformable model with create_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModel. Hence, an origin of (0,0) means that the center of gravity of the domain of the deformable image is used as the origin. An origin of (-20,-40) means that the origin lies to the upper left of the center of gravity. If a deformable model was created by create_planar_calib_deformable_modelCreatePlanarCalibDeformableModel the 3D pose of the origin changes by the respective translation. Hence, further calls of find_planar_calib_deformable_modelFindPlanarCalibDeformableModel will include the pose offset. If a deformable model was created by create_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXld the 3D pose of the origin changes directly by the offset. This means that the offsets are interpreted in world coordinates. In this case, the row coordinate corresponds to the y world coordinate (from top to down) and the column coordinate corresponds to the x world coordinate (from left to right).

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 modifies the state of the following input parameter:

• ModelIDmodelIDmodel_id

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

Parameters

ModelIDmodelIDmodel_id (input_control, state is modified) deformable_model → (handle)HTuple (HHandle)HDeformableModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the model.

Rowrowrow (input_control) point.y → (real)HTuple (double)HTuple (double)floatHtuple (double)

Row coordinate of the origin of the deformable model.

Columncolumncolumn (input_control) point.x → (real)HTuple (double)HTuple (double)floatHtuple (double)

Column coordinate of the origin of the deformable model.

Result

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

Combinations with other operators

Combinations

Possible predecessors

create_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModel, create_planar_calib_deformable_modelCreatePlanarCalibDeformableModel, create_local_deformable_modelCreateLocalDeformableModel, read_deformable_modelReadDeformableModel

Possible successors

find_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModel, find_planar_calib_deformable_modelFindPlanarCalibDeformableModel, get_deformable_model_originGetDeformableModelOrigin

See also

area_centerAreaCenter

Module

Matching