Setting Barcode Parameters using C# Library

This article outlines the capabilities provided by Aspose.BarCode for .NET to customize barcode measurement units (inches, millimeters, points, or pixels) and the resolution of generated barcode images.


In Cartesian coordinate systems, image data are represented as the coordinates of pixels or drawable objects for raster or vector images, respectively.
In Aspose.BarCode for .NET, to link the values of such coordinates to real-world measurement units, such as inches or millimeters, BarcodeGenerator class includes class Unit and its specific property called Resolution that is measured in dots per inch (dpi). Class Unit serves to convert barcode size values defined in pixels, millimeters, inches, or points into any of the supported measurement units automatically. In this way, the size of elements in real-world measurement units can be converted into pixels to perform barcode image generation.

Measuring Barcode Size in Different Units

Class Unit is used to set measurement units for various parameters of class BarcodeGenerator, such as BarCodeHeight, BarCodeWidth, XDimension, FontUnit, and some others. In Aspose.BarCode for .NET, this class is implemented as an internal representation of .NET class GraphicsUnit Enum. Class Unit allows converting different measurement units into the desired ones: Inches, Millimeters, Pixels, Point (1/72 inch), or Document (1/300 inch). The default size measurement unit for barcode generation is Millimeters.

Barcode images generated using different unit settings (three pixels and two millimeters) are demonstrated below.

Size Units



The following code snippet illustrates how to implement the settings as in the provided barcode labels.

BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.DataMatrix, "ASPOSE");
//set unit size in 3 pixels
gen.Parameters.Barcode.XDimension.Pixels = 3;
gen.Save($"{path}UnitIn3Pixels.png", BarCodeImageFormat.Png);
//set unit size in 2 millimeters
gen.Parameters.Barcode.XDimension.Millimeters = 2;
gen.Save($"{path}UnitIn2Millimeters.png", BarCodeImageFormat.Png);

Managing Image Resolution

Aspose.BarCode for .NET enables custom settings for barcode image resolution. To implement this, BarcodeGenerator class provides the Resolution property that is used to get or set the resolution of a barcode image and is intended to convert all non-pixel barcode size values into digital coordinates measured in pixels. The Resolution property is defined uniformly for all dimensions of a barcode image and is measured in dpi. Its default value equals 96 dpi.

Barcode labels created with different resolution settings (96 dpi and 300 dpi) are shown below.


Is Set to 96 dpi

Is Set to 300 dpi

The following code example is provided to demonstrate how to customize resolution settings.

BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.DataMatrix, "ASPOSE");
//set unit size in 1 millimeter, resolution 96
gen.Parameters.Barcode.XDimension.Millimeters = 1;
gen.Parameters.Resolution = 96;
gen.Save($"{path}UnitIn1MillimeterResolution96.png", BarCodeImageFormat.Png);
//set unit size in 1 millimeter, resolution 300
gen.Parameters.Barcode.XDimension.Millimeters = 1;
gen.Parameters.Resolution = 300;
gen.Save($"{path}UnitIn1MillimeterResolution300.png", BarCodeImageFormat.Png);