aspose.barcode 26.2.0 → 26.4.0

package/examples/BarcodeGeneratorExamples.js

@@ -0,0 +1,231 @@
+const ea = require("./ExamplesAssist")
+const aspose_barcode = ea.aspose_barcode
+let BarcodeGenerator = aspose_barcode.BarcodeGenerator;
+let EncodeTypes = aspose_barcode.EncodeTypes;
+
+class BarcodeGeneratorExamples
+{
+    subfolder = "resources/generating/";
+
+    howToGenerateBarcodeImage()
+    {
+        console.log("\n---\nfunction '" + this.howToGenerateBarcodeImage.name + "'\n");
+        let encode_type = EncodeTypes.CODE_128;
+        let generator = new BarcodeGenerator(encode_type, null);
+        generator.setCodeText("123ABC");
+        generator.save(this.subfolder + "howToGenerateBarcodeImage.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("image saved to " + this.subfolder + "howToGenerateBarcodeImage.png");
+    }
+
+    howToSave()
+    {
+        console.log("\n---\nfunction '" + this.howToSave.name + "'\n");
+        let type_expected = EncodeTypes.AZTEC;
+        let code_text_expected = "123678943";
+        let generator = new BarcodeGenerator(type_expected, code_text_expected);
+        generator.save(this.subfolder + "howToSave.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("image saved to " + this.subfolder + "howToSave.png");
+    }
+
+    howToGenerateBase64Image()
+    {
+        let gen = new BarcodeGenerator(EncodeTypes.MACRO_PDF_417, "1234567");
+        let base64EncodedImage = gen.generateBarCodeImage(aspose_barcode.BarCodeImageFormat.PNG);
+        ea.saveImageBase64(base64EncodedImage, this.subfolder + "howToGenerateBase64Image.png")
+        console.log("image saved to " + this.subfolder + "howToGenerateBase64Image.png");
+    }
+
+    howToSetBarcodeType()
+    {
+        console.log("\n---\nfunction '" + this.howToSetBarcodeType.name + "'\n");
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_128, "12367891011");
+        let type_expected = EncodeTypes.CODABAR;
+        generator.setBarcodeType(type_expected);
+        generator.save(this.subfolder + "howToSetBarcodeType.png", aspose_barcode.BarCodeImageFormat.PNG);
+        let type_actual = generator.getBarcodeType();
+        console.log("type_expected = " + type_expected + "\n");
+        console.log("type_actual = " + type_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToSetBarcodeType.png");
+    }
+
+    howToGetCodeText()
+    {
+        console.log("\n---\nfunction '" + this.howToGetCodeText.name + "'\n");
+        let expected = "1234567890DCBV";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_128, expected);
+        generator.save(this.subfolder + "howToGetCodeText.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("CodeText = " + generator.getCodeText());
+        console.log("image saved to " + this.subfolder + "howToGetCodeText.png");
+
+    }
+
+    howToGenerateOneD()
+    {
+        console.log("\n---\nfunction '" + this.howToGenerateOneD.name + "'\n");
+        let codeText = '01234567';
+        let encodeType = EncodeTypes.CODE_39;
+        let generator = new BarcodeGenerator(encodeType, codeText);
+        generator.save(this.subfolder + "howToGenerateOneD.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("image saved to " + this.subfolder + "howToGenerateOneD.png");
+    }
+
+    howToGenerateTwoD()
+    {
+        console.log("\n---\nfunction '" + this.howToGenerateTwoD.name + "'\n");
+        let codeText = '01234567';
+        let encodeType = EncodeTypes.QR;
+        let generator = new BarcodeGenerator(encodeType, codeText);
+        generator.save(this.subfolder + "howToGenerateTwoD.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("image saved to " + this.subfolder + "howToGenerateTwoD.png");
+    }
+
+    howToSetBackColor()
+    {
+        console.log("\n---\nfunction '" + this.howToSetBackColor.name + "'\n");
+        let color_expected = "#FF0000";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        generator.getParameters().setBackColor(color_expected);
+        let color_actual = generator.getParameters().getBackColor();
+        generator.save(this.subfolder + "howToSetBackColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("color_expected = " + color_expected + "\n");
+        console.log("color_actual = " + color_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToSetBackColor.png");
+    }
+
+    howToGetDefaultBackColor()
+    {
+        console.log("\n---\nfunction '" + this.howToGetDefaultBackColor.name + "'\n");
+        let color_expected = "#FFFFFF";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        let color_actual = generator.getParameters().getBackColor();
+        generator.save(this.subfolder + "howToGetDefaultBackColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("color_expected = " + color_expected + "\n");
+        console.log("color_actual = " + color_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToGetDefaultBackColor.png");
+    }
+
+    howToGetDefaultBarColor()
+    {
+        console.log("\n---\nfunction '" + this.howToGetDefaultBarColor.name + "'\n");
+        let color_expected = "#000000";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        let color_actual = generator.getParameters().getBarcode().getBarColor();
+        generator.save(this.subfolder + "howToGetDefaultBarColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("color_expected = " + color_expected + "\n");
+        console.log("color_actual = " + color_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToGetDefaultBarColor.png");
+    }
+
+    howToSetBarColor()
+    {
+        console.log("\n---\nfunction '" + this.howToSetBarColor.name + "'\n");
+        let color_expected = "#FA00AA";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        generator.getParameters().getBarcode().setBarColor(color_expected);
+        let color_actual = generator.getParameters().getBarcode().getBarColor();
+        generator.save(this.subfolder + "howToSetBarColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("color_expected = " + color_expected + "\n");
+        console.log("color_actual = " + color_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToSetBarColor.png");
+    }
+
+    howToSetCodeText()
+    {
+        console.log("\n---\nfunction '" + this.howToSetCodeText.name + "'\n");
+        let encode_type = EncodeTypes.CODE_128;
+        let generator = new BarcodeGenerator(encode_type, null);
+        let expected = "555777";
+        generator.setCodeText(expected);
+        let actual = generator.getCodeText();
+        generator.save(this.subfolder + "howToSetCodeText.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("CodeText actual = " + actual + "\n");
+        console.log("CodeText expected = " + expected + "\n");
+        console.log("image saved to " + this.subfolder + "howToSetCodeText.png");
+    }
+
+
+    howToGetBarcodeTypeAndCodeText()
+    {
+        console.log("\n---\nfunction '" + this.howToGetBarcodeTypeAndCodeText.name + "'\n");
+        let encode_type_expected = EncodeTypes.AZTEC;
+        let code_text_expected = "444555777665";
+        let generator = new BarcodeGenerator(encode_type_expected, code_text_expected);
+        let encode_type_actual = generator.getBarcodeType();
+        let code_text_actual = generator.getCodeText();
+        generator.save(this.subfolder + "howToGetBarcodeTypeAndCodeText.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("code text actual = " + code_text_actual + "\n");
+        console.log("code text expected = " + code_text_expected + "\n");
+        console.log("encode type actual = " + encode_type_actual + "\n");
+        console.log("encode type expected = " + encode_type_expected + "\n");
+        console.log("image saved to " + this.subfolder + "howToGetBarcodeTypeAndCodeText.png");
+    }
+
+    howToGetDefaultDashStyle()
+    {
+        console.log("\n---\nfunction '" + this.howToGetDefaultDashStyle.name + "'\n");
+        let dash_style_expected = BorderDashStyle.SOLID;
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        let dash_style_actual = generator.getParameters().getBorder().getDashStyle();
+        generator.save(this.subfolder + "howToGetDefaultDashStyle.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("dash_style_actual = " + dash_style_actual + "\n");
+        console.log("dash_style_expected" + dash_style_expected + "\n");
+        console.log("image saved to " + this.subfolder + "howToGetDefaultDashStyle.png");
+    }
+
+    howToDefaultBorderColor()
+    {
+        console.log("\n---\nfunction '" + this.howToDefaultBorderColor.name + "'\n");
+        let border_color_expected = "#000000";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        let border_color_actual = generator.getParameters().getBorder().getColor();
+        generator.save(this.subfolder + "howToDefaultBorderColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("border_color_expected = " + border_color_expected + "\n");
+        console.log("border_color_actual = " + border_color_actual + "\n");
+        console.log("image saved to " + this.subfolder + "howToDefaultBorderColor.png");
+    }
+
+    howToSetBorderColor()
+    {
+        console.log("\n---\nfunction '" + this.howToSetBorderColor.name + "'\n");
+        let border_color_expected = "#AA00BB";
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_39, '01234567');
+        generator.getParameters().getBorder().setColor(border_color_expected);
+        let border_color_actual = generator.getParameters().getBorder().getColor();
+        generator.save(this.subfolder + "howToSetBorderColor.png", aspose_barcode.BarCodeImageFormat.PNG);
+        console.log("border_color_expected = " + border_color_expected + "\n");
+        console.log("border_color_actual = " + border_color_actual + "\n");
+    }
+
+    howToSetFont()
+    {
+        console.log("\n---\nfunction '" + this.howToSetFont.name + "'\n");
+        let generator = new BarcodeGenerator(EncodeTypes.CODE_128, null);
+        generator.getParameters().getCaptionAbove().setText("CAPTION ABOOVE");
+        generator.getParameters().getCaptionAbove().setVisible(true);
+        generator.getParameters().getCaptionAbove().getFont().setStyle(FontStyle.ITALIC);
+        generator.getParameters().getCaptionAbove().getFont().getSize().setPoint(5);
+        let save_path = this.subfolder + "howToSetFont.bmp";
+        generator.save(save_path, aspose_barcode.BarCodeImageFormat.BMP);
+        console.log("image saved to " + save_path);
+    }
+}
+
+ea.setLicense();
+let barcodeGeneratorExamples = new BarcodeGeneratorExamples();
+barcodeGeneratorExamples.howToGenerateBarcodeImage();
+barcodeGeneratorExamples.howToGenerateBase64Image();
+barcodeGeneratorExamples.howToGetCodeText();
+barcodeGeneratorExamples.howToGenerateOneD();
+barcodeGeneratorExamples.howToGenerateTwoD();
+barcodeGeneratorExamples.howToSetBackColor();
+barcodeGeneratorExamples.howToGetDefaultBackColor();
+barcodeGeneratorExamples.howToGetDefaultBarColor();
+barcodeGeneratorExamples.howToSetBarColor();
+barcodeGeneratorExamples.howToSetCodeText();
+barcodeGeneratorExamples.howToGetBarcodeTypeAndCodeText();
+barcodeGeneratorExamples.howToGetDefaultDashStyle();
+barcodeGeneratorExamples.howToDefaultBorderColor();
+barcodeGeneratorExamples.howToSetBorderColor();
+barcodeGeneratorExamples.howToSave();
+barcodeGeneratorExamples.howToSetBarcodeType();
+barcodeGeneratorExamples.howToSetFont();

package/examples/BarcodeReaderExamples.js

@@ -0,0 +1,198 @@
+const ea = require("./ExamplesAssist")
+const aspose_barcode = ea.aspose_barcode
+let BarCodeReader = aspose_barcode.BarCodeReader;
+let BarcodeGenerator = aspose_barcode.BarcodeGenerator;
+let EncodeTypes = aspose_barcode.EncodeTypes;
+let QualitySettings = aspose_barcode.QualitySettings;
+
+class BarCodeReaderExamples
+{
+    subfolder = "resources/recognition/";
+
+    howToReadFromFile()
+    {
+        console.log("\n---\nfunction '" + this.howToReadFromFile.name + "'\n");
+        let file_name = "code11.png";
+        let full_path = this.subfolder + file_name;
+        let reader = new BarCodeReader(full_path, null, null);
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            console.log(result.getCodeText());
+
+            console.log(result.getCodeTypeName());
+        });
+
+    }
+
+    howToReadImageBytes()
+    {
+        let fileName = "code11.png";
+        let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, null);
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            console.log(result.getCodeText());
+
+            console.log(result.getCodeTypeName());
+        });
+    }
+
+    howToSetQualitySettings()
+    {
+        console.log("\n---\nfunction '" + this.howToSetQualitySettings.name + "'\n");
+        let file_name = "code11.png";
+        let full_path = this.subfolder + file_name;
+        let reader = new BarCodeReader(full_path, null, null);
+        reader.setQualitySettings(QualitySettings.getHighPerformance());
+
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            console.log(result.getCodeText());
+
+            console.log(result.getCodeTypeName());
+        });
+
+    }
+
+
+    howToGetCodeBytes()
+    {
+        console.log("\n---\nfunction '" + this.howToGetCodeBytes.name + "'\n");
+        let expectedCodeBytes = ["105", "99", "70", "1", "61", "0", "0", "2", "70", "10", "82", "20", "40", "0", "97", "106"];
+        let fileName = "example2.jpg";
+        let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, null);
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            let actualCodeBytes = result.getCodeBytes();
+            console.log("expected code bytes  : " + expectedCodeBytes.length);
+
+            console.log("actual code bytes  : " + actualCodeBytes.length);
+        });
+    }
+
+    howToRecognitionCode128()
+    {
+        console.log("\n---\nfunction '" + this.howToRecognitionCode128.name + "'\n");
+        try
+        {
+            let fileName = "code128.jpg";
+            let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, DecodeType.CODE_128);
+            reader.readBarCodes().forEach(function (result, i, results)
+            {
+                console.log("Code Text : " + result.getCodeTypeName());
+
+                console.log("Code Type : " + result.getCodeText());
+            });
+
+        } catch (e)
+        {
+            console.log(e.getMessage());
+        }
+    }
+
+    howToRecognitionCode11()
+    {
+        console.log("\n---\nfunction '" + this.howToRecognitionCode11.name + "'\n");
+        try
+        {
+            let fileName = "code11.png";
+            let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, DecodeType.CODE_11);
+            reader.readBarCodes().forEach(function (result, i, results)
+            {
+                console.log("Code Text : " + result.getCodeTypeName());
+
+                console.log("Code Type : " + result.getCodeText());
+            });
+
+        } catch (e)
+        {
+            console.log(e.getMessage());
+        }
+    }
+
+    howToRecognitionCodeAllSupportedTypes()
+    {
+        console.log("\n---\nfunction '" + this.howToRecognitionCodeAllSupportedTypes.name + "'\n");
+        try
+        {
+            let fileName = "example2.jpg";
+            let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, DecodeType.ALL_SUPPORTED_TYPES);
+            reader.readBarCodes().forEach(function (result, i, results)
+            {
+                console.log("Code Text : " + result.getCodeTypeName());
+
+                console.log("Code Type : " + result.getCodeText());
+            });
+
+        } catch (e)
+        {
+            console.log(e.getMessage());
+        }
+    }
+
+    howToRecognitionCodeAllSupportedTypes2()
+    {
+        console.log("\n---\nfunction '" + this.howToRecognitionCodeAllSupportedTypes2.name + "'\n");
+        try
+        {
+            let fileName = "example1.png";
+            let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, DecodeType.ALL_SUPPORTED_TYPES);
+            reader.readBarCodes().forEach(function (result, i, results)
+            {
+                console.log("Code Text : " + result.getCodeTypeName());
+                console.log("Code Type : " + result.getCodeText());
+            });
+
+        } catch (e)
+        {
+            console.log(e.getMessage());
+        }
+    }
+
+    howToRecognitionSetBarCodeImage()
+    {
+        console.log("\n---\nfunction '" + this.howToRecognitionSetBarCodeImage.name + "'\n");
+        let fileName = "code128.jpg";
+        let reader = new BarCodeReader(ea.loadImageByName(this.subfolder, fileName), null, DecodeType.ALL_SUPPORTED_TYPES);
+        reader.setBarCodeImage(this.subfolder + "code11.png", null);
+
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            console.log("Code Text : " + result.getCodeTypeName());
+
+            console.log("Code Type : " + result.getCodeText());
+        });
+
+    }
+
+    howToMacroPdf417()
+    {
+        console.log("\n---\nfunction '" + this.howToMacroPdf417.name + "'\n");
+        let barcodeGenerator = new BarcodeGenerator(EncodeTypes.MACRO_PDF_417, null);
+        barcodeGenerator.setCodeText("codeSomecode");
+        barcodeGenerator.getParameters().getBarcode().getPdf417().setPdf417MacroFileID(15900);
+        barcodeGenerator.getParameters().getBarcode().getPdf417().setPdf417MacroSegmentID(2);
+        barcodeGenerator.getParameters().getBarcode().getPdf417().setPdf417MacroSegmentsCount(3);
+        let image = barcodeGenerator.generateBarCodeImage(aspose_barcode.BarCodeImageFormat.PNG);
+        let reader = new BarCodeReader((image), null, DecodeType.MACRO_PDF_417);
+        reader.readBarCodes().forEach(function (result, i, results)
+        {
+            console.log("CodeText : " + result.getCodeText());
+            console.log("getMacroPdf417FileID : " + result.getExtended().getPdf417().getMacroPdf417FileID() + "\n");
+            console.log("getMacroPdf417SegmentID : " + result.getExtended().getPdf417().getMacroPdf417SegmentID() + "\n");
+            console.log('getMacroPdf417SegmentsCount : ' + result.getExtended().getPdf417().getMacroPdf417SegmentsCount() + "\n");
+        });
+    }
+}
+
+ea.setLicense();
+let barCodeReaderExamples = new BarCodeReaderExamples();
+barCodeReaderExamples.howToReadFromFile();
+barCodeReaderExamples.howToReadImageBytes();
+barCodeReaderExamples.howToSetQualitySettings();
+barCodeReaderExamples.howToGetCodeBytes();
+barCodeReaderExamples.howToRecognitionCode128();
+barCodeReaderExamples.howToRecognitionCode11();
+barCodeReaderExamples.howToRecognitionCodeAllSupportedTypes();
+barCodeReaderExamples.howToRecognitionCodeAllSupportedTypes2();
+barCodeReaderExamples.howToRecognitionSetBarCodeImage();
+barCodeReaderExamples.howToMacroPdf417();

package/examples/ExamplesAssist.js

@@ -0,0 +1,75 @@
+let libs_root = "../"
+const index_path = libs_root + "index.js";
+const barcode_ = require(index_path)
+const aspose_barcode = barcode_.AsposeBarcode
+//in case you obtained the lib from npmjs.com by calling the command "npm i aspose.barcode"
+// replace all above lines by two lines
+// const barcode_ = require("aspose.barcode");
+// const aspose_barcode = barcode_.AsposeBarcode
+
+const path_to_license_file = "./lic/Aspose.BarCode.NodeJsviaJava.lic";
+const fs = require("fs");
+
+
+function setLicense()
+{
+    let license = new aspose_barcode.License();
+    if (fs.existsSync(path_to_license_file))
+    {
+        license.setLicense(path_to_license_file);
+    }
+    else
+    {
+        console.log("Path \"" + path_to_license_file + "\" doesn't exist\n");
+    }
+    let is_licensed = license.isLicensed();
+    console.log('is licensed: '  +  is_licensed);
+}
+
+function isExists(file_path)
+{
+    if (fs.existsSync(file_path))
+    {
+        console.log(file_path + " exists")
+    }
+    else
+    {
+        console.log(file_path + " doesn't exist")
+    }
+}
+
+/**
+ * @param subFolder path to image
+ * @param fileName name of image
+ * @returns base64 encoded image
+ */
+function loadImageByName(subFolder, fileName)
+{
+    let filePath = subFolder + "/" + fileName;
+    try
+    {
+        return fs.readFileSync(filePath).toString('base64');
+    } catch (ex)
+    {
+        console.error(ex.toString());
+    }
+}
+
+function saveImageBase64(image64, path)
+{
+    try
+    {
+        console.log("Will be saved to : " + path);
+        let image_bytes = Buffer.from(image64, 'base64');
+        fs.writeFileSync(path, image_bytes);
+        return fs.existsSync(path);
+    } catch (ex)
+    {
+        let barcode_exception = new barcodetestexception_.BarcodeTestException(ex);
+        throw barcode_exception;
+    }
+}
+
+module.exports = {
+    aspose_barcode, setLicense, isExists, loadImageByName, saveImageBase64
+};

package/examples/GenerateAndReadExample.js

@@ -0,0 +1,25 @@
+const fs = require("fs");
+const ea = require("./ExamplesAssist")
+const aspose_barcode = ea.aspose_barcode
+let BarcodeGenerator = aspose_barcode.BarcodeGenerator;
+let EncodeTypes = aspose_barcode.EncodeTypes;
+let BarCodeReader = aspose_barcode.BarCodeReader;
+
+function generateAndRead()
+{
+    ea.setLicense();
+    let generator = new BarcodeGenerator(EncodeTypes.CODE_128, "12367891011");
+    let file_path = "resources/generating/setBarcodeType.png";
+    generator.save(file_path, aspose_barcode.BarCodeImageFormat.PNG);
+
+    let image_data_base64 = fs.readFileSync(file_path).toString('base64');
+    let reader = new BarCodeReader(image_data_base64, null, DecodeType.ALL_SUPPORTED_TYPES);
+
+    reader.readBarCodes().forEach(function(result, i, results)
+    {
+       console.log("Recognized barcode code text: " + result.getCodeText() + "\n");
+        console.log("Recognized barcode code type: " + result.getCodeTypeName() + "\n");
+    });
+}
+
+generateAndRead();

package/examples/how_to.txt

@@ -0,0 +1,15 @@
+1. If you're launching the tests outside of 'node_modules' folder, replace lines in 'ExamplesAssist.js'
+Instead of first four lines should be added
+const barcode_ = require("aspose.barcode");
+const aspose_barcode = barcode_.AsposeBarcode
+2. Run command 'npm install'
+3. Put the license file 'Aspose.BarCode.NodeJsviaJava.lic' to the folder lic.
+The expected name of the license file is Aspose.BarCode.NodeJsviaJava.lic.
+You can change it by changing line 10 of ExampleAssist.js.
+4. Open and run every file consistently :
+how_to_generate_and_read_example.js
+how_to_generate_barcode_examples.js
+how_to_read_barcode_examples.js
+You can run them from the command line,
+for example 'node how_to_generate_and_read_example.js.cmd'
+

package/examples/how_to_generate_and_read_example.js.cmd

@@ -0,0 +1,2 @@
+node GenerateAndReadExample.js
+pause 10

package/examples/how_to_generate_barcode_examples.js.cmd

@@ -0,0 +1,2 @@
+node BarcodeGeneratorExamples.js
+pause 10

package/examples/how_to_read_barcode_examples.js.cmd

@@ -0,0 +1,2 @@
+node BarcodeReaderExamples.js
+pause 10

package/examples/lic/.stub

@@ -0,0 +1 @@
+Place license to this folder

package/examples/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "barcode.nodejs.examples",
+  "description": "Aspose.Barcode for Node.js via Java examples",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "java": "^0.12.1"
+  }
+}

package/examples/resources/generating/.stub

@@ -0,0 +1 @@
+Folder for generated files

package/lib/AsposeBarcode.js

@@ -4,7 +4,7 @@ const joint_ = require('./Joint');
 const complexbarcode_ = require("./ComplexBarcode");
 const generation_ = require("./Generation");
 const recognition_ = require("./Recognition");
-const jar_name_ = "/aspose-barcode-nodejs-26.2.jar";
+const jar_name_ = "/aspose-barcode-nodejs-26.4.jar";
 const jar_path_ = __dirname + jar_name_;
 const fs = require("fs");
 

package/lib/ComplexBarcode.js

@@ -6,8 +6,6 @@ const joint = require('./Joint');
 const java = require('java');
 const aspose_barcode = require("./AsposeBarcode");
 const {BaseJavaClass} = require("./Joint");
-const {Base} = require("mocha/lib/reporters");
-
 
 /**
  * Interface for complex codetext used with ComplexBarcodeGenerator.
@@ -3340,7 +3338,11 @@ class SecondaryAndAdditionalData extends joint.BaseJavaClass
      */
     getExpiryDate()
     {
-        return new Date(this.getJavaClass().getExpiryDateSync() * 1000);
+        const value = this.getJavaClass().getExpiryDateSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
     /**
      * <p>
@@ -3349,7 +3351,12 @@ class SecondaryAndAdditionalData extends joint.BaseJavaClass
      */
     setExpiryDate(value)
     {
-        this.getJavaClass().setExpiryDateSync((value.getTime() / 1000).toString());
+        if (!value) {
+            this.getJavaClass().setExpiryDateSync(null);
+            return;
+        }
+
+        this.getJavaClass().setExpiryDateSync(value.toISOString());
     }
 
     /**
@@ -3405,7 +3412,11 @@ class SecondaryAndAdditionalData extends joint.BaseJavaClass
      */
     getDateOfManufacture()
     {
-        return new Date(this.getJavaClass().getDateOfManufactureSync() * 1000);
+        const value = this.getJavaClass().getDateOfManufactureSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
 
     /**
@@ -3417,7 +3428,13 @@ class SecondaryAndAdditionalData extends joint.BaseJavaClass
      */
     setDateOfManufacture(value)
     {
-        this.getJavaClass().setDateOfManufactureSync((value.getTime() / 1000).toString());
+        if (!value)
+        {
+            this.getJavaClass().setDateOfManufactureSync(null);
+            return;
+        }
+
+        this.getJavaClass().setDateOfManufactureSync(value.toISOString());
     }
 
     /**

package/lib/Generation.js

@@ -3699,7 +3699,11 @@ class Pdf417Parameters extends joint.BaseJavaClass
      */
     getMacroPdf417TimeStamp()
     {
-        return new Date(this.getJavaClass().getMacroPdf417TimeStampSync() * 1000);
+        const value = this.getJavaClass().getMacroPdf417TimeStampSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
 
     /**
@@ -3710,7 +3714,12 @@ class Pdf417Parameters extends joint.BaseJavaClass
      */
     setMacroPdf417TimeStamp(value)
     {
-        this.getJavaClass().setMacroPdf417TimeStampSync((value.getTime() / 1000).toString());
+        if (!value)
+        {
+            this.getJavaClass().setMacroPdf417TimeStampSync(null);
+            return;
+        }
+        this.getJavaClass().setMacroPdf417TimeStampSync(value.toISOString());
     }
 
     /**
@@ -3719,7 +3728,11 @@ class Pdf417Parameters extends joint.BaseJavaClass
      */
     getPdf417MacroTimeStamp()
     {
-        return new Date(this.getJavaClass().getPdf417MacroTimeStampSync() * 1000);
+        const value = this.getJavaClass().getPdf417MacroTimeStampSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
 
     /**
@@ -3728,7 +3741,12 @@ class Pdf417Parameters extends joint.BaseJavaClass
      */
     setPdf417MacroTimeStamp(value)
     {
-        this.getJavaClass().setPdf417MacroTimeStampSync((value.getTime() / 1000).toString());
+        if (!value)
+        {
+            this.getJavaClass().setPdf417MacroTimeStampSync(null);
+            return;
+        }
+        this.getJavaClass().setPdf417MacroTimeStampSync(value.toISOString());
     }
 
     /**
@@ -7146,45 +7164,86 @@ ITF14BorderType =
 QREncodeMode =
     {
         /**
-         * Encode codetext as is non-unicode charset. <br>
-         * If there is any unicode character, <br>
-         * the codetext will be encoded with value which is set in CodeTextEncoding.
+         * In Auto mode, the CodeText is encoded with maximum data compactness.
+         * Unicode characters are encoded in kanji mode if possible, or they are re-encoded in the ECIEncoding specified encoding with the insertion of an ECI identifier.
+         * If a character is found that is not supported by the selected ECI encoding, an exception is thrown.
          */
         AUTO: 0,
+
         /**
-         * Encode codetext as plain bytes. If it detects any unicode character, the character will be encoded as two bytes, lower byte first.
+         * Encode codetext as plain bytes. If it detects any Unicode character, the character will be encoded as two bytes, lower byte first.
+         * @deprecated This property is obsolete and will be removed in future releases. Instead, use the 'SetCodeText' method to convert the message to byte array with specified encoding.
          */
         BYTES: 1,
-        //https://en.wikipedia.org/wiki/Byte_order_mark
+
         /**
          * Encode codetext with UTF8 encoding with first ByteOfMark character.
+         * @deprecated This property is obsolete and will be removed in future releases. Instead, use the 'SetCodeText' method with UTF8 encoding to add a byte order mark (BOM) and encode the message. After that, the CodeText can be encoded using the 'Auto' mode.
          */
         UTF_8_BOM: 2,
+
+
         /**
-         * Encode codetext with UTF8 encoding with first ByteOfMark character. It can be problems with some barcode scaners.
+         * Encode codetext with UTF8 encoding with first ByteOfMark character. It can be problems with some barcode scanners.
+         * @deprecated This property is obsolete and will be removed in future releases. Instead, use the 'SetCodeText' method with BigEndianUnicode encoding to add a byte order mark (BOM) and encode the message. After that, the CodeText can be encoded using the 'Auto' mode.
          */
         UTF_16_BEBOM: 3,
 
         /**
-         * Encode codetext with value set in the ECI_ENCODING property. It can be problems with some old (pre 2006) barcode scaners.
+         * Encode codetext with value set in the ECIEncoding property. It can be problems with some old (pre 2006) barcode scanners.
+         * This mode is not supported by MicroQR barcodes.
+         * @deprecated This property is obsolete and will be removed in future releases. Instead, use ECI option.
          */
         ECI_ENCODING: 4,
 
         /**
-         * Extended Channel mode which supports FNC1 first position, FNC1 second position and multi ECI modes.<br>
-         * It is better to use QrExtCodetextBuilder for extended codetext generation.<br>
-         * Use Display2DText property to set visible text to removing managing characters.<br>
-         * Encoding Principles:<br>
-         * All symbols "\" must be doubled "\\" in the codetext.<br>
-         * FNC1 in first position is set in codetext as as "&lt;FNC1&gt;"<br>
-         * FNC1 in second position is set in codetext as as "&lt;FNC1(value)&gt;". The value must be single symbols (a-z, A-Z) or digits from 0 to 99.<br>
-         * Group Separator for FNC1 modes is set as 0x1D character '\\u001D' <br>
-         *  If you need to insert "&lt;FNC1&gt;" string into barcode write it as "&lt;\FNC1&gt;" <br>
-         * ECI identifiers are set as single slash and six digits identifier "\000026" - UTF8 ECI identifier<br>
-         * TO disable current ECI mode and convert to default JIS8 mode zero mode ECI indetifier is set. "\000000"<br>
-         * All unicode characters after ECI identifier are automatically encoded into correct character codeset.<br>
-         */
-        EXTENDED_CODETEXT: 5
+         * Extended Channel mode which supports FNC1 first position, FNC1 second position and multi ECI modes.</para>
+         * It is better to use QrExtCodetextBuilder for extended codetext generation.</para>
+         * Use Display2DText property to set visible text to removing managing characters.</para>
+         * Encoding Principles:</para>
+         * All symbols "\" must be doubled "\\" in the codetext.</para>
+         * FNC1 in first position is set in codetext as as "&lt;FNC1&gt;"</para>
+         * FNC1 in second position is set in codetext as as "&lt;FNC1(value)&gt;". The value must be single symbols (a-z, A-Z) or digits from 0 to 99.</para>
+         * Group Separator for FNC1 modes is set as 0x1D character '\\u001D' </para>
+         * If you need to insert "&lt;FNC1&gt;" string into barcode write it as "&lt;\FNC1&gt;" </para>
+         * ECI identifiers are set as single slash and six digits identifier "\000026" - UTF8 ECI identifier</para>
+         * To disable current ECI mode and convert to default JIS8 mode zero mode ECI indetifier is set. "\000000"</para>
+         * All unicode characters after ECI identifier are automatically encoded into correct character codeset.</para>
+         * This mode is not supported by MicroQR barcodes.</para>
+         * @deprecated This property is obsolete and will be removed in future releases. Instead, use the 'Extended' encode mode.
+         */
+        EXTENDED_CODETEXT: 5,
+
+        /**
+         * Extended Channel mode which supports FNC1 first position, FNC1 second position and multi ECI modes.</para>
+         * It is better to use QrExtCodetextBuilder for extended codetext generation.</para>
+         * Use Display2DText property to set visible text to removing managing characters.</para>
+         * Encoding Principles:</para>
+         * All symbols "\" must be doubled "\\" in the codetext.</para>
+         * FNC1 in first position is set in codetext as as "&lt;FNC1&gt;"</para>
+         * FNC1 in second position is set in codetext as as "&lt;FNC1(value)&gt;". The value must be single symbols (a-z, A-Z) or digits from 0 to 99.</para>
+         * Group Separator for FNC1 modes is set as 0x1D character '\\u001D' </para>
+         * If you need to insert "&lt;FNC1&gt;" string into barcode write it as "&lt;\FNC1&gt;" </para>
+         * ECI identifiers are set as single slash and six digits identifier "\000026" - UTF8 ECI identifier</para>
+         * To disable current ECI mode and convert to default JIS8 mode zero mode ECI indetifier is set. "\000000"</para>
+         * All unicode characters after ECI identifier are automatically encoded into correct character codeset.</para>
+         * This mode is not supported by MicroQR barcodes.</para>
+         */
+        EXTENDED: 6,
+
+        /**
+         * In Binary mode, the CodeText is encoded with maximum data compactness.
+         * If a Unicode character is found, an exception is thrown.
+         */
+        BINARY: 7,
+
+        /**
+         * In ECI mode, the entire message is re-encoded in the ECIEncoding specified encoding with the insertion of an ECI identifier.
+         * If a character is found that is not supported by the selected ECI encoding, an exception is thrown.
+         * Please note that some old (pre 2006) scanners may not support this mode.
+         * This mode is not supported by MicroQR barcodes.
+         */
+        ECI: 8
 
     };
 

package/lib/Recognition.js

@@ -433,7 +433,8 @@ class BarCodeReader extends joint.BaseJavaClass
         {
             let xmlData = fs.readFileSync(xmlFile).toString();
             let java_class_link = new java.import(BarCodeReader.javaClassName);
-            return BarCodeReader.construct(java_class_link.importFromXmlSync(xmlData.substring(3, xmlData.length)));
+            xmlData = xmlData.substring(0, 3) === "п»ї" ? xmlData.substring(3, xmlData.length) : xmlData;
+            return BarCodeReader.construct(java_class_link.importFromXmlSync(xmlData));
         } catch (ex)
         {
             let barcode_exception = new joint.BarcodeException(ex);
@@ -938,7 +939,11 @@ class Pdf417ExtendedParameters extends joint.BaseJavaClass
      */
     getMacroPdf417TimeStamp()
     {
-        return new Date(this.getJavaClass().getMacroPdf417TimeStampSync() * 1000);
+        const value = this.getJavaClass().getMacroPdf417TimeStampSync();
+
+        if (!value) return null;
+
+        return new Date(value);
     }
 
     /**
@@ -1965,7 +1970,7 @@ class Code128DataPortion extends joint.BaseJavaClass
 /**
  * Stores a DataBar additional information of recognized barcode
  *@example
- *  let reader = new BarCodeReader("c:\\test.png", DecodeType.DATABAR_OMNI_DIRECTIONAL);
+ *  let reader = new BarCodeReader("test.png", DecodeType.DATABAR_OMNI_DIRECTIONAL);
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {
@@ -2292,6 +2297,88 @@ class BarcodeSettings extends joint.BaseJavaClass
         this.getJavaClass().setStripFNCSync(value);
     }
 
+
+
+    /**
+     * Returns only barcode types explicitly specified for recognition.
+     * When enabled, recognized barcodes of other compatible or equivalent types are filtered out.
+     * Default value is false.
+     *
+     * <p>Example:</p>
+     * <pre>
+     * // generate EAN13 barcode
+     * let generator = new BarcodeGenerator(EncodeTypes.EAN_13, "2383823482894");
+     * generator.save("test.png");
+     *
+     * // recognize only UPCA barcodes (no results, because source is EAN13)
+     * const reader = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader.getBarcodeSettings().setOnlyRequestedTypes(true);
+     *
+     * let results = reader.readBarCodes();
+     * for (let i = 0; i < results.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results[i].getCodeText());
+     * }
+     *
+     * // recognize compatible types: EAN13, UPCA, ISSN, ISMN, ISBN
+     * // (EAN13 will be returned as UPCA-equivalent)
+     * let reader2 = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader2.getBarcodeSettings().setOnlyRequestedTypes(false);
+     *
+     * let results2 = reader2.readBarCodes();
+     * for (let i = 0; i < results2.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results2[i].getCodeText());
+     * }
+     * </pre>
+     *
+     * @return true if only explicitly requested barcode types are returned; otherwise false
+     */
+    isOnlyRequestedTypes()
+    {
+        return this.getJavaClass().isOnlyRequestedTypesSync();
+    }
+
+    /**
+     * Returns only barcode types explicitly specified for recognition.
+     * When enabled, recognized barcodes of other compatible or equivalent types are filtered out.
+     * Default value is false.
+     *
+     * <p>Example:</p>
+     * <pre>
+     * // generate EAN13 barcode
+     * let generator = new BarcodeGenerator(EncodeTypes.EAN_13, "2383823482894");
+     * generator.save("test.png");
+     *
+     * // recognize only UPCA barcodes (no results, because source is EAN13)
+     * const reader = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader.getBarcodeSettings().setOnlyRequestedTypes(true);
+     *
+     * let results = reader.readBarCodes();
+     * for (let i = 0; i < results.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results[i].getCodeText());
+     * }
+     *
+     * // recognize compatible types: EAN13, UPCA, ISSN, ISMN, ISBN
+     * // (EAN13 will be returned as UPCA-equivalent)
+     * let reader2 = new BarCodeReader("test.png", null, DecodeType.UPCA);
+     * reader2.getBarcodeSettings().setOnlyRequestedTypes(false);
+     *
+     * let results2 = reader2.readBarCodes();
+     * for (let i = 0; i < results2.length; i++)
+     * {
+     *     console.log("BarCode CodeText: " + results2[i].getCodeText());
+     * }
+     * </pre>
+     *
+     * @return true if only explicitly requested barcode types are returned; otherwise false
+     */
+    setOnlyRequestedTypes(value)
+    {
+        this.getJavaClass().setOnlyRequestedTypesSync(value);
+    }
+
     /**
      * The flag which force engine to detect codetext encoding for Unicode codesets. Default value is true.
      *
@@ -2558,9 +2645,9 @@ class MaxiCodeExtendedParameters extends joint.BaseJavaClass
  *
  * @example
  * let generator = new BarcodeGenerator(EncodeTypes.DOT_CODE, "12345");
- * generator.save("c:\\test.png", BarCodeImageFormat.PNG);
+ * generator.save("test.png", BarCodeImageFormat.PNG);
  *
- * let reader = new BarCodeReader("c:\\test.png", null, DecodeType.DOT_CODE);
+ * let reader = new BarCodeReader("test.png", null, DecodeType.DOT_CODE);
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {
@@ -2681,9 +2768,9 @@ class DotCodeExtendedParameters extends joint.BaseJavaClass
  * This sample shows how to get DataMatrix raw values
  * <pre>
  * let generator = new BarcodeGenerator(EncodeTypes.DATA_MATRIX, "12345"))
- * generator.save("c:\\test.png", BarcodeImageFormat.PNG);
+ * generator.save("test.png", BarcodeImageFormat.PNG);
  *
- * let reader = new BarCodeReader("c:\\test.png", null, DecodeType.DATA_MATRIX))
+ * let reader = new BarCodeReader("test.png", null, DecodeType.DATA_MATRIX))
  * let results = reader.readBarCodes();
  * for(let i = 0; i < results.length; i++)
  * {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aspose.barcode",
-  "version": "26.2.0",
+  "version": "26.4.0",
   "description": "barcode generation and recognition component",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"