get_1d_bar_code ( BarCodeRegion : : BarCodeDescr, GenericName, GenericValue, Orientation : BarCodeElements )

Extract the widths of the elements inside a bar code region.

get_1d_bar_code extracts the widths of the elements of a bar code inside the specified region.

The control of the processing is identical to find_1d_bar_code. The description of the parameters GenericName and GenericValue can be found at this operator.


Parameters

BarCodeRegion (input_object)
image -> object : byte / uint2
Region of bar code.

BarCodeDescr (input_control)
barcode_1d-array -> string / integer / real
Description of a bar code class.

GenericName (input_control)
string(-array) -> string
Names of optional parameters.
Default value: '[]'
List of values: 'sigma_project', 'amplitude_project', 'width_project', 'add_length_project', 'interpolation_project', 'num_scanlines', 'max_extra_elements'

GenericValue (input_control)
number(-array) -> real / integer
Values of optional parameters.
Default value: '[]'

Orientation (input_control)
angle.rad -> real
Orientation of bar code.

BarCodeElements (output_control)
number-array -> real
Widths of elements.


Example (Syntax: 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 get_1d_bar_code returns the value 2 (H_MSG_TRUE) if the parameters are correct.


Parallelization Information

get_1d_bar_code is reentrant and processed without parallelization.


Possible Predecessors

find_1d_bar_code_region, select_obj, reduce_domain


Possible Successors

decode_1d_bar_code


Alternatives

find_1d_bar_code


Module

Bar Code



Copyright © 1996-2008 MVTec Software GmbH