get_generic_shape_model_objectT_get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object (Operator)
Name
get_generic_shape_model_objectT_get_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object — Get iconic objects of the shape model.
Signature
Description
The operator get_generic_shape_model_objectget_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectGetGenericShapeModelObjectget_generic_shape_model_object reads out objects
of the shape model ModelIDModelIDModelIDModelIDmodelIDmodel_id and returns them in ObjectObjectObjectObjectobjectValobject.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name specifies which iconic object will be returned.
The following values are possible:
- 'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region""clutter_region":
The clutter region of the shape model.
- 'contours'"contours""contours""contours""contours""contours":
Representation of the shape model ModelIDModelIDModelIDModelIDmodelIDmodel_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""origin_row" and
'origin_column'"origin_column""origin_column""origin_column""origin_column""origin_column" (see set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_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
ObjectObjectObjectObjectobjectValobject (output_object) (multichannel-)object(-array) → objectHObjectHObjectHObjectHobject *
Iconic object to be returned.
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the shape model.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_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"
"clutter_region"
List of values:
'clutter_region'"clutter_region""clutter_region""clutter_region""clutter_region""clutter_region", 'contours'"contours""contours""contours""contours""contours"
Result
If the parameters are valid, the operator
get_generic_shape_model_objectget_generic_shape_model_objectGetGenericShapeModelObjectGetGenericShapeModelObjectGetGenericShapeModelObjectget_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_modelCreateGenericShapeModelCreateGenericShapeModelCreateGenericShapeModelcreate_generic_shape_model,
set_generic_shape_model_objectset_generic_shape_model_objectSetGenericShapeModelObjectSetGenericShapeModelObjectSetGenericShapeModelObjectset_generic_shape_model_object,
train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model
Module
Matching