Accusoft.BarcodeXpress.NetCore 13.5.2308-preview

Overview

Barcode Xpress™ is a powerful and fast SDK which accurately reads common industry 1D and 2D barcodes, detecting them anywhere on the page, in any orientation.

Supported Barcode Types

1D Barcodes

• Add-2
• Add-5
• Airline 2 of 5
• Australia Post 4-State Code
• BCD Matrix
• Codabar
• Code 128 (A,B,C)
• Code 2 of 5
• Code 32
• Code 39
• Code 39 Extended
• Code 93
• Code 93 Extended
• DataLogic 2 of 5
• EAN 128 (GS1, UCC)
• EAN-13
• EAN-8
• GS1 DataBar
• Industrial 2 of 5
• Intelligent Mail (OneCode)
• Interleaved 2 of 5
• Invert 2 of 5
• ITF-14 / SCC-14
• Matrix 2 of 5
• Patch Codes
• PLANET
• PostNet
• Royal Mail (RM4SCC)
• UCC 128
• UPC-A
• UPC-E
• UPU 4-State

2D Barcodes

• QR
• Micro QR
• Aztec
• PDF 417
• Micro PDF 417
• Datamatrix

See more information about our supported barcodes in our official documentation.

Usage

Basic Example

using (System.Drawing.Bitmap bitmap = new System.Drawing.Bitmap("path/to/file.png"))
using (BarcodeXpress barcodeXpress = new BarcodeXpress("."))
{
    var results = barcodeXpress.reader.Analyze(bitmap);

    foreach(var result in results)
    {
        Console.WriteLine(result.BarcodeValue);
    }
}

How to set different barcode types

BarcodeXpress barcodeXpress = new BarcodeXpress(".");
barcodeXpress.reader.BarcodeTypes = new BarcodeType[]{ BarcodeType.QRCodeBarcode, BarcodeType.Code39Barcode};

How to set recognition parameters

// If a barcode has a checksum, the checksum will be appeneded to the end of the barcode value.
barcodeXpress.reader.AppendCheckSum = true;
// Specify the area in which Barcode Xpress search for barcodes
barcodeXpress.reader.Area = new System.Drawing.Rectangle(0, 0, 200, 200);
// For 1D barcodes only, specify many pixels are skipped while scanning
barcodeXpress.reader.ScanDistance = 4;
// Specify the directions in which to search for barcodes
barcodeXpress.reader.Orientation = OrientationInfo.HorizontalVerticalDiagonal;
// Scan the image one more time at a reduced resolution to find hard to read barcodes.
barcodeXpress.reader.AdditionalReadingPass = true;

How to view results

foreach(var result in results)
{
    string formattedResult = "";
    formattedResult += result.BarcodeType + "\n";
    // BarcodeValue is the value encoded by the barcode.
    formattedResult += "Value: " + result.BarcodeValue + "\n";
    // Confidence can be 1 through 100. Any confidence below 30 is considered to be unsolved.
    formattedResult += "Confidence: " + result.Confidence.ToString() + "\n";
    // Barcode Xpress also returns the coordinates of the barcode
    formattedResult += "Point 1: " + result.Point1.X.ToString() + " " + result.Point1.Y.ToString() + "\n";
    formattedResult += "Point 2: " + result.Point2.X.ToString() + " " + result.Point2.Y.ToString() + "\n";
    formattedResult += "Point 3: " + result.Point3.X.ToString() + " " + result.Point3.Y.ToString() + "\n";
    formattedResult += "Point 4: " + result.Point4.X.ToString() + " " + result.Point4.Y.ToString() + "\n";
    // The skew determines how much the barcode is rotated
    formattedResult += "Skew: " + result.Skew.ToString();
    Console.WriteLine(formattedResult);
} 

How to call licensing methods

// If you have a paid license, you must call these methods.
// The values required below can be found by logging into the customer portal.
barcodeXpress.Licensing.SetSolutionName("YourSolutionName");
barcodeXpress.Licensing.SetSolutionKey(0x000001, 0x000001, 0x000002, 0x000003);
// You only need to call SetOEMLicenseKey if you have an OEM license.
barcodeXpress.Licensing.SetOEMLicenseKey("2.0.ReallyLongLicenseStringThatYouCanFindOnTheCustomerPortal");       

Features

• Detect and read 1D and 2D barcodes.
• Recognize barcodes located anywhere on a page in any orientation.
• Report confidence values for detected barcodes.
• Seamless integration with Accusoft's Form Processing Suite with streaming support.
• Set a minimum size that barcodes must meet to be returned by the Analyze method by using the Reader.MinimumBarcodeSize parameter.
• Track the internal states of the QR Code as it is being read at any point in the output stream (e.g., Kanji, Numeric, etc.)
• Grayscale (8bpp) detection on various 1D barcode types.
• Report the row and column information for supported 2D barcodes.
• Report the error correction level for 2D barcodes.
• We provide NuGet Packages to simplify the packaging process. NuGet packages make it easy to add, remove, and update libraries and tools in Visual Studio projects that use the .NET Framework.

Licensing

Barcode Xpress does not require a license for evaluation. Simply download our SDK and try it! Barcode results will be partially hidden until a paid license is purchased. Contact info@accusoft.com for more information.

Requirements

Barcode Xpress for .NET Core is supported on x64 Windows operating systems of the following versions:

• Windows 8.1
• Windows 10 Versions 1607 and above
• Windows Server 2012 (and R2)
• Windows Server 2016
• Windows Server 2019

Barcode Xpress for .NET Core is supported on x64 Linux operating systems of the following versions:

• Ubuntu 16.04
• Ubuntu 18.04
• Ubuntu 20.04
• CentOS 7
• CentOS 8
• Debian 9
• Debian 10

Development Environments

• .NET Core 2.1
• .NET Core 3.1

Package Requirements on Linux

• libgdiplus (See notes below)

Additionally, one of the two following packages is required on most Linux systems. (Whichever is available for your distribution)

• libc6-dev (Debian based distributions: Ubuntu, Linux Mint)
• glibc-devel (RPM based distributions such as CentOS, Fedora, and RHEL)

Note: Although it may run, Barcode Xpress for .NET Core is not supported on earlier operating system versions (for example, Ubuntu 14.04 or Windows 7).

libgdiplus notes

Libgdiplus is a runtime dependency for using the System.Drawing.Common classes in .NET Core. Microsoft recommends using version 6.0.1, but this version is not yet available in most distribution package repositories. Instructions for installing it in most common environments can be found at the Mono project site: https://www.mono-project.com/download/stable/#download-lin

The .NET Core runtime will be able to load most images even with earlier versions of libgdiplus, but some such as BMP version 4 or greater will load with imcomplete or incorrect contents.

Useful Links

Documentation: https://help.accusoft.com/BarcodeXpress/latest/BxNetCore/webframe.html

Support: https://www.accusoft.com/support/support-plans/

Get Barcode Xpress: https://www.accusoft.com/products/barcode-xpress/get-it/

Contacts

Accusoft Corporation 4001 North Riverside Drive Tampa, FL 33603 Sales: 813-875-7575 www.accusoft.com

©2021 Accusoft Corporation. All rights reserved.