get_1d_bar_code_scanlineT_get_1d_bar_code_scanlineget_1d_bar_code_scanlineGet1dBarCodeScanlineGet1dBarCodeScanline (Operator)

Name

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

Warning

get_1d_bar_code_scanlineget_1d_bar_code_scanlineget_1d_bar_code_scanlineGet1dBarCodeScanlineGet1dBarCodeScanline 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.

Signature

Description

Like get_1d_bar_codeget_1d_bar_codeget_1d_bar_codeGet1dBarCodeGet1dBarCode, get_1d_bar_code_scanlineget_1d_bar_code_scanlineget_1d_bar_code_scanlineGet1dBarCodeScanlineGet1dBarCodeScanline extracts the widths of the elements of a bar code inside the specified region, but get_1d_bar_code_scanlineget_1d_bar_code_scanlineget_1d_bar_code_scanlineGet1dBarCodeScanlineGet1dBarCodeScanline also returns information about the used scanlines.

For a description of the parameters see get_1d_bar_codeget_1d_bar_codeget_1d_bar_codeGet1dBarCodeGet1dBarCode and find_1d_bar_code_scanlinefind_1d_bar_code_scanlinefind_1d_bar_code_scanlineFind1dBarCodeScanlineFind1dBarCodeScanline.

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;
HTuple   ScanlineNumPoints, ScanlineDecoded, ScanlinePointsRow,
         ScanlinePointsColumn;
HTuple   NumScanlines, NumPoints;
HTuple   j, k, indexPoint, nStart, nEnd;
HTuple   WindowHandle;

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_scanlines(GrayRegion,BarCodeDescr,empty,empty,
                            Orientations[i],"false",&Elements,
                            &ScanlineNumPoints,&ScanlineDecoded,
                            &ScanlinePointsRow,&ScanlinePointsColumn);
  decode_1d_bar_code(Elements,BarCodeDescr,
                     &Characters,&Reference,&IsCorrect);
  // display scanlines
  NumScanlines = ScanlineNum.Num();
  indexPoint = HTuple(0);
  for (j=0; j<=NumScanlines-1; j+=1)
  {
    if (HTuple(ScanlineDecoded[(long)(j)[0]])==1)
    {
      set_color(WindowHandle,HTuple("green"));
    }
    else
    {
      set_color(WindowHandle,HTuple("red"));
    }
    NumPoints = HTuple(ScanlineNumPoints[(long)(j)[0]]);
    nStart = indexPoint;
    nEnd = (indexPoint+NumPoints)-1;
    for (k=nStart; k<=nEnd; k+=1)
    {
      disp_circle(WindowHandle,HTuple(ScanlinePointsRow[(long)(k)[0]]),
      HTuple(ScanlinePointsColumn[(long)(k)[0]]),HTuple(1));
    }
    indexPoint = nEnd+1;
  }
}

Result

The operator get_1d_bar_codeget_1d_bar_codeget_1d_bar_codeGet1dBarCodeGet1dBarCode returns the value 2 (H_MSG_TRUE) if the parameters are correct.

Possible Predecessors

find_1d_bar_code_regionfind_1d_bar_code_regionfind_1d_bar_code_regionFind1dBarCodeRegionFind1dBarCodeRegion, select_objselect_objselect_objSelectObjSelectObj, reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain

Possible Successors

decode_1d_bar_codedecode_1d_bar_codedecode_1d_bar_codeDecode1dBarCodeDecode1dBarCode

Alternatives

find_1d_bar_codefind_1d_bar_codefind_1d_bar_codeFind1dBarCodeFind1dBarCode

Module

Bar Code