Skip to content

get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_objectT_get_generic_shape_model_object🔗

Short description🔗

get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_objectT_get_generic_shape_model_object — Get iconic objects of the shape model.

Signature🔗

get_generic_shape_model_object( out object Object, shape_model ModelID, string GenParamName )void GetGenericShapeModelObject( HObject* Object, const HTuple& ModelID, const HTuple& GenParamName )static void HOperatorSet.GetGenericShapeModelObject( out HObject objectVal, HTuple modelID, HTuple genParamName )def get_generic_shape_model_object( model_id: HHandle, gen_param_name: Sequence[str] ) -> HObject

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

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

HObject HShapeModel.GetGenericShapeModelObject( HTuple genParamName )

Description🔗

The operator get_generic_shape_model_objectGetGenericShapeModelObject reads out objects of the shape model ModelIDmodelIDmodel_id and returns them in ObjectobjectValobject.

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

  • 'clutter_region'"clutter_region": The clutter region of the shape model.

  • 'contours'"contours": Representation of the shape model ModelIDmodelIDmodel_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" and 'origin_column'"origin_column" (see set_generic_shape_model_paramSetGenericShapeModelParam) 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🔗

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🔗

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

Iconic object to be returned.

ModelIDmodelIDmodel_id (input_control) shape_model → (handle)HTuple (HHandle)HShapeModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the shape model.

GenParamNamegenParamNamegen_param_name (input_control) string-array → (string)HTuple (HString)HTuple (string)Sequence[str]Htuple (char*)

Parameter names.

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

Result🔗

If the parameters are valid, the operator get_generic_shape_model_objectGetGenericShapeModelObject returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

create_generic_shape_modelCreateGenericShapeModel, set_generic_shape_model_objectSetGenericShapeModelObject, train_generic_shape_modelTrainGenericShapeModel

Module🔗

Matching