Special Parameters of 1D Barcode Types


Aspose.BarCode for Python via .NET enables customizing various parameters that are specific for 1D barcode generation. Particularly for 1D barcode standards, developers can adjust the following display properties: the height of bars, the mode of bar filling, the wide-to-narrow ratio, and the automatic correction of invalid barcode text.
This article describes how to manage these properties using specified classes and properties of the library.

Setting Bar Height

The barcode library allows adjusting the height of bars for 1D single-row barcodes. This can be done only when the auto_size_mode property of class BarcodeParameters is set to AutoSizeMode.NONE. In this case, regardless of the value specified in the x_dimension property, the bar height can be regulated using the setBarHeight property of class BarcodeParameters. This property does not apply to multiple-row barcodes and 2D barcodes.

Bar Height Is Set to 40 Pixels Is Set to 80 Pixels

Bar Filling Modes

For 1D barcodes, Aspose.BarCode for Python via .NET provides a specific mode to generate barcodes with empty bars instead of filled ones. Such a modification can be done using the filled_bars property of class BarcodeParameters. This property is set to True by default and is valid only for 1D barcodes.

Bar Filling Filled Empty

Setting Wide-to-Narrow Ratio

Two-width 1D barcodes are based on the binary code principle, meaning that information is encoded using bars and spaces with two options of width: wide and narrow. Two-width barcode symbologies include the following: Codabar, Code 11, Code 32, Code 39, DataLogic 2-of-5, IATA 2-of-5, Interleaved 2-of-5, ITF 6, ITF 14, Matrix 2-of-5, MSI, OPC, PZN, Standard 2-of-5, and VIN.

The wide-to-narrow ratio defines the relation between the width of wide and narrow elements. It can be set using the wide__narrow_ratio property of class BarcodeParameters. The larger if the value of the wide-to-narrow ratio, the larger is the width of the generated barcode. However, the readability also improves with an increase in this parameter. By default, WideNarrowRatio is set to 3.

Wide-to-Narrow Ratio Is Set to 2 Is Set to 5

Setting Aspect Ratio in Barcodes

Aspect Ratio is one of the main parameters used to manage barcode proportions along X and Y coordinates. Aspect Ratio can be determined as the ratio between barcode height and width or as the relative coefficient to the XDimension value. Its value can be modified using the aspect_ratio property of classes corresponding to various barcode type and providing parameter settings. Each rectangle barcode type has its own recommended range for the aspect ratio.

Handling Exception on Incorrect Barcode Text

In case when a barcode has not been created correctly due to invalid barcode text, by default, the library can generate additional dummy data to bring the barcode into line with the standard or delete conflicting characters. Thereafter barcode generation is considered successful.

Developers can change this behaviour by using the throw_exception_when_code_text_incorrect property of BarcodeParameters. When this property is enabled, an exception is thrown if the barcode text has been found incorrect or incomplete.

Barcode Text Correctness Correct with Valid Barcode Text Adjusted with Invalid Barcode Text