How to Create Barcode Images

Barcode Value

The BarcodeWriter.CreateBarcode() method accepts multiple data types for barcode values. These include byte[] array, MemoryStream, and string. The lengths of the string and what characters are accepted vary depending on the barcode type, but this is all detailed within our documentation.

Barcode Encoding Types

IronBarcode supports a wide variety of barcode formats for writing—the complete list can be found in our Supported Barcode Formats article. These barcode types all have their own unique properties, specialties, and uses—you can research which one is the best fit for your use case with our documentation.

Width and Height

Set the width and height of the output barcode image in pixels. By default, both measurements are set at 250 px. Several barcode types, such as QR and PDF417, require having certain dimensions to be compliant, so for input widths and heights that don't match the required dimensions of the barcode, the barcode will be generated at the compliant dimensions and whitespace will fill the remaining space. If the dimensions are too small for the barcode, an exception will be thrown.

Import Barcodes as Image

When creating a barcode with the BarcodeWriter.CreateBarcode() method, a GeneratedBarcode object will be generated. With this object, we can save the barcode to a variety of image types with several SaveAs() methods specific to each image format. These methods include:

• SaveAsGif(): This method saves the GeneratedBarcode as a GIF image file and accepts the image file path as a string argument.
• SaveAsJpeg(): This method saves the GeneratedBarcode as a JPEG image file and accepts the image file path as a string argument.
• SaveAsPng(): This method saves the GeneratedBarcode as a PNG image file and accepts the image file path as a string argument.
• SaveAsTiff(): This method saves the GeneratedBarcode as a TIFF image file and accepts the image file path as a string argument.
• SaveAsWindowsBitmap(): This method saves the GeneratedBarcode as a BMP image file and accepts the image file path as a string argument.
• SaveAsImage(): This is a general method for saving the GeneratedBarcode as an image file—users must specify the desired file format extension when inputting the file path.

Generate a Barcode and Save As Image File

Now we will use BarcodeWriter.CreateBarcode() to demonstrate the creation of a Code128 barcode, and save it to disk as a JPEG image file.

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs

using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");

Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")

QR Code Values

Similar to the BarcodeWriter.CreateBarcode() method, QRCodeWriter.CreateQrCode() first accepts a value for the QR Code which can be numerical, alphabetical, or alphanumerical. These values can be input inside the method as byte[] array, MemoryStream, and System.String type.

QR Code Size

Users can also specify the size of the QR code directly into the method as Int32 type. The measurement unit for QR code size used in this method is in pixels (px). The default QR code size is 500 px.

QR Error Correction Level

QRErrorCorrectionLevel is a member property of the QRCodeWriter class where it has 4 fields: Highest, High, Medium, and Low. Basically, this property is the fault tolerance level of a QR code, where a higher correction level creates more complex QR codes that are less prone to reading errors, even if it is damaged, or partially obscured. Now, let us discuss in detail each of the fields in this property, as well as look at the difference in the appearance of the QR code produced.

QRErrorCorrectionLevel.Highest

QR codes generated with the Highest correction level will have the most complex QR code image, with 30% of it being error correction. The QR code produced can also be stamped with a logo or image graphics on the QR code.

QRErrorCorrectionLevel.High

Setting the property field to be High will result in the application of 25% error correction in the QR code image. It will be less complex than the QR code image produced from QRErrorCorrectionLevel.Highest.

QRErrorCorrectionLevel.Medium

This field applies only 15% error correction in the QR code image. By using this setting, users will get to produce QR codes faster; however, they are more prone to errors.

QRErrorCorrectionLevel.Low

This is the lowest setting for error correction level, which only applies 7% error correction in the QR code image, resulting in the least complex QR Code.

QR Version

QR Version is the symbol version of a QR code that ranges from 1 to 40. A higher QR version will produce a more complex QR code, enabling users to store more data, and vice versa for the lower version of QR code. Please note, however, if the QR version is set too low, issues might occur when users are trying to encode more data than what is allowed by the version. Setting the QR version as 0 will automatically assign the appropriate QR version based on the value to be encoded. Please refer to this site for more information on QR version: QR Version

Create a QR Code Image

The code snippet below demonstrates how to use the QRCodeWriter.CreateQrCode() method in IronBarcode to write a QR code and save it as an image file to disk by using the SaveAsJpeg() method.

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs

using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");

Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")

From the code snippet above, an alphanumerical value was used as the value to be encoded in the QR code, and we used 250 pixels as the measurement of the produced QR code. We also specified the error correction of the produced QR code to be medium and let the program decide which QR code version is suitable for our QR code value. Apart from that, we also used SaveAsJpeg() that accepts the QR code image file name with the image format extension, which is a JPEG in this case, to be saved as the argument.