Basic Barcode Recognition Parameters


Class BarCodeReader in Aspose.BarCode for Python via .NET is the most important to implement barcode recognition for more than 60 symbologies. First, it is necessary to identify a barcode source that can be represented as a file, a stream, or a bitmap object. After that, target barcode types need to be specified using values from the DecodeType enum. By default, the library uses the DecodeType.ALL_SUPPORTED_TYPES setting that implies iterating over all supported barcode types to check for their presence in the source image. In this case, barcode scanning and recognition take much more time. Developers can specify explicitly not only the desired types but also a target region or regions in the source image. This allows optimizing the scanning process by avoiding areas without barcodes. Target regions can be determined using a class called Quadrangle.

In the barcode recognition process implemented in Aspose.BarCode for Python via .NET, barcode data decoding is initiated according to the special protocol after scanning the raw data from a graphical representation. Some linear and postal barcode types have passed standardization after their wide implementation, and therefore, it has led to the presence of incompatible decoding formats. To resolve possible conflicts, class BarCodeReader provides a special class called BarcodeSettings used to manage barcode decoding settings.

Basic Recognition Parameters

Barcode reading is performed according to the following steps:

  • Determine the barcode source (image file, stream, or bitmap), e.g. set the path to a source image
  • Select target barcode types. DecodeType is set to DecodeType.ALL_SUPPORTED_TYPES by default meaning that the source image will be scanned to search for all supported barcode types; in this case, the time required to finish the barcode detection process will increase.

Class BarCodeReader contains the read_bar_codes() method that returns the result of barcode reading in an array of the BarCodeResult type.

Get Recognition Results

To load barcode recognition outputs, it is needed to call the read_bar_codes() method that gets an array of the BarCodeResult type. Moreover, the current recognition output can be accessed through the found_bar_codes property that enables fetching decoding results or the found_count property that returns the number of detected barcodes.

Abort Barcode Reading using Manual and Timeout Methods

Class BarCodeReader enables two ways to interrupt the recognition process if it becomes unfeasible to complete. The first one is to initialize the time_out property that defines a timeout value for the barcode reading process . By default, the TimeOut value is set to 0.

The second way is to use the abort() method. This option is used if the recognition process has been launched in the other thread. This method does not stop the entire process and returns controls immediately.