set_bar_code_param_specificT_set_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific (算子)
名称
set_bar_code_param_specificT_set_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific — 为选定的条形码类型设置条形码模型的选定参数。
签名
void SetBarCodeParamSpecific(const HTuple& BarCodeHandle, const HTuple& CodeTypes, const HTuple& GenParamName, const HTuple& GenParamValue)
void HBarCode::SetBarCodeParamSpecific(const HTuple& CodeTypes, const HTuple& GenParamName, const HTuple& GenParamValue) const
void HBarCode::SetBarCodeParamSpecific(const HString& CodeTypes, const HString& GenParamName, const HTuple& GenParamValue) const
void HBarCode::SetBarCodeParamSpecific(const char* CodeTypes, const char* GenParamName, const HTuple& GenParamValue) const
void HBarCode::SetBarCodeParamSpecific(const wchar_t* CodeTypes, const wchar_t* GenParamName, const HTuple& GenParamValue) const
(
Windows only)
描述
算子 set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific is used to set or change
the different parameters of a bar code model for selected bar code types
in order to adapt to special properties of the bar codes.
Contrary to set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param, only parameters for selected bar
code types will be changed with set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific.
This is useful when searching different code types within one image (see
section Autodiscrimination in find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code).
The current configuration of the bar code model for a specified bar code
type can be queried with get_bar_code_param_specificget_bar_code_param_specificGetBarCodeParamSpecificGetBarCodeParamSpecificGetBarCodeParamSpecificget_bar_code_param_specific。
The following generic parameters can be set for specific bar code types:
- 'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines""num_scanlines"：
-
Maximal number of scanlines used during the scanning of a (candidate)
bar code.
建议值：
[0, 5, 10,
20, ...]
默认值：
0
- 'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines"：
-
Minimal number of decoded scanlines which return
identical data to read the bar code successfully.
建议值：
[0, 2, 3,
...]
默认值：
|
Bar code Type |
'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines" |
|
2/5 Industrial |
2 |
|
2/5 Interleaved |
2 |
|
all others |
0
|
- 'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num"：
-
Number of successfully decoded bar codes of the given code type after
which the decoding will stop.
建议值：
[0, 1, 2,
...]
默认值：
0
- 'orientation'"orientation""orientation""orientation""orientation""orientation"：
-
Expected bar code orientation.
建议值：
[-90.0 ... 90.0]
默认值：
0.0
- 'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol""orientation_tol"：
-
Orientation tolerance.
建议值：
[0.0 ... 90.0]
默认值：
90.0
- 'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone""quiet_zone"：
-
Enforces the verification of quiet zones of a bar code symbol.
建议值：
'false'"false""false""false""false""false", 'true'"true""true""true""true""true", 1,
2, 3, 4,
5
默认值：
'false'"false""false""false""false""false"
- 'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance"：
-
Start/stop search criteria tolerance. Currently this is implemented
only for Code 128 and GS1-128.
值列表：
'high'"high""high""high""high""high", 'low'"low""low""low""low""low"
默认值：
'high'"high""high""high""high""high"
- 'check_char'"check_char""check_char""check_char""check_char""check_char"：
-
Handling of an optional check character.
值列表：
'absent'"absent""absent""absent""absent""absent", 'present'"present""present""present""present""present",
'preserved'"preserved""preserved""preserved""preserved""preserved"
默认值：
'absent'"absent""absent""absent""absent""absent"
- 'composite_code'"composite_code""composite_code""composite_code""composite_code""composite_code"：
-
Find and decode a composite component.
值列表：
'none'"none""none""none""none""none", 'CC-A/B'"CC-A/B""CC-A/B""CC-A/B""CC-A/B""CC-A/B"
默认值：
'none'"none""none""none""none""none"
- 'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length""min_code_length"：
-
Minimal number of decoded characters.
默认值：
|
Bar code Type |
'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length""min_code_length" |
|
2/5 Industrial |
3 |
|
2/5 Interleaved |
3 |
|
all others |
0
|
- 'max_code_length'"max_code_length""max_code_length""max_code_length""max_code_length""max_code_length"：
-
Maximum number of decoded characters.
值范围：
[1 ...
2147483647]
默认值：
2147483647
Further details on these parameters can be found with the
description of the operator set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param。
It is possible to supply multivalue tuples for CodeTypesCodeTypesCodeTypesCodeTypescodeTypescode_types,
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name, and GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value. The n-th entry
of one multivalue tuple corresponds to the n-th entry of the other
multivalue tuple. The following combinations are allowed:
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子修改后续输入参数的状态：
在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。
参数
BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandlebar_code_handle (输入控制，状态被修改) barcode → HBarCode, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the bar code model.
CodeTypesCodeTypesCodeTypesCodeTypescodeTypescode_types (输入控制) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Names of the bar code types for which parameters
should be set.
默认值：
'EAN-13'
"EAN-13"
"EAN-13"
"EAN-13"
"EAN-13"
"EAN-13"
值列表：
'2/5 Industrial'"2/5 Industrial""2/5 Industrial""2/5 Industrial""2/5 Industrial""2/5 Industrial", '2/5 Interleaved'"2/5 Interleaved""2/5 Interleaved""2/5 Interleaved""2/5 Interleaved""2/5 Interleaved", 'Codabar'"Codabar""Codabar""Codabar""Codabar""Codabar", 'Code 128'"Code 128""Code 128""Code 128""Code 128""Code 128", 'Code 39'"Code 39""Code 39""Code 39""Code 39""Code 39", 'Code 93'"Code 93""Code 93""Code 93""Code 93""Code 93", 'EAN-13 Add-On 2'"EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2""EAN-13 Add-On 2", 'EAN-13 Add-On 5'"EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5""EAN-13 Add-On 5", 'EAN-13'"EAN-13""EAN-13""EAN-13""EAN-13""EAN-13", 'EAN-8 Add-On 2'"EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2""EAN-8 Add-On 2", 'EAN-8 Add-On 5'"EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5""EAN-8 Add-On 5", 'EAN-8'"EAN-8""EAN-8""EAN-8""EAN-8""EAN-8", 'GS1 DataBar Expanded Stacked'"GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked""GS1 DataBar Expanded Stacked", 'GS1 DataBar Expanded'"GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded""GS1 DataBar Expanded", 'GS1 DataBar Limited'"GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited""GS1 DataBar Limited", 'GS1 DataBar Omnidir'"GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir""GS1 DataBar Omnidir", 'GS1 DataBar Stacked Omnidir'"GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir""GS1 DataBar Stacked Omnidir", 'GS1 DataBar Stacked'"GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked""GS1 DataBar Stacked", 'GS1 DataBar Truncated'"GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated""GS1 DataBar Truncated", 'GS1-128'"GS1-128""GS1-128""GS1-128""GS1-128""GS1-128", 'MSI'"MSI""MSI""MSI""MSI""MSI", 'PharmaCode'"PharmaCode""PharmaCode""PharmaCode""PharmaCode""PharmaCode", 'UPC-A Add-On 2'"UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2""UPC-A Add-On 2", 'UPC-A Add-On 5'"UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5""UPC-A Add-On 5", 'UPC-A'"UPC-A""UPC-A""UPC-A""UPC-A""UPC-A", 'UPC-E Add-On 2'"UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2""UPC-E Add-On 2", 'UPC-E Add-On 5'"UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5""UPC-E Add-On 5", 'UPC-E'"UPC-E""UPC-E""UPC-E""UPC-E""UPC-E"
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (输入控制) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Names of the generic parameters that shall be
adjusted for finding and decoding bar codes.
默认值：
'check_char'
"check_char"
"check_char"
"check_char"
"check_char"
"check_char"
值列表：
'check_char'"check_char""check_char""check_char""check_char""check_char", 'composite_code'"composite_code""composite_code""composite_code""composite_code""composite_code", 'max_code_length'"max_code_length""max_code_length""max_code_length""max_code_length""max_code_length", 'min_code_length'"min_code_length""min_code_length""min_code_length""min_code_length""min_code_length", 'min_identical_scanlines'"min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines""min_identical_scanlines", 'num_scanlines'"num_scanlines""num_scanlines""num_scanlines""num_scanlines""num_scanlines", 'orientation'"orientation""orientation""orientation""orientation""orientation", 'orientation_tol'"orientation_tol""orientation_tol""orientation_tol""orientation_tol""orientation_tol", 'quiet_zone'"quiet_zone""quiet_zone""quiet_zone""quiet_zone""quiet_zone", 'start_stop_tolerance'"start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance""start_stop_tolerance", 'stop_after_result_num'"stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num""stop_after_result_num"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (输入控制) attribute.name-array → HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Values of the generic parameters that are
adjusted for finding and decoding bar codes.
默认值：
'absent'
"absent"
"absent"
"absent"
"absent"
"absent"
建议值：
0, 1, 2, 4, 45, 90, 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'present'"present""present""present""present""present", 'absent'"absent""absent""absent""absent""absent", 'none'"none""none""none""none""none", 'CC-A/B'"CC-A/B""CC-A/B""CC-A/B""CC-A/B""CC-A/B", 'high'"high""high""high""high""high", 'low'"low""low""low""low""low"
结果
算子 set_bar_code_param_specificset_bar_code_param_specificSetBarCodeParamSpecificSetBarCodeParamSpecificSetBarCodeParamSpecificset_bar_code_param_specific 在给定的参数正确时返回值 2 ( H_MSG_TRUE )。否则，将抛出异常。
可能的前趋
create_bar_code_modelcreate_bar_code_modelCreateBarCodeModelCreateBarCodeModelCreateBarCodeModelcreate_bar_code_model
可能的后继
find_bar_codefind_bar_codeFindBarCodeFindBarCodeFindBarCodefind_bar_code
替代
set_bar_code_paramset_bar_code_paramSetBarCodeParamSetBarCodeParamSetBarCodeParamset_bar_code_param
模块
条形码