aspose.barcode 25.5.0 → 25.7.0

package/examples/GenerateAndReadExample.js

@@ -17,7 +17,7 @@ function generateAndRead()
 
     reader.readBarCodes().forEach(function(result, i, results)
     {
-       console.log("Recognized barcode code text: " + result.getCodeText(false) + "\n");
+       console.log("Recognized barcode code text: " + result.getCodeText() + "\n");
         console.log("Recognized barcode code type: " + result.getCodeTypeName() + "\n");
     });
 }

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-25.5.jar";
+const jar_name_ = "/aspose-barcode-nodejs-25.7.jar";
 const jar_path_ = __dirname + jar_name_;
 const fs = require("fs");
 

package/lib/Generation.js

@@ -127,12 +127,54 @@ class BarcodeGenerator extends joint.BaseJavaClass
 
     /**
      * <p>
-     * Encodes codetext with byte order mark (BOM) using specified encoding.
-     * </p>
-     * @param  codeText CodeText string | Bytes of codetext
+     *  <p>
+     *  Encodes the Unicode {@code <b>codeText</b>} into a byte sequence using the specified {@code <b>encoding</b>}.
+     *  UTF-8 is the most commonly used encoding.
+     *  If the encoding supports it and {@code <b>insertBOM</b>} is set to {@code true}, the function includes a
+     *  {@code <a href="https://en.wikipedia.org/wiki/Byte_order_mark#Byte-order_marks_by_encoding">byte order mark (BOM)</a>}.
+     *  </p>
+     *  <p>
+     *  This function 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, {@code <a href="https://en.wikipedia.org/wiki/Extended_Channel_Interpretation">ECI</a>} encoding is recommended for Unicode data.
+     *  </p>
+     *  <p>
+     *  Using this function 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.
+     *  </p>
+     *  </p><p><hr><blockquote><pre>
+     *  <p>This example shows how to use {@code SetCodeText} with or without a BOM for 2D barcodes.</p>
+     *  <pre>
+     * 	//Encode codetext using UTF-8 with BOM
+     * 	let gen = new BarcodeGenerator(EncodeTypes.QR, null);
+     *  gen.setCodeText("車種名", "UTF-8", true);
+     * 	gen.save("barcode.png", BarCodeImageFormat.PNG);
+     *
+     * 	let reader = new BarCodeReader("barcode.png", null, DecodeType.QR);
+     * 	let results = reader.readBarCodes();
+     * 	for(let i = 0; i < results.length; i++)
+     * 	{
+     * 	    let result = results[i];
+     * 	    console.log("BarCode CodeText: " + result.getCodeText());
+     *  }
+     * 	//Encode codetext using UTF-8 without BOM
+     * 	let gen = new BarcodeGenerator(EncodeTypes.QR, null);
+     *  gen.setCodeText("車種名", "UTF-8", false);
+     * 	gen.save("barcode.png", BarCodeImageFormat.PNG);
+     * 	let reader = new BarCodeReader("barcode.png", null, DecodeType.QR);
+     *  let results = reader.readBarCodes();
+     *  for(let i = 0; i < results.length; i++)
+     *  {
+     *      let result = results[i];
+     *      console.log("BarCode CodeText: " + result.getCodeText());
+     *  }
+     * 	</pre>
+     *  </pre></blockquote></hr></p>
+     * @param codeText CodeText string
      * @param encoding Applied encoding
-     * @param BoM flag indicates insertion of the Encoding byte order mark (BOM). In case, the Encoding requires byte order mark (BOM) insertion: like UTF8,
-     * UTF16, UTF32, e.t.c. and flag is set to true, the BOM is added, in case of setting flag to false, the BOM insertion is ignored.
+     * @param insertBOM
+     *  Indicates whether to insert a byte order mark (BOM) when the specified encoding supports it (e.g., UTF-8, UTF-16, UTF-32).
+     *  If set to {@code true}, the BOM is added; if {@code false}, the BOM is omitted even if the encoding normally uses one.
+     *
      */
     setCodeText(codeText, encoding, BoM)
     {

package/lib/Recognition.js

@@ -1196,11 +1196,30 @@ class BarCodeResult extends joint.BaseJavaClass
     }
 
     /**
-     *  Gets the code text Value: The code text of the barcode
+     * <p>
+     *  Gets the code text with encoding.
+     *  </p><p><hr><blockquote><pre>
+     *  <p>This example shows how to use {@code getCodeText}:</p>
+     *  <pre>
+     *  let gen = new BarcodeGenerator(EncodeTypes.DATA_MATRIX, null);
+     * 	gen.setCodeText("車種名", "932");
+     * 	gen.save("barcode.png", BarCodeImageFormat.PNG);
+     *
+     * 	let reader = new BarCodeReader("barcode.png", null, DecodeType.DATA_MATRIX);
+     *  let results = reader.readBarCodes();
+     *  for(let i = 0; i < results.length; i++)
+     *  {
+     *      let result = results[i];
+     *      console.log("BarCode CodeText: " + result.getCodeText("932"));
+     *  }
+     * 	</pre>
+     *  </pre></blockquote></hr></p>
+     * @return A string containing recognized code text.
+     * @param encoding The encoding for codetext.
      */
-    getCodeText()
+    getCodeText(encoding)
     {
-        return this.getJavaClass().getCodeTextSync();
+        return this.getJavaClass().getCodeTextSync(encoding);
     }
 
     /**

package/package.json

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