aspose.barcode 25.6.0 → 25.8.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.6.jar";
+const jar_name_ = "/aspose-barcode-nodejs-25.8.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)
     {
@@ -5423,63 +5465,115 @@ class PdfParameters extends joint.BaseJavaClass
     /** no-op initializer */
     init() {}
 
-    /** @returns {CMYKColor|null} */
+    /**
+     *  CMYK color value of bar code. Null means CMYK color is not used, instead normal RGB color is used.
+     *  @returns {CMYKColor|null}
+     */
     getCMYKBarColor()
     {
-        return raw == null ? null : CMYKColor.parseCMYK(this.getJavaClass().getCMYKBarColorSync());
+        return CMYKColor.parseCMYK(this.getJavaClass().getCMYKBarColorSync());
     }
 
-    /** @param {CMYKColor|null} value */
+    /**
+     * CMYK color value of bar code. Null means CMYK color is not used, instead normal RGB color is used.
+     * @param {CMYKColor|null} value
+     */
     setCMYKBarColor(value)
     {
         this.getJavaClass().setCMYKBarColorSync(value != null ? value.formatCMYK() : null);
     }
 
-    /** @returns {CMYKColor|null} */
+    /**
+     * CMYK back color value. Null means CMYK color is not used, instead normal RGB color is used.
+     * @returns {CMYKColor|null}
+     */
     getCMYKBackColor()
     {
-        return raw == null ? null : CMYKColor.parseCMYK(this.getJavaClass().getCMYKBackColorSync());
+        return CMYKColor.parseCMYK(this.getJavaClass().getCMYKBackColorSync());
     }
 
-    /** @param {CMYKColor|null} value */
+    /**
+     * CMYK back color value. Null means CMYK color is not used, instead normal RGB color is used.
+     * @param {CMYKColor|null} value
+     */
     setCMYKBackColor(value)
     {
         this.getJavaClass().setCMYKBackColorSync(value != null ? value.formatCMYK() : null);
     }
 
-    /** @returns {CMYKColor|null} */
+    /**
+     * CMYK color value of Codetext. Null means CMYK color is not used, instead normal RGB color is used.
+     * @returns {CMYKColor|null}
+     */
     getCMYKCodetextColor()
     {
-        return raw == null ? null : CMYKColor.parseCMYK(this.getJavaClass().getCMYKCodetextColorSync());
+        return CMYKColor.parseCMYK(this.getJavaClass().getCMYKCodetextColorSync());
     }
 
-    /** @param {CMYKColor|null} value */
+    /**
+     * CMYK color value of Codetext. Null means CMYK color is not used, instead normal RGB color is used.
+     * @param {CMYKColor|null} value
+     */
     setCMYKCodetextColor(value)
     {
         this.getJavaClass().setCMYKCodetextColorSync(value != null ? value.formatCMYK() : null);
     }
 
-    /** @returns {CMYKColor|null} */
+    /**
+     * CMYK color value of caption above. Null means CMYK color is not used, instead normal RGB color is used.
+     * @returns {CMYKColor|null}
+     */
     getCMYKCaptionAboveColor() {
         return CMYKColor.parseCMYK(this.getJavaClass().getCMYKCaptionAboveColorSync());
     }
 
-    /** @param {CMYKColor|null} value */
+    /**
+     * CMYK color value of caption above. Null means CMYK color is not used, instead normal RGB color is used.
+     *  @param {CMYKColor|null} value
+     */
     setCMYKCaptionAboveColor(value) {
         this.getJavaClass().setCMYKCaptionAboveColorSync(value != null ? value.formatCMYK() : null);
     }
 
-    /** @returns {CMYKColor|null} */
+    /**
+     * CMYK color value of caption below. Null means CMYK color is not used, instead normal RGB color is used.
+     * @returns {CMYKColor|null}
+     */
     getCMYKCaptionBelowColor()
     {
         return CMYKColor.parseCMYK(this.getJavaClass().getCMYKCaptionBelowColorSync());
     }
 
-    /** @param {CMYKColor|null} value */
+    /**
+     * CMYK color value of caption below. Null means CMYK color is not used, instead normal RGB color is used.
+     * @param {CMYKColor|null} value
+     */
     setCMYKCaptionBelowColor(value)
     {
         this.getJavaClass().setCMYKCaptionBelowColorSync(value.formatCMYK());
     }
+
+    /**
+     * <p>
+     * Are paths used instead of text (use if Unicode characters are not displayed)
+     * Default value: false.
+     * </p>
+     */
+    isTextAsPath()
+    {
+        return this.getJavaClass().isTextAsPathSync();
+    }
+
+    /**
+     * <p>
+     * Are paths used instead of text (use if Unicode characters are not displayed)
+     * Default value: false.
+     * </p>
+     */
+    setTextAsPath(value)
+    {
+        this.getJavaClass().setTextAsPathSync(value);
+    }
 }
 
 /**
@@ -5525,7 +5619,7 @@ class CMYKColor {
             return v;
         });
 
-        return new CMYKColor(nums[0], nums[1], nums[2], nums[3]);
+        return new CMYKColor(nums[0] * 100, nums[1] * 100, nums[2] * 100, nums[3] * 100);
     }
 
     /**

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.6.0",
+  "version": "25.8.0",
   "description": "barcode generation and recognition component",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"