set_deformable_model_originT_set_deformable_model_originSetDeformableModelOriginSetDeformableModelOrigin (Operator)
Name
set_deformable_model_originT_set_deformable_model_originSetDeformableModelOriginSetDeformableModelOrigin — Set the origin (reference point) of a deformable model.
Signature
Herror T_set_deformable_model_origin(const Htuple ModelID, const Htuple Row, const Htuple Column)
Description
The operator set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginSetDeformableModelOrigin sets the origin
(reference point) of the deformable model ModelIDModelIDModelIDModelIDmodelID 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_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModel.
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_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModel the 3D pose of the origin
changes by the respective translation. Hence, further calls of
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModel will include the pose offset.
If a deformable model was created by
create_planar_calib_deformable_model_xldcreate_planar_calib_deformable_model_xldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXldCreatePlanarCalibDeformableModelXld 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
- 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:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
ModelIDModelIDModelIDModelIDmodelID (input_control, state is modified) deformable_model → HDeformableModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
RowRowRowRowrow (input_control) point.y → HTupleHTupleHtuple (real) (double) (double) (double)
Row coordinate of the origin of the deformable model.
ColumnColumnColumnColumncolumn (input_control) point.x → HTupleHTupleHtuple (real) (double) (double) (double)
Column coordinate of the origin of the deformable model.
Result
If the handle of the model is valid, the operator
set_deformable_model_originset_deformable_model_originSetDeformableModelOriginSetDeformableModelOriginSetDeformableModelOrigin returns the value 2 (H_MSG_TRUE). If necessary
an exception is raised.
Possible Predecessors
create_planar_uncalib_deformable_modelcreate_planar_uncalib_deformable_modelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModelCreatePlanarUncalibDeformableModel,
create_planar_calib_deformable_modelcreate_planar_calib_deformable_modelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModelCreatePlanarCalibDeformableModel,
create_local_deformable_modelcreate_local_deformable_modelCreateLocalDeformableModelCreateLocalDeformableModelCreateLocalDeformableModel,
read_deformable_modelread_deformable_modelReadDeformableModelReadDeformableModelReadDeformableModel
Possible Successors
find_planar_uncalib_deformable_modelfind_planar_uncalib_deformable_modelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModelFindPlanarUncalibDeformableModel,
find_planar_calib_deformable_modelfind_planar_calib_deformable_modelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModelFindPlanarCalibDeformableModel,
get_deformable_model_originget_deformable_model_originGetDeformableModelOriginGetDeformableModelOriginGetDeformableModelOrigin
See also
area_centerarea_centerAreaCenterAreaCenterAreaCenter
Module
Matching