Save Generated Barcodes in C++
This article describes different ways of saving generated barcode images to files, streams, or bitmaps, as well as outputting barcode labels in various raster (BMP, PNG, JPEG, GIF, and TIFF) and vector (EMF and SVG) image formats.
Overview
In the process of barcode development, it may be necessary to save barcodes not only in standard raster image file formats but also to a stream or a vector file. Aspose.BarCode for C++ provides various options of outputting generated barcodes, such as saving in the five most widely used image formats, two vector formats, and other possibilities (loading barcode images to a file, a stream, or a bitmap). These options are described below along with corresponding code snippets that illustrate how to implement them.
Save Barcode to File
Aspose.BarCode for C++ allows saving the generated barcode label directly as a file of the desired format. All barcode generation classes (BarcodeGenerator and BarCodeControl) have a public method called Save. The BarcodeGenerator.Save method takes an instance of class BarCodeImageFormat. The following image formats can be passed to the Save method as an argument:
- BarCodeImageFormat.Bmp - Specifies the bitmap (BMP) image format
- BarCodeImageFormat.Gif - Specifies the Graphics Interchange Format (GIF) image format
- BarCodeImageFormat.Jpeg - Specifies the Joint Photographic Experts Group (JPEG) image format
- BarCodeImageFormat.Png - Specifies the W3C Portable Network Graphics (PNG) image format
- BarCodeImageFormat.Tiff - Specifies the Tagged Image File Format (TIFF) image format
- BarCodeImageFormat.TiffInCmyk - Specifies the Tagged Image File Format (TIFF) image format in CMYK color model
- BarCodeImageFormat.Emf - Specifies the Enhanced Metafile (EMF) image format
- BarCodeImageFormat.Svg - Specifies the Scalable Vector Graphics (SVG) image format
// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir_ManageBarCodesImages();
// Instantiate barcode object
System::SharedPtr<BarcodeGenerator> generator = System::MakeObject<BarcodeGenerator>(EncodeTypes::Code128, u"1234567");
generator->get_Parameters()->get_Barcode()->get_BarHeight()->set_Point(3.0f);
generator->Save(dataDir + u"barcode-size-unit_out.jpeg", BarCodeImageFormat::Jpeg);
System::Console::WriteLine(System::Environment::get_NewLine() + u"Barcode saved at " + dataDir);
Save Barcode to Stream
In some cases, developers may need to save the generated barcode label in the form of a stream (as a binary format). A stream is an abstraction of a byte sequence, such as a file, an inter-process communication pipe, a TCP/IP socket, or an input/output device. The Stream class and its child classes represent a generic view of various input and output types and allow programmers to abstract away from the details of the operating system and particular devices. To enable this option, class BarcodeGenerator calls the public method Save that takes Stream as an input parameter.
// The path to the documents directory.
System::String dataDir = RunExamples::GetDataDir_ManageBarCodesImages();
// Instantiate barcode object and set CodeText & Barcode Symbology
System::SharedPtr<BarcodeGenerator> generator = System::MakeObject<BarcodeGenerator>(EncodeTypes::Code128, u"1234567");
// Create a memory stream object that would store barcode image in binary form
System::SharedPtr<System::IO::MemoryStream> ms = System::MakeObject<System::IO::MemoryStream>();
// Call save method of BarCodeImage to store Png barcode image to memory stream
generator->Save(ms, BarCodeImageFormat::Png);
ms->set_Position(0);
System::SharedPtr<BarCodeReader> reader = System::MakeObject<BarCodeReader>(ms, DecodeType::Code128);
if(reader->Read())
System::Console::WriteLine(u"Barcode from stream recognized as " + reader->GetCodeText());
else
System::Console::WriteLine(u"Barcode from stream failed to recognize");
Save Barcode as Bitmap
Aspose.BarCode for C++ allows outputting a barcode image in the form of a bitmap object and then saving it in the desired format or using it in further graphical transformations. Such objects can be obtained from instances of class BarcodeGenerator by calling the GenerateBarCodeImage method and then get processed as required. The following code snippet illustrates how to implement this option in Aspose.BarCode for C++.
Output Barcodes in Raster Formats
Aspose.BarCode for C++ enables saving barcode images to most of the widely used raster image formats, namely, BMP, PNG, GIF, JPEG, and TIFF. You can pass the BarCodeImageFormat enum as a second argument to the BarcodeGenerator.Save method to save a barcode in the desired format. The descriptions of all supported image formats along with corresponding code samples are provided below.
BMP Format
Files with the .BMP extension correspond to bitmap files that are intended to store bitmap digital images and are independent of a graphics adapter. The BMP file format can store data as two-dimensional digital images in both monochrome and color formats with various color depths. The BMP format implies creating images without compression; accordingly, the generated barcode images will be of a large size, having 24-bit color depth, and without losses and artifacts.
The example of a barcode image generated in the BMP format is demonstrated below.
PNG Format
Portable Network Graphics (PNG) is a raster file format that enables lossless data compression. PNG is the most preferred format to create barcode images. Barcode labels generated in this format will be of 32-bit color depth and without losses.
The resulting barcode label generated in the PNG format is given below.
GIF Format
Graphics Interchange Format (GIF) is a lossless raster image format that contains only 256 colors and supports both static and animated images. In Aspose.BarCode for C++, it can be applied only to black and white raster images.
The barcode image example generated in the GIF format is demonstrated below.
JPEG Format
JPEG is a standard image format to store lossy and compressed image data. Due to compression, the output image is a trade-off between storage size and image quality and usually contains artifacts and graphical noises. This format is the least recommended to save generated barcodes.
The example of a barcode image generated in the JPEG format is represented below.
TIFF (TIFFInCMYK) Format
Tagged Image File Format (TIFF) is a lossless raster format that provides extremely high image quality and supports 32-bit color. It is the only output format that in its variation TIFFInCMYK, enables the CMYK color scheme.
The examples of barcode labels created in TIFF and TIFFInCMYK formats are provided below.
| Output Format | TIFF | TIFFInCMYK |
|---|---|---|
 |
|
Output Barcodes in Vector Formats
Vector data formats allow representing an image as a set of graphical operations that are consequently executed on a user’s graphics unit. Namely, vector images can be created using mathematical formulas that establish points on a grid. Vector images can be scaled without losing resolution; therefore, vector files are more preferable for some tasks compared with raster files. At present, Aspose.BarCode for C++ allows saving barcode labels in two vector formats: EMF and SVG.
EMF Format
Enhanced Metafile (EMF) is a device-independent vector image format most used in Windows operating systems for printing purposes. An EMF image file contains the records of variable length in chronological order so that the stored image can be rendered after parsing on any output device. Such variable-length records can represent definitions of enclosed objects, commands for drawing, and graphics properties that are important to render the image accurately. When a device opens an EMF metafile using its own graphics environment, the dimension, proportions, colors, and other graphic properties of the original image remain unchanged regardless of the opening device platform.
SVG Format
Scalable Vector Graphics (SVG) is an XML-based vector image format used to render two-dimensional images in web applications. In SVG image files, XML-based text is used to describe how the image should appear; therefore, such a file can be scaled to different sizes without losing resolution. Accordingly, this format is often applied to develop websites and print graphics, as they may need to be resized to fit different designs.
The example of a barcode label created in the SVG format is provided below.