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

FIL.RecognizeBarcode

Extracts information from a barcode located on the input image at a given position.

Namespace:FilNet
Assembly:FIL.NET.dll

Syntax

C++
C#
 
public static void RecognizeBarcode
(
	FilNet.Image inImage,
	FilNet.Rectangle2D inBarcodePosition,
	FilNet.CoordinateSystem2D? inBarcodePositionAlignment,
	FilNet.BarcodeFormat? inBarcodeFormat,
	int inScanCount,
	int inScanWidth,
	float inMinStrength,
	float inSmoothingStdDev,
	FilNet.Polarity inPolarity,
	INullable<string> outDecodedText,
	out FilNet.BarcodeFormat? outBarcodeFormat,
	NullableRef<NullableValue<FilNet.Polarity>> outBarcodePolarity,
	NullableValue<FilNet.Rectangle2D> outAlignedBarcodePosition,
	IList<FilNet.Segment2D> diagScheduledScanSegments
)

Parameters

Name Type Range Default Description
inImageFilNet.ImageInput image.
inBarcodePositionFilNet.Rectangle2DPosition of the input image in which the barcode is located.
inBarcodePositionAlignmentFilNet.CoordinateSystem2D?Adjusts the barcode rectangle to the position of the inspected object. Default value: ftl::NIL.
inBarcodeFormatFilNet.BarcodeFormat?EAN13Format of the barcode. Default value: EAN13.
inScanCountint<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.
outDecodedTextFilNet.INullable<string>Decoded barcode text 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.
outBarcodePolarityFilNet.NullableRef<FilNet.NullableValue<FilNet.Polarity>>Decoded barcode polarity or nothing if all of the scans failed. Can be null to skip this parameter calculation.
outAlignedBarcodePositionFilNet.NullableValue<FilNet.Rectangle2D> Can be null to skip this parameter calculation.
diagScheduledScanSegmentsSystem.Collections.Generic.IList<FilNet.Segment2D>Scheduled scan segments.

Examples

Rotated barcode.

Low quality barcode printed on plastic foil.

Barcode on package wrapped in plastic foil.

Barcode on 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.

Function Overrides

See also