Operator Reference

HALCON Operator Reference / Matching / Shape-Based

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

get_generic_shape_model_objectT_get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object (Operator)

get_generic_shape_model_objectT_get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object — Get iconic objects of the shape model.

Signature

get_generic_shape_model_object( : Object : ModelID, GenParamName : )

Herror T_get_generic_shape_model_object(Hobject* Object, const Htuple ModelID, const Htuple GenParamName)

void GetGenericShapeModelObject(HObject* Object, const HTuple& ModelID, const HTuple& GenParamName)

HObject HShapeModel::GetGenericShapeModelObject(const HTuple& GenParamName) const

static void HOperatorSet.GetGenericShapeModelObject(out HObject objectVal, HTuple modelID, HTuple genParamName)

HObject HShapeModel.GetGenericShapeModelObject(HTuple genParamName)

def get_generic_shape_model_object(model_id: HHandle, gen_param_name: Sequence[str]) -> HObject

Description

The operator get_generic_shape_model_objectget_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object reads out objects of the shape model ModelIDModelIDModelIDmodelIDmodel_id and returns them in ObjectObjectObjectobjectValobject.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name specifies which iconic object will be returned. The following values are possible:

'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region":

The clutter region of the shape model.

'contours'"contours""contours""contours""contours":

Representation of the shape model ModelIDModelIDModelIDmodelIDmodel_id for the bottom-most pyramid level as XLD contours. Thereby the contour is translated so that the origin of the model with the coordinates 'origin_row'"origin_row""origin_row""origin_row""origin_row" and 'origin_column'"origin_column""origin_column""origin_column""origin_column" (see set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param) is located at the origin of the pixel centered HALCON standard coordinate system (see Transformations / 2D Transformations). The contours can be used, for example, to visualize the found instances of the model in an image.

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

ObjectObjectObjectobjectValobject (output_object)  (multichannel-)object(-array) → objectHObjectHObjectHObjectHobject *

Iconic object to be returned.

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

Handle of the shape model.

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  string-array → HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Parameter names.

Default: 'clutter_region' "clutter_region" "clutter_region" "clutter_region" "clutter_region"

List of values: 'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region", 'contours'"contours""contours""contours""contours"

Result

If the parameters are valid, the operator get_generic_shape_model_objectget_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object 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, set_generic_shape_model_objectset_generic_shape_model_objectSetGenericShapeModelObjectSetGenericShapeModelObjectset_generic_shape_model_object, train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model

Module

Matching

---

ClassesClasses | | Operators