Browse our Products

Aspose.BarCode for Java 25.7 Release Notes

All Changes

KeySummaryCategory
BARCODENET-39312Improve Code128 recognition performanceEnhancement
BARCODENET-39313GS1 DataMatrix: “Incorrect value 129 for C40 Shift” errorBug

Public API changes and backwards compatibility

Method BarcodeGenerator.setCodeText(String codeText, Charset encoding) encodes the Unicode codeText into a byte sequence using the specified encoding. UTF-8 is the most commonly used encoding. Method setCodeText(String codeText, Charset encoding, boolean insertBOM) If the encoding supports it and insertBOM is set to true, the method includes a byte order mark (BOM)

This method is intended for use with 2D barcodes only (e.g., Aztec, QR, DataMatrix, PDF417, MaxiCode, DotCode, HanXin, RectMicroQR, etc.). It enables manual encoding of Unicode text using national or special encodings; however, this method is considered obsolete in modern applications. For modern use cases, ECI encoding is recommended for Unicode data.

Using this method with 1D barcodes, GS1-compliant barcodes (including 2D), or HIBC barcodes (including 2D) is not supported by the corresponding barcode standards and may lead to unpredictable results.

//Encode DataMatrix text using Shift-JIS (Japanese encoding)
BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.DATA_MATRIX);
if (Charset.isSupported("Shift_JIS"))
{
    Charset charset=Charset.forName("Shift_JIS");
    gen.setCodeText("車種名",charset);
    gen.save("barcode1.png",BarCodeImageFormat.PNG);
    BarCodeReader reader=new BarCodeReader("barcode1.png",DecodeType.DATA_MATRIX);
    BarCodeResult[]barCodeResults=reader.readBarCodes();
    for(BarCodeResult result:barCodeResults)
    {
     System.out.println("BarCode CodeText: "+result.getCodeText(charset));
    }
}

//Encode codetext using UTF-8 with BOM
BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.QR);
gen.setCodeText("車種名", StandardCharsets.UTF_8, true);
gen.save("barcode2.png", BarCodeImageFormat.PNG);
BarCodeReader reader = new BarCodeReader("barcode2.png", DecodeType.QR);
BarCodeResult[] barCodeResults = reader.readBarCodes();
for (BarCodeResult result : barCodeResults)
{
  System.out.println("BarCode CodeText: " + result.getCodeText(StandardCharsets.UTF_8));
}

Code 128 recognition performance

Code 128 recognition performance is improved.

BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.CODE_128,"ASPOSE");
gen.save("barcode3.png", BarCodeImageFormat.PNG);
BarCodeReader reader = new BarCodeReader("barcode3.png", DecodeType.CODE_128);
reader.setQualitySettings(QualitySettings.getHighPerformance());
BarCodeResult[] barCodeResults = reader.readBarCodes();
for (BarCodeResult result : barCodeResults)
{
  System.out.println("BarCode CodeText: " + result.getCodeText());
}

GS1 DataMatrix generation

GS1 DataMatrix generation corresponds to GS1 DataMatrix Guideline.

BarcodeGenerator gen = new BarcodeGenerator(EncodeTypes.GS_1_DATA_MATRIX,"(00)057139091004349375(241)24140053(91)SkamoDoor Board 225 P2(243)035402");
gen.save("barcode4.png", BarCodeImageFormat.PNG);
BarCodeReader reader = new BarCodeReader("barcode4.png", DecodeType.GS_1_DATA_MATRIX);
reader.setQualitySettings(QualitySettings.getHighPerformance());
BarCodeResult[] barCodeResults = reader.readBarCodes();
for (BarCodeResult result : barCodeResults)
{
System.out.println("BarCode CodeText: " + result.getCodeText());
}