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

FIL.DetectSingleBarcode

Determines the position of a single barcode on the input image.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void DetectSingleBarcode
(
	FilNet.Image inImage,
	FilNet.BarcodeFormat? inFormat,
	float inMinGradientLength,
	int inBaseBarWidth,
	int inScanCount,
	int inScanWidth,
	float inMinStrength,
	float inSmoothingStdDev,
	FilNet.Polarity inPolarity,
	out FilNet.Rectangle2D? outBarcodePosition,
	NullableRef<NullableValue<FilNet.Polarity>> outBarcodePolarity,
	NullableRef<List<FilNet.Rectangle2D>> outBarcodeCandidates
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inFormatFilNet.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.
inScanCountint<1, INF>5Number of scan lines used in detecting barcode. 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.
outBarcodePolarityFilNet.NullableRef<FilNet.NullableValue<FilNet.Polarity>>Polarity of the found barcode. Can be null to skip this parameter calculation.
outBarcodeCandidatesFilNet.NullableRef<System.Collections.Generic.List<FilNet.Rectangle2D>>Places with high gradient values that are further investigated. Can be null to skip this parameter calculation.

Examples

Filter finds barcodes rotated by any angle.

Low quality barcode printed on plastic foil.

Barcode on package wrapped in plastic foil.

Barcode on blurry image.

Barcode on reflective and wrapped surface.

Barcode on standard 330ml can.

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