Documentation – Getting Started

Cpp: Product Overview

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.BarCode for C++ is a robust and reliable barcode generation and recognition component written in C++ that allows developers to quickly and easily add barcode generation and recognition functionality to C++ applications.

This article presents Aspose.BarCode for C++ and its main features, including some important technical details. You can get information about its functionality, input and output image formats, important classes, and supported platforms.

Product Description

Aspose.BarCode for C++ has many characteristics that make it a flexible and easy-to-use tool. It is a fully functional library that provides both generation and reading functionality. Generated barcodes can be saved in five high-quality raster image formats and two vector ones. The other advantage is that the library facilitates decoding even low-quality or damaged barcode images. Therefore, it enables high recognition efficiency for most of the supported symbologies. There are no printing limitations for barcodes generated through the Aspose.BarCode library. Developers can utilize any type of printers. The quality of printed barcode images will depend only on the resolution of a printer.

Aspose.BarCode for C++ provides fully featured demos and working examples written in C++ to provide developers with a better understanding of our product. Using these demos, developers can quickly test functionality provided by Aspose.BarCode.

Main Features

Aspose.BarCode for C++ benefits from a great variety of features that can serve to address various business needs. One of the most important functions is the customization of barcode appearance-related properties, including barcode size, color of barcode elements, rotation angle, image quality, X-dimension, resolution, text captions, and many others. Moreover, rich barcode reading and imaging functionality is available.

The most important features are the following:

Barcode generation and recognition for over 60 barcode types
Reading barcodes at any angle and from images of any quality
Customization of barcode appearance (size, height, resolution, color, rotation angle, text label and captions, X-dimension, wide-to-narrow-ratio, and others)
Optimization of recognition engine variables to achieve the desired trade-off between reading accuracy and speed
Target scanning region selection
Barcode generation using special modes, such as ECI, error correction, or embedded metadata
Image rotation at any angle
Saving to or loading from stream or file
Encoding and decoding non-English characters in 2D types

Licensing

License is required to get access to the advanced functionality of Aspose.BarCode for C++. The evaluation mode allows generating barcodes without any restrictions. However, watermarks are displayed on generated barcode images. Barcode recognition functionality is provided without limitations only for Code 39 barcodes. For all other barcode types, 30% of the decoded text will be masked. More information about how to buy and set the license is provided in Licensing. If you want to evaluate the full functionality of Aspose.BarCode for C++, you can obtain a temporary license that is valid for 30 days. Please refer to How to get a Temporary License for details.

Main Classes

Aspose.BarCode for C++ contains two main classes: BarCodeReader for barcode scanning and reading, BarcodeGenerator for barcode generation according to the specified format requirements. Namespace ComplexBarcode is provided to manage special barcodes, i.e. Swiss QR Code.

Cpp: Supported Barcode Types

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.BarCode for C++ supports more than 60 barcode types used in various industries, i.e., linear (1D), matrix (2D), and postal barcodes.

Linear barcode types, or 1D barcodes, relate to the first generation of one-dimensional (1D) barcode types that decode data by changing the widths of black and white parallel lines. Particular 1D standards support encoding only numbers, while others allow encoding also letters and special symbols.

Matrix barcode types, also referred as 2D barcode types, have been developed as an advanced way to encode data. Two-dimensional (2D) types imply creating barcodes composed of various figures and shapes. These barcode standards are deemed to have better efficiency compared with 1D barcodes owing to their improved data density and data recovery mechanisms.

Postal types are special barcode standards introduced by postal services in various countries.

		Supported Barcode Types
1D (Linear)	Numeric Only	Code 11, Code 32, Codabar, DataBar Omnidirectional, DataBar Stacked Omnidirectional, DataBar Limited, DataBar Truncated, DataBar Stacked, EAN-13, EAN-14, EAN-8, IATA 2-of-5, Italian Post 25, Interleaved 2-of-5, ISBN, ISMN, ISSN, ITF-6, ITF-14, Matrix 2-of-5, MSI, OPC, PatchCode, Pharmacode, PZN, SSCC-14, SSCC-18, Standard 2-of-5, EAN-5, EAN-2, UPC-A, UPC-E, UpcaGs1DatabarCoupon
Alpha-Numeric	Code 128, Code 39, Code 93, Code 16K, Codablock-F, DataBar Expanded, DataBar Expanded Stacked, GS1 Codablock-F, GS1 Code 128, VIN, HIBC LIC Code 128
2D	QR Code, Micro QR Code, PDF417, Compact PDF417, Macro PDF417, Micro PDF417, Aztec Code, Data Matrix, DotCode, GS1 Data Matrix, GS1 QR Code, MaxiCode, Swiss QR Code,Han Xin Code, HIBC LIC QR Code
Postal	Australia Post, Australian Post Parcel, Deutsche Post Identcode, Deutsche Post LetiCode, Planet, Postnet, RM4SCC, SingaporePost, Swiss Post Parcel, USPS OneCode,

Cpp: Supported Image Formats

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.BarCode for C++ enables outputting barcode images using five most common raster image file formats and two vector image formats. The latter ones are available for rendering only by the SQL Server Reporting Services engine. Image formats supported for input and output are listed below.

Format	Description	Recognition	Generation
JPEG	File format standardized by the Joint Photographic Experts Group
TIFF	Tagged Image File Format
PNG	Portable Network Graphics Image
BMP	Bitmap Image File
GIF	Graphical Interchange Format Image
EXIF	Exchangeable Image File Format
EMF	Enhanced Metafile Format
SVG	Scalable Vector Graphics Format

Cpp: Features

Mon, 01 Jan 0001 00:00:00 +0000

General Features

Barcode image generation
Barcode image scanning, detection, and decoding
Support for more than 60 symbologies, including 1D, 2D, and postal barcode types
Customization of barcode appearance-related properties
Image rotation
Encoding and decoding non-English characters in 2D types
Optimization of recognition engine variables
Data loading and saving to a stream or a file
Label printing
Support for complex barcodes (i.e. Swiss QR Code and Royal Mail Mailmark)
JSP, Servlet support

Barcode Recognition

Barcode scanning at any angle
Support for common image raster and vector formats, including JPEG, TIFF, PNG, BMP, and GIF
Support for image resolution from 75 to 600 dpi
Support for the detection of damaged, blurred or noised images
Possibility to determine target barcode detection regions in a source image
Possibility to define target barcode types for recognition
Optimization of recognition engine variables to achieve the desired trade-off between reading speed and quality through manual settings or embedded presets
Detection of all barcodes displayed in the scanned region
Checksum validation for 1D and postal barcodes
Increasing barcode detection speed through multithread barcode recognition

Barcode Generation

Barcode generation with customized settings
Customization of barcode image appearance (size, resolution, height, background color, bar color, rotation angle, X-dimension, image quality, captions, wide-to-narrow-ratio, and others)
Saving generated barcode images in various raster and vector image formats: JPEG, TIFF, PNG, BMP, GIF, EMF, and SVG
Customization of encoding types and parameters
Support for checksum controls (for 1D barcodes) and supplement data
Customization of the wide-to-narrow ratio for some symbologies to improve recognition accuracy
Support for Error Checking and Correcting (ECC) or Extended Channel Interpretation (ECI) modes

Barcode Imaging

Customization barcode image borders, border color, style, margins, and width
Customization fo barcode image color, caption color, text color, background color, and bar color
Customization of bar height
Customization of barcode caption appearance
Barcode rotation to any degree
Customization of quality and resolution settings for generated barcode images
Anti-aliasing for barcode images
Size unit selection
Auto-sizing of barcode labels
Rendering images on any device

Cpp: System Requirements

Mon, 01 Jan 0001 00:00:00 +0000

Supported Operating Systems

Microsoft Windows 2000 Professional and Server (SP2 recommended)
Microsoft Windows XP Professional or Home Edition
Microsoft Windows 2003/2008/2012 Server
Microsoft Windows Vista
Microsoft Windows 7 & 8

Development Environments

Aspose.BarCode for C++ can be run in any development environment supporting C++. Specifically, the following environment can be used:

Microsoft Visual Studio 2017 or later

Cpp: Licensing

Mon, 01 Jan 0001 00:00:00 +0000

Overview

The evaluation mode of Aspose.BarCode for C++ allows generating barcode images without restrictions. However, a watermark will be displayed on the resulting barcode image (words “Aspose”). The unlicensed version can be used to read barcodes of all supported types. Please note that only Code 39 can be decoded without limitations; as a result of reading barcodes corresponding to other types, 30% of decoded text will be masked with " * “. All other actions with barcodes using Aspose.BarCode for C++ need setting a license. After purchasing a license, you will get access to the whole functionality of the library and the ability to perform barcode generation and reading without limitations and watermark placement.

Evaluation Version Limitations

An evaluation version of Aspose.Barcode for C++ can be downloaded from the downloads section of Aspose’s web site at https://releases.aspose.com/barcode/cpp. Or you can use NuGet package in your application. Only Code39 barcodes could be created or recognized in this mode without limitations. For other types of barcodes evaluation watermark will be added on generated barcodes and part of the recognized text will be returned.

Licensing

You could request a Temporary License to test full Aspose.BarCode for C++ functionality. Check the pricing information and purchase a full license at https://purchase.aspose.com/pricing/barcode/cpp.

Apply License using File or Stream Object

The license can be loaded from a file or stream object. Aspose.Barcode for C++ will try to find the license in the following locations:

Explicit path
Current working directory

The easiest way to set a license is to put the license file in the folder you start your application from and specify the file name, without a path, as shown in the example below.

Load License from File

When you call the SetLicense method, the license name that you pass should be that of the license file. For example, if you change the license file name to “Aspose.Barcode.lic.xml”, pass that file name to the License::SetLicense(…) method.

auto license = System::MakeObject<License>();

license->SetLicense(u"Aspose.BarCode.CPP.lic");

Load License from a Stream Object

The following example shows how to load a license from a stream.

auto license = System::MakeObject<License>();

auto licenseStream = System::MakeObject<System::IO::FileStream>(u"Aspose.BarCode.CPP.lic", System::IO::FileMode::Open);    
    
license->SetLicense(licenseStream);

Cpp: Installation

Mon, 01 Jan 0001 00:00:00 +0000

Install Aspose.BarCode for C++ through NuGet

NuGet is the easiest way to download and install Aspose .NET APIs. Open Microsoft Visual Studio. Select TOOLS menu, goto NuGet Package Manager and select Manage NuGet packages for solution. Search ‘aspose.barcode’ keyword. This will find the desired Aspose API. Click on “Install” button, the selected API will be downloaded and referenced in your project.

Install or Update Aspose.BarCode using the Package Manager Console

You can follow the steps below to install or upgrade the Aspose.BarCode API using the package manager console: Open your solution/project in Visual Studio. Select TOOLS -> NuGet Package Manager -> Package Manager Console from the top menu. This will open package manager console.

Type the command “Install-Package Aspose.BarCode -Version x.x.0” and press enter to install the latest full release into your application. Alternatively, you can add the “-prerelease” suffix to the command in order to specify that the latest release including hot fixes is to be installed as well.

If you are not familiar with the Aspose EULA http://www.aspose.com/corporate/purchase/end-user-license-agreement.aspx then it is a good idea to read the license referenced in the URL. You should now find that Aspose.BarCode has successfully been added and referenced in your application for you.

In the package manager console, you can use the command Update-Package Aspose.BarCode.CPPand press enter to check for any updates to the Aspose.BarCode package and install them if present. You can also add the “-prerelease” suffix to update the latest release.

Uninstall Aspose.BarCode for C++

If you have used MSI installer to deploy Aspose.BarCode, follow these steps to completely remove the component and the associated demos and documentation:

From the Start menu, select Settings and then Control Panel
Click Add/Remove Programs
Select Aspose.BarCode
Click Change/Remove to remove Aspose.BarCode

Cpp: Technical Support

Mon, 01 Jan 0001 00:00:00 +0000

Free Technical Support

Free technical support for Aspose.BarCode for C++ can be received through Free Support Forum that can not only assist with technical issues but also give advice to solve any business-related difficulty. In addition, you can refer to this forum if you want to give your feedback or raise a request to implement new product features. More than 190,000 registered users have been assisted using this communication channel.

Blog

Aspose.BarCode Product Family Blog regularly publishes news about new features, technical articles, tutorials, and useful tips. In this blog, you can find information about recent releases and announcements from Aspose team.

Free Consulting

If you are willing to resolve a business need with the help of Aspose products and look for more information about it, you can request a consultation through Free Consulting service. An Aspose developer will process your request upon availabilty, and you will be contacted to receive useful explanations about Aspose APIs to implement your business tasks.

Paid Technical Support

If you require to find a solution for your problem as soon as possible, you can refer to Paid Support Helpdesk service. Requests and questions sent through Paid Support are considered to be of the highest priority and are processed by Aspose developers at the shortest notice.

Paid Consulting

If you think that your business problem can be solved by introducing some new features or you are willing to receive a professional consultation to implement some specific tasks, you can refer to Paid Consulting service at any moment. Aspose team will resolve development tasks while you can focus on achieving your business goals.