Operator Reference

HALCON Operator Reference / Matching / Shape-Based
ClassesClasses | | Operators

get_shape_model_originT_get_shape_model_originGetShapeModelOriginGetShapeModelOriginget_shape_model_origin (Operator)

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

Signature

get_shape_model_origin( : : ModelID : Row, Column)

Herror T_get_shape_model_origin(const Htuple ModelID, Htuple* Row, Htuple* Column)

void GetShapeModelOrigin(const HTuple& ModelID, HTuple* Row, HTuple* Column)

void HShapeModel::GetShapeModelOrigin(double* Row, double* Column) const

static void HOperatorSet.GetShapeModelOrigin(HTuple modelID, out HTuple row, out HTuple column)

void HShapeModel.GetShapeModelOrigin(out double row, out double column)

def get_shape_model_origin(model_id: HHandle) -> Tuple[float, float]

Description

The operator get_shape_model_originget_shape_model_originGetShapeModelOriginGetShapeModelOriginget_shape_model_origin returns the origin (reference point) of the shape model ModelIDModelIDModelIDmodelIDmodel_id. 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.

Parameters

ModelIDModelIDModelIDmodelIDmodel_id (input_control)  shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the model.

RowRowRowrowrow (output_control)  point.y → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Row coordinate of the origin of the shape model.

ColumnColumnColumncolumncolumn (output_control)  point.x → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Column coordinate of the origin of the shape model.

Result

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

Possible Predecessors

create_generic_shape_modelcreate_generic_shape_modelCreateGenericShapeModelCreateGenericShapeModelcreate_generic_shape_model, read_shape_modelread_shape_modelReadShapeModelReadShapeModelread_shape_model, set_shape_model_originset_shape_model_originSetShapeModelOriginSetShapeModelOriginset_shape_model_origin

Possible Successors

find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model

See also

area_centerarea_centerAreaCenterAreaCenterarea_center

Module

Matching

ClassesClasses | | Operators