find_1d_bar_code_regionT_find_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion (Operator)

Name

find_1d_bar_code_regionT_find_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion — Look for multiple bar code regions in an image.

Warning

find_1d_bar_code_regionfind_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion is obsolete and is only provided for reasons of backward compatibility. New applications for reading bar codes should use the functionalities in the chapter Identification / Bar Code instead (see find_bar_codefind_bar_codefind_bar_codeFindBarCodeFindBarCode).

Signature

Description

find_1d_bar_code_regionfind_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion looks for multiple barcodes in the image. In contrast to find_1d_bar_codefind_1d_bar_codefind_1d_bar_codeFind1dBarCodeFind1dBarCode this operator is used if an image contains more than one bar code. Here only the regions but not the widths of the elements are extracted. For every region the orientation in radians is calculated.

In images showing several barcodes with varying orientation only those in the dominating orientation are found. The same applies, if other structures such as text or texture dominate the picture. This may prevent barcode regions that have a different orientation from being found.

The control of the image processing is identical to find_1d_bar_codefind_1d_bar_codefind_1d_bar_codeFind1dBarCodeFind1dBarCode. The description of the parameters GenericNameGenericNameGenericNameGenericNamegenericName and GenericValueGenericValueGenericValueGenericValuegenericValue can be found at this operator.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (C++)

HTuple   empty;   // empty list of values
HTuple   BarCodeDescr;
HTuple   Orientations, Elements;
HTuple   Characters,Reference,IsCorrect;
Hobject  Image,CodeRegions,CodeRegion,GrayRegion;
long     num;

gen_1d_bar_code_descr("code 39",4,15,&BarCodeDescr);
find_1d_bar_code_region(Image,&CodeRegion,BarCodeDescr,empty,empty,
                        &Orientations);
count_obj(CodeRegions,&num);
for (long i=0; i<num; i++)
{
  select_obj(CodeRegions,&CodeRegion,i);
  reduce_domain(Image,CodeRegion,GrayRegion)\:
  get_1d_bar_code(GrayRegion,BarCodeDescr,empty,empty,Orientations[i],
                  &Elements);
  decode_1d_bar_code(Elements,BarCodeDescr,
                     &Characters,&Reference,&IsCorrect);
}

Result

The operator find_1d_bar_code_regionfind_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion returns the value 2 (H_MSG_TRUE) if the parameters are correct and at least one bar code is found.

Possible Predecessors

gen_1d_bar_code_descrgen_1d_bar_code_descrgen_1d_bar_code_descrGen1dBarCodeDescrGen1dBarCodeDescr, gen_1d_bar_code_descr_gengen_1d_bar_code_descr_gengen_1d_bar_code_descr_genGen1dBarCodeDescrGenGen1dBarCodeDescrGen

Possible Successors

get_1d_bar_codeget_1d_bar_codeget_1d_bar_codeGet1dBarCodeGet1dBarCode, count_objcount_objcount_objCountObjCountObj, select_objselect_objselect_objSelectObjSelectObj, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain

Alternatives

find_1d_bar_codefind_1d_bar_codefind_1d_bar_codeFind1dBarCodeFind1dBarCode

See also

sobel_dirsobel_dirsobel_dirSobelDirSobelDir

Module

Bar Code