set_shape_model_originT_set_shape_model_originSetShapeModelOriginSetShapeModelOrigin (Operator)

Name

set_shape_model_originT_set_shape_model_originSetShapeModelOriginSetShapeModelOrigin — 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_originSetShapeModelOriginSetShapeModelOriginSetShapeModelOrigin sets the origin (reference point) of the shape 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 shape model with create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelCreateScaledShapeModel, or create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelCreateAnisoShapeModel. 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:

ModelIDModelIDModelIDModelIDmodelID

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

ModelIDModelIDModelIDModelIDmodelID (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.

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