You are here: Start » FIL.NET » Function Reference » Computer Vision » Barcodes » FIL.ReadSingleBarcode
Detects and recognizes a single barcode on the input image.
Namespace: | FilNet |
---|---|
Assembly: | FIL.NET.dll |
Syntax
public static void ReadSingleBarcode ( FilNet.Image inImage, NullableRef<FilNet.ShapeRegion> inRoi, FilNet.CoordinateSystem2D? inRoiAlignment, FilNet.BarcodeParams inBarcodeParams, FilNet.BarcodeDetectionParams inDetectionParams, INullable<FilNet.Barcode> outBarcode )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inImage | FilNet.Image | Input image. | ||
![]() | inRoi | FilNet.NullableRef<FilNet.ShapeRegion> | Region of interest. Default value: ftl::NIL. | ||
![]() | inRoiAlignment | FilNet.CoordinateSystem2D? | Adjusts the region of interest to the position of the inspected object. Default value: ftl::NIL. | ||
![]() | inBarcodeParams | FilNet.BarcodeParams | Specification of barcode that can be detected. | ||
![]() | inDetectionParams | FilNet.BarcodeDetectionParams | Parameters of the barcode detection algorithm. | ||
![]() | outBarcode | FilNet.INullable<FilNet.Barcode> | A barcode that has been correctly detected and decoded. This parameter cannot be null. |
Description
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
- ReadSingleBarcode(Image, BarcodeParams, BarcodeDetectionParams, INullable<Barcode>)
- ReadSingleBarcode(Image, NullableRef<ShapeRegion>, Nullable<CoordinateSystem2D>, BarcodeParams, BarcodeDetectionParams, INullable<Barcode>, NullableRef<List<Rectangle2D>>, NullableRef<ShapeRegion>)
- ReadSingleBarcode(Image, NullableRef<ShapeRegion>, Nullable<CoordinateSystem2D>, BarcodeParams, BarcodeDetectionParams, INullable<Barcode>, IList<Rectangle2D>, ShapeRegion, Image, IList<List<Segment2D>>)
- ReadSingleBarcode(Image, NullableRef<ShapeRegion>, Nullable<CoordinateSystem2D>, BarcodeParams, BarcodeDetectionParams, INullable<Barcode>, NullableRef<List<Rectangle2D>>, NullableRef<ShapeRegion>, Image, IList<List<Segment2D>>)