get_generic_shape_model_resultT_get_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result (Operator)

Name

get_generic_shape_model_resultT_get_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result — Get alphanumerical values from a shape matching result.

Signature

get_generic_shape_model_result( : : MatchResultID, MatchSelector, GenParamName : GenParamValue)

Herror T_get_generic_shape_model_result(const Htuple MatchResultID, const Htuple MatchSelector, const Htuple GenParamName, Htuple* GenParamValue)

void GetGenericShapeModelResult(const HTuple& MatchResultID, const HTuple& MatchSelector, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HGenericShapeModelResult::GetGenericShapeModelResult(const HTuple& MatchSelector, const HString& GenParamName) const

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

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

static void HOperatorSet.GetGenericShapeModelResult(HTuple matchResultID, HTuple matchSelector, HTuple genParamName, out HTuple genParamValue)

HTuple HGenericShapeModelResult.GetGenericShapeModelResult(HTuple matchSelector, string genParamName)

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

Description

get_generic_shape_model_resultget_generic_shape_model_resultGetGenericShapeModelResultGetGenericShapeModelResultGetGenericShapeModelResultget_generic_shape_model_result returns alphanumerical results of shape-based matching in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. The matches are contained in MatchResultIDMatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id and sorted by descending score.

The parameter MatchSelectorMatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector is used to select from which matches the result values shall be returned. The sorting remains according to their score. Hence, it is independent of the order of the selection criteria passed in MatchSelectorMatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector. Furthermore, a matching result is only returned once even if it meets more than one selection criterion.

MatchSelectorMatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector processes selection criteria of the following types or combinations of them:

If MatchSelectorMatchSelectorMatchSelectorMatchSelectormatchSelectormatch_selector is no valid selection criterion, an exception is raised.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name specifies which alphanumerical result value will be returned. The following values are possible:

Note that for values regarding the location of the matches coordinates are given as edge centered coordinates. For more information on edge centered coordinates see the chapter Transformations / 2D Transformations.

Execution Information

Parameters

MatchResultIDMatchResultIDMatchResultIDMatchResultIDmatchResultIDmatch_result_id (input_control)  generic_shape_model_result HGenericShapeModelResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the shape model matches.

MatchSelectorMatchSelectorMatchSelectorMatchSelectormatchSelectormatch_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" "all"

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

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the queried result parameter.

Default: 'score' "score" "score" "score" "score" "score"

List of values: 'angle'"angle""angle""angle""angle""angle", 'clutter_hom_mat_2d'"clutter_hom_mat_2d""clutter_hom_mat_2d""clutter_hom_mat_2d""clutter_hom_mat_2d""clutter_hom_mat_2d", 'clutter_score'"clutter_score""clutter_score""clutter_score""clutter_score""clutter_score", 'column'"column""column""column""column""column", 'hom_mat_2d'"hom_mat_2d""hom_mat_2d""hom_mat_2d""hom_mat_2d""hom_mat_2d", 'match'"match""match""match""match""match", 'model_identifier'"model_identifier""model_identifier""model_identifier""model_identifier""model_identifier", 'num_match_result'"num_match_result""num_match_result""num_match_result""num_match_result""num_match_result", 'row'"row""row""row""row""row", 'scale_column'"scale_column""scale_column""scale_column""scale_column""scale_column", 'scale_row'"scale_row""scale_row""scale_row""scale_row""scale_row", 'score'"score""score""score""score""score", 'time_measurement'"time_measurement""time_measurement""time_measurement""time_measurement""time_measurement"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control)  attribute.value-array HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Value of the queried result parameter.

Result

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

Possible Predecessors

find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model

Module

Matching