get_shape_model_origin ( : : ModelID : Row, Column )

Return the origin (reference point) of a shape model.

The operator get_shape_model_origin returns the origin (reference point) of the shape model ModelID. 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_model or create_scaled_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.


Parameters

ModelID (input_control)
shape_model -> integer
Handle of the model.

Row (output_control)
point.y -> real
Row coordinate of the origin of the shape model.

Column (output_control)
point.x -> real
Column coordinate of the origin of the shape model.


Result

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


Parallelization Information

get_shape_model_origin is processed completely exclusively without parallelization.


Possible Predecessors

create_shape_model, create_scaled_shape_model, read_shape_model, set_shape_model_origin


Possible Successors

find_shape_model, find_scaled_shape_model, find_shape_models, find_scaled_shape_models


See also

area_center


Module

Matching



Copyright © 1996-2008 MVTec Software GmbH