Operator Reference

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

get_generic_shape_model_result_objectT_get_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object (Operator)

get_generic_shape_model_result_objectT_get_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object — Get objects from a shape matching result.

Signature

get_generic_shape_model_result_object( : Objects : MatchResultID, MatchSelector, GenParamName : )

Herror T_get_generic_shape_model_result_object(Hobject* Objects, const Htuple MatchResultID, const Htuple MatchSelector, const Htuple GenParamName)

void GetGenericShapeModelResultObject(HObject* Objects, const HTuple& MatchResultID, const HTuple& MatchSelector, const HTuple& GenParamName)

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const HString& GenParamName) const

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const char* GenParamName) const

HObject HGenericShapeModelResult::GetGenericShapeModelResultObject(const HTuple& MatchSelector, const wchar_t* GenParamName) const   ( Windows only)

static void HOperatorSet.GetGenericShapeModelResultObject(out HObject objects, HTuple matchResultID, HTuple matchSelector, HTuple genParamName)

HObject HGenericShapeModelResult.GetGenericShapeModelResultObject(HTuple matchSelector, string genParamName)

def get_generic_shape_model_result_object(match_result_id: HHandle, match_selector: Sequence[Union[str, int]], gen_param_name: str) -> HObject

Description

get_generic_shape_model_result_objectget_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object returns iconic results of shape-based matching in ObjectsObjectsObjectsobjectsobjects. The results are contained in MatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id.

The parameter MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector is used to select from which matches the result values shall be returned. For more information and the list of supported values for MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector see get_generic_shape_model_resultget_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result.

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

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

Model contours transformed according to the matching result.

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

Region where no clutter should occur.

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

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

Objects of the queried result.

MatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id (input_control)  generic_shape_model_result → HGenericShapeModelResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the shape model matches.

MatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector (input_control)  string-array → HTupleSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Selector for the matching results to be queried.

Default: 'all' "all" "all" "all" "all"

List of values: 'all'"all""all""all""all", 'best'"best""best""best""best"

GenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the queried result object.

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

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_result_objectget_generic_shape_model_result_objectGetGenericShapeModelResultObjectGetGenericShapeModelResultObjectget_generic_shape_model_result_object returns the value 2 ( H_MSG_TRUE) . If necessary an exception is raised.

Possible Predecessors

find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model

Module

Matching

ClassesClasses | | Operators