set_shape_model_originT_set_shape_model_originSetShapeModelOriginSetShapeModelOriginset_shape_model_origin (Operator)

Name

set_shape_model_originT_set_shape_model_originSetShapeModelOriginSetShapeModelOriginset_shape_model_origin — Set the origin (reference point) of a shape model.

Signature

set_shape_model_origin( : : ModelID, Row, Column : )

Description

The operator set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginset_shape_model_origin sets the origin (reference point) of the shape model ModelIDModelIDModelIDmodelIDmodel_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 shape model with create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model, or create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model. Hence, an origin of (0,0) means that the center of gravity of the domain of the model 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.

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:

ModelIDModelIDModelIDmodelIDmodel_id

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

Parameters

ModelIDModelIDModelIDmodelIDmodel_id (input_control, state is modified) shape_model → (handle)

Handle of the model.

RowRowRowrowrow (input_control) point.y → (real)

Row coordinate of the origin of the shape model.

ColumnColumnColumncolumncolumn (input_control) point.x → (real)

Column coordinate of the origin of the shape model.

Result

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