query_aop_infoT_query_aop_infoQueryAopInfoQueryAopInfo (Operator)

Name

query_aop_infoT_query_aop_infoQueryAopInfoQueryAopInfo — Query indexing structure of AOP information for operators.

Signature

Description

HALCON supports a mechanism to adapt the behavior of automatic parallelization of image processing operators (AOP) to the machine's hardware capability. The information for this adaption can be obtained by the operator optimize_aopoptimize_aopOptimizeAopOptimizeAopOptimizeAop and can be partly read and modified by the operators get_aop_infoget_aop_infoGetAopInfoGetAopInfoGetAopInfo and set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfo, respectively. To address specific AOP information the operator's optimization data is indexed within a 3-ary hierarchy that can be obtained by query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoQueryAopInfo. The three hierarchy stages are indexed by the operator name, the iconic type, and a parameter string value denoting a special mode or method supported by the operator.

If an empty string ''"""""""" is passed to OperatorNameOperatorNameOperatorNameOperatorNameoperatorName, the parameters IndexNameIndexNameIndexNameIndexNameindexName and IndexValueIndexValueIndexValueIndexValueindexValue are ignored and all operator names in ValueValueValueValuevalue are returned, for which optimization data is stored. NameNameNameNamename contains the index identifier 'operator'"operator""operator""operator""operator" as many times as operator names are returned. Specifying a single operator name in OperatorNameOperatorNameOperatorNameOperatorNameoperatorName and passing an empty string ''"""""""" to the parameters IndexNameIndexNameIndexNameIndexNameindexName and IndexValueIndexValueIndexValueIndexValueindexValue queries all iconic types the operator holds optimization data for. ValueValueValueValuevalue contains the type strings, NameNameNameNamename the index identifier 'iconic_type'"iconic_type""iconic_type""iconic_type""iconic_type", respectively. Finally, when specifying a certain operator in OperatorNameOperatorNameOperatorNameOperatorNameoperatorName and a specific iconic type by passing the dimension identifier 'iconic_type'"iconic_type""iconic_type""iconic_type""iconic_type" to IndexNameIndexNameIndexNameIndexNameindexName and the specific iconic type to IndexValueIndexValueIndexValueIndexValueindexValue, NameNameNameNamename contains the parameter index identifier ValueValueValueValuevalue holds the parameter string values supported by the operator. The format of the parameter identifier string is compound containing the string 'parameter'"parameter""parameter""parameter""parameter", followed by a colon separator ':'":"":"":"":" and a digit, denoting the parameter index (starting with 1). If the operator does not support any mode parameter or the operator's parameter values were not varied during optimization process of optimize_aopoptimize_aopOptimizeAopOptimizeAopOptimizeAop the string 'parameter:0'"parameter:0""parameter:0""parameter:0""parameter:0" is returned for NameNameNameNamename and ValueValueValueValuevalue contains an empty string. In case no AOP information is stored for the specified index, NameNameNameNamename returns an empty string.

Execution Information

• Multithreading type: exclusive (runs in parallel only with independent operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

Result

query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoQueryAopInfo returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Module

Foundation