You are here: Start » FIL.NET » Function Reference » Computer Vision » Barcodes » FIL.ReadSingleBarcode

FIL.ReadSingleBarcode

Detects and recognizes a single barcode on the input image.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void ReadSingleBarcode
(
	FilNet.Image inImage,
	FilNet.Rectangle2D? inRoi,
	FilNet.CoordinateSystem2D? inRoiAlignment,
	FilNet.BarcodeFormat? inBarcodeFormat,
	float inMinGradientLength,
	int inBaseBarWidth,
	int inDetectionScanCount,
	int inReadingScanCount,
	int inScanWidth,
	float inMinStrength,
	float inSmoothingStdDev,
	FilNet.Polarity inPolarity,
	out FilNet.Rectangle2D? outBarcodePosition,
	INullable<string> outDecodedText,
	out FilNet.BarcodeFormat? outBarcodeFormat
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inRoiFilNet.Rectangle2D?Region of interest. Default value: ftl::NIL.
inRoiAlignmentFilNet.CoordinateSystem2D?Adjusts the region of interest to the position of the inspected object. Default value: ftl::NIL.
inBarcodeFormatFilNet.BarcodeFormat?EAN13Format of the barcode. Default value: EAN13.
inMinGradientLengthfloat<0.0f, INF>8.0fMinimal gradient length of edge pixels used for detecting barcodes. Default value: 8.0f.
inBaseBarWidthint<1, INF>3Estimated width of the thinnest bar. Default value: 3.
inDetectionScanCountint<1, INF>5Number of scan lines used in detecting barcode. Default value: 5.
inReadingScanCountint<1, INF>5Number of parallel scans run until first successful read. Default value: 5.
inScanWidthint<1, INF>5Width of the single scan. Default value: 5.
inMinStrengthfloat<0.0f, INF>5.0fMinimal strength of an extracted edge. Default value: 5.0f.
inSmoothingStdDevfloat<0.0f, INF>0.25fStandard deviation of the gaussian smoothing applied to the profile extracted in each scan. Default value: 0.25f.
inPolarityFilNet.PolarityDarkSpecifies whether code is darker or brighter than the background. Default value: Dark.
outBarcodePositionFilNet.Rectangle2D?Position of the found barcode.
outDecodedTextFilNet.INullable<string>Decoded barcode content or nothing if all of the scans failed. This parameter cannot be null.
outBarcodeFormatFilNet.BarcodeFormat?Decoded barcode format or nothing if all of the scans failed.

Description

This filter works as a composition of DetectSingleBarcode and RecognizeBarcode filters.

Examples

Rotated barcode.

Low quality barcode printed on plastic foil.

Barcode on package wrapped in plastic foil.

Barcode in a blurry image.

Barcode on standard 330ml can.

Barcode on reflective and wrapped surface.

EAN-13 with add-on 2 used to indicate a book edition.

EAN-13 with add-on 5 to give a suggestion for the price.

Remarks

Minimal bar width requirement

To provide precise detection of the barcode width of the thinnest bar should be at least 1.5 pixels.

Depending on the barcode format guard or start/end code patterns must be readable.

Pharmacode usage

The pharmacode barcode type can be read correctly in both directions. To get results from both directions use a Pharmacode and PharmacodeInversed barcode types.

Before decoding a Pharmacode the code orientation angle is normalized to a range from -45° to 135° what makes the code decoding more stable

Results of reading using a different Pharmacode directions: Pharmacode = 23 and PharmacodeInversed = 16.

Using a relative coordinate systems

Read more about Local Coordinate Systems in Machine Vision Guide: Local Coordinate Systems.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Function Overrides

See also