Customize Barcode Appearance

This documentation explains how to customize the appearance of barcodes using the Aspose.BarCode Cloud SDK for Java. It provides details on the available methods, customization options, and examples of usage.

Methods

  • generate: Generates a barcode via GET request.
  • generateBody: Generates a barcode via POST request with JSON or XML body.
  • generateMultipart: Generates a barcode via POST request with multipart form data.

Customization Options

When generating a barcode, you can customize various aspects of its appearance using the properties of the request classes.

Key Properties:

  • barcodeType: Specifies the type of barcode to generate (e.g. QR, Aztec, Pdf417, Code39, etc).
  • data: The data to encode in the barcode.
  • imageFormat: Specifies the output format of the barcode image (e.g., Png, Jpeg, Svg).
  • foregroundColor: Color of the barcode bars, supports standard color names or ARGB values (e.g., AliceBlue or #FF000000).
  • backgroundColor: Background color of the barcode image.
  • textLocation: Position of the code text relative to the barcode (Below, Above, None).
  • units: Measurement units for image dimensions (Pixel, Inch, Millimeter).
  • resolution: Resolution of the image in dpi.
  • imageHeight and imageWidth: Dimensions of the barcode image.
  • rotationAngle: Rotation angle of the barcode (e.g., 0, 90, 180).

Barcode Type-Specific Parameters

In addition to the common appearance settings above, the API exposes advanced parameters that apply only to specific barcode types. They are ignored when a different barcode type is generated.

QR, MicroQR and RectMicroQR

  • qrEncodeMode: QR barcode encode mode (Auto, Extended, Binary, ECI).
  • qrErrorLevel: QR error correction level (LevelL, LevelM, LevelQ, LevelH).
  • qrVersion: QR barcode version (Auto, Version01–Version40). Auto selects the smallest version that fits the data.
  • qrECIEncoding: ECI encoding for the QR barcode data (e.g., UTF8, ISO_8859_1).
  • qrAspectRatio: QR barcode aspect ratio, from 0 to 1.
  • microQRVersion: MicroQR version (Auto, M1–M4). Used when the barcode type is MicroQR.
  • rectMicroQrVersion: RectMicroQR version (Auto, R7x43–R17x139). Used when the barcode type is RectMicroQR.

Code128

  • code128EncodeMode: Controls which Code 128 subset is used (Auto, CodeA, CodeB, CodeAB, CodeC, CodeAC, CodeBC).

PDF417, MacroPDF417 and MicroPDF417

  • pdf417EncodeMode: PDF417 encode mode (Auto, Binary, ECI, Extended).
  • pdf417ErrorLevel: PDF417 error correction level (Level0–Level8).
  • pdf417ECIEncoding: ECI encoding for the PDF417 barcode data.
  • pdf417Truncate: Whether to use the truncated PDF417 format (removes the right-side stop pattern).
  • pdf417Columns: Number of columns (1–30, or 0 for auto).
  • pdf417Rows: Number of rows (3–90, or 0 for automatic).
  • pdf417AspectRatio: Height/width ratio of the barcode module (2–5 for MicroPDF417; 3–5 for PDF417 and MacroPDF417).
  • pdf417MacroCharacters: Macro character to prepend for structured append (None, Macro05, Macro06).
  • pdf417IsReaderInitialization: Whether the barcode is used for reader initialization (programming).
  • pdf417IsLinked: Whether to use linked mode (for MicroPDF417).
  • pdf417IsCode128Emulation: Whether to use Code128 emulation (for MicroPDF417).

Examples

Example 1: Generating a Barcode with GET Request

import com.aspose.barcode.cloud.ApiClient;
import com.aspose.barcode.cloud.api.GenerateApi;
import com.aspose.barcode.cloud.model.BarcodeImageFormat;
import com.aspose.barcode.cloud.model.BarcodeImageParams;
import com.aspose.barcode.cloud.model.CodeLocation;
import com.aspose.barcode.cloud.model.EncodeBarcodeType;
import com.aspose.barcode.cloud.model.QREncodeMode;
import com.aspose.barcode.cloud.model.QRErrorLevel;
import com.aspose.barcode.cloud.model.QRVersion;
import com.aspose.barcode.cloud.model.QrParams;
import com.aspose.barcode.cloud.requests.GenerateRequestWrapper;

import java.io.File;

public class GenerateGet {
    public static void main(String[] args) {
        String accessToken = System.getenv("TEST_CONFIGURATION_ACCESS_TOKEN");
        ApiClient client;

        if (accessToken != null && !accessToken.isEmpty()) {
            client = new ApiClient(accessToken);
        } else {
            client =
                    new ApiClient(
                            "Client Id from https://dashboard.aspose.cloud/applications",
                            "Client Secret from https://dashboard.aspose.cloud/applications");
        }

        GenerateApi generateApi = new GenerateApi(client);

        try {
            GenerateRequestWrapper request =
                    new GenerateRequestWrapper(EncodeBarcodeType.QR, "Aspose.BarCode.Cloud");

            BarcodeImageParams imageParams = new BarcodeImageParams();
            imageParams.setImageFormat(BarcodeImageFormat.PNG);
            imageParams.setForegroundColor("Black");
            imageParams.setBackgroundColor("White");
            imageParams.setTextLocation(CodeLocation.BELOW);
            imageParams.setImageHeight(200f);
            imageParams.setImageWidth(200f);
            imageParams.setResolution(300f);
            request.barcodeImageParams = imageParams;

            QrParams qrParams = new QrParams();
            qrParams.setQrEncodeMode(QREncodeMode.AUTO);
            qrParams.setQrErrorLevel(QRErrorLevel.LEVEL_M);
            qrParams.setQrVersion(QRVersion.AUTO);
            qrParams.setQrAspectRatio(1.0f);
            request.qrParams = qrParams;

            File barcodeImage = generateApi.generate(request);

            System.out.println("Barcode image saved to file " + barcodeImage.getAbsolutePath());

        } catch (Exception e) {
            System.err.println("Error");
            e.printStackTrace();
            System.exit(1);
        }
    }
}

Result Image is: Result image

Example 2: Generating a Barcode with POST Request (JSON Body)

import com.aspose.barcode.cloud.*;
import com.aspose.barcode.cloud.api.GenerateApi;
import com.aspose.barcode.cloud.model.BarcodeImageFormat;
import com.aspose.barcode.cloud.model.BarcodeImageParams;
import com.aspose.barcode.cloud.model.EncodeBarcodeType;
import com.aspose.barcode.cloud.model.EncodeData;
import com.aspose.barcode.cloud.model.EncodeDataType;
import com.aspose.barcode.cloud.model.GenerateParams;
import com.aspose.barcode.cloud.model.QREncodeMode;
import com.aspose.barcode.cloud.model.QRErrorLevel;
import com.aspose.barcode.cloud.model.QRVersion;
import com.aspose.barcode.cloud.model.QrParams;
import com.aspose.barcode.cloud.requests.GenerateBodyRequestWrapper;

import java.io.File;

public class GenerateBody {
    public static void main(String[] args) {

        String accessToken = System.getenv("TEST_CONFIGURATION_ACCESS_TOKEN");
        ApiClient client;

        if (accessToken != null && !accessToken.isEmpty()) {
            client = new ApiClient(accessToken);
        } else {
            client =
                    new ApiClient(
                            "Client Id from https://dashboard.aspose.cloud/applications",
                            "Client Secret from https://dashboard.aspose.cloud/applications");
        }

        GenerateApi generateApi = new GenerateApi(client);

        try {
            EncodeData encodeData = new EncodeData("Aspose");
            encodeData.setDataType(EncodeDataType.STRING_DATA);

            BarcodeImageParams imageParams = new BarcodeImageParams();
            imageParams.setForegroundColor("#FF0000");
            imageParams.setBackgroundColor("#FFFF00");
            imageParams.setImageFormat(BarcodeImageFormat.JPEG);
            imageParams.setRotationAngle(90);

            QrParams qrParams = new QrParams();
            qrParams.setQrEncodeMode(QREncodeMode.AUTO);
            qrParams.setQrErrorLevel(QRErrorLevel.LEVEL_M);
            qrParams.setQrVersion(QRVersion.AUTO);
            qrParams.setQrAspectRatio(0.75f);

            GenerateParams generateParams = new GenerateParams(EncodeBarcodeType.QR, encodeData);
            generateParams.setBarcodeImageParams(imageParams);
            generateParams.setQrParams(qrParams);

            GenerateBodyRequestWrapper request = new GenerateBodyRequestWrapper(generateParams);
            File barcodeImage = generateApi.generateBody(request);

            System.out.println("Barcode image saved to file " + barcodeImage.getAbsolutePath());

        } catch (Exception e) {
            System.err.println("Error");
            e.printStackTrace();
            System.exit(1);
        }
    }
}

Result Image is: Result image

Example 3: Generating a Barcode with POST Request (Multipart Form)

import com.aspose.barcode.cloud.ApiClient;
import com.aspose.barcode.cloud.api.GenerateApi;
import com.aspose.barcode.cloud.model.BarcodeImageFormat;
import com.aspose.barcode.cloud.model.BarcodeImageParams;
import com.aspose.barcode.cloud.model.CodeLocation;
import com.aspose.barcode.cloud.model.EncodeBarcodeType;
import com.aspose.barcode.cloud.model.Pdf417EncodeMode;
import com.aspose.barcode.cloud.model.Pdf417ErrorLevel;
import com.aspose.barcode.cloud.model.Pdf417Params;
import com.aspose.barcode.cloud.requests.GenerateMultipartRequestWrapper;

import java.io.File;

public class GenerateMultipart {
    public static void main(String[] args) {
        String accessToken = System.getenv("TEST_CONFIGURATION_ACCESS_TOKEN");
        ApiClient client;

        if (accessToken != null && !accessToken.isEmpty()) {
            client = new ApiClient(accessToken);
        } else {
            client =
                    new ApiClient(
                            "Client Id from https://dashboard.aspose.cloud/applications",
                            "Client Secret from https://dashboard.aspose.cloud/applications");
        }

        GenerateApi generateApi = new GenerateApi(client);

        try {
            GenerateMultipartRequestWrapper request =
                    new GenerateMultipartRequestWrapper(
                            EncodeBarcodeType.PDF417, "Aspose.BarCode.Cloud");
            BarcodeImageParams imageParams = new BarcodeImageParams();
            imageParams.setTextLocation(CodeLocation.ABOVE);
            imageParams.setImageFormat(BarcodeImageFormat.SVG);
            request.barcodeImageParams = imageParams;

            Pdf417Params pdf417Params = new Pdf417Params();
            pdf417Params.setPdf417EncodeMode(Pdf417EncodeMode.AUTO);
            pdf417Params.setPdf417ErrorLevel(Pdf417ErrorLevel.LEVEL2);
            pdf417Params.setPdf417AspectRatio(2.0f);
            request.pdf417Params = pdf417Params;

            File barcodeImage = generateApi.generateMultipart(request);

            System.out.println("Barcode image saved to file " + barcodeImage.getAbsolutePath());

        } catch (Exception e) {
            System.err.println("Error");
            e.printStackTrace();
            System.exit(1);
        }
    }
}

Result Image is: Result image

Set Barcode Colorscheme Save Generated Barcodes