aspose.barcode 24.12.0 → 25.2.0

package/lib/Generation.js

@@ -131,14 +131,18 @@ class BarcodeGenerator extends joint.BaseJavaClass
      * </p>
      * @param  codeText CodeText string | Bytes of codetext
      * @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.
      */
-    setCodeText(codeText, encoding)
+    setCodeText(codeText, encoding, BoM)
     {
         if (Array.isArray(codeText)) {
             this.getJavaClass().setCodeBytesSync(Buffer.from(codeText));
         }
-        else {
-            this.getJavaClass().setCodeTextSync(codeText, encoding);
+        else
+        {
+            let adaptedBoMStr = BoM == null ? null : BoM.toString();
+            this.getJavaClass().setCodeTextSync(codeText, encoding, adaptedBoMStr);
         }
     }
 
@@ -2859,19 +2863,23 @@ class QrParameters extends joint.BaseJavaClass
  * # Encodes GS1 UCC/EAN-128 non Linked mode 905 with AI 01 (GTIN)
  * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(01)12345678901231");
  * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
- * reader.readBarCodes().forEach(function(result, i, results)
+ * let results = reader.readBarCodes();
+ * for(let i = 0; i < results.length; i++)
  * {
+ *    let result = results[i];
  *    console.log( result.getCodeText());
- * });
+ * }
  *
  * @example
  * # Encodes GS1 UCC/EAN-128 non Linked modes 903, 904 with any AI
  * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(241)123456789012345(241)ABCD123456789012345");
  * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
- * reader.readBarCodes().forEach(function(result, i, results)
+ * let results = reader.readBarCodes();
+ * for(let i = 0; i < results.length; i++)
  * {
+ *    let result = results[i];
  *    console.log( result.getCodeText());
- * });
+ * }
  * </pre>
  * </pre>
  * </p>
@@ -3246,20 +3254,24 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "abcde1234");
      * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_05);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log( result.getCodeText());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 with 06 Macro the string: "[)>\u001E06\u001Dabcde1234\u001E\u0004"
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "abcde1234");
      * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_06);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText());
-     * });
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -3282,20 +3294,24 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "abcde1234");
      * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_05);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log( result.getCodeText());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 with 06 Macro the string: "[)>\u001E06\u001Dabcde1234\u001E\u0004"
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "abcde1234");
      * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_06);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *    let result = results[i];
      *    console.log( result.getCodeText());
-     * });
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -3318,90 +3334,108 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(11)991231(10)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 13 (Packaging date) and AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(13)991231(21)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 15 (Sell-by date) and AI 10 (Lot number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(15)991231(10)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 17 (Expiration date) and AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(17)991231(21)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 914 with AI 10 (Lot number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(10)ABCD12345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 915 with AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(21)ABCD12345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked modes 906, 907 with any AI
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(240)123456789012345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes MicroPdf417 NON EAN.UCC Linked mode 918
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "ABCDE123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes Pdf417 NON EAN.UCC Linked mode 918
      * let generator = new BarcodeGenerator(EncodeTypes.PDF_417, "ABCDE123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -3425,90 +3459,108 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(11)991231(10)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 13 (Packaging date) and AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(13)991231(21)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 15 (Sell-by date) and AI 10 (Lot number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(15)991231(10)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 912 with date field AI 17 (Expiration date) and AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(17)991231(21)ABCD");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 914 with AI 10 (Lot number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(10)ABCD12345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *     let result = results[i];  
+     *     result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked mode 915 with AI 21 (Serial number)
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(21)ABCD12345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *    let result = results[i];
+     *    result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes GS1 Linked modes 906, 907 with any AI
      * let generator = new BarcodeGenerator(EncodeTypes.GS_1_MICRO_PDF_417, "(240)123456789012345");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS_1_MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *    let result = results[i];
+     *    result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes MicroPdf417 NON EAN.UCC Linked mode 918
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "ABCDE123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *    let result = results[i];
+     *    result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      *
      * @example
      * # Encodes Pdf417 NON EAN.UCC Linked mode 918
      * let generator = new BarcodeGenerator(EncodeTypes.PDF_417, "ABCDE123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setLinked(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
-     *         console.log(result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
-     * });
+     *    let result = results[i];
+     *    result.getCodeText() + " IsLinked:" + result.getExtended().getPdf417().isLinked();
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -3530,30 +3582,36 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "a\u001d1222322323");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 in Code 128 emulation mode with FNC1 in second position and Application Indicator "99", mode 909.
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "99\u001d1222322323");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 in Code 128 emulation mode, modes 910, 911
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -3575,30 +3633,36 @@ class Pdf417Parameters extends joint.BaseJavaClass
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "a\u001d1222322323");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 in Code 128 emulation mode with FNC1 in second position and Application Indicator "99", mode 909.
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "99\u001d1222322323");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *     console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      *
      * @example
      * # Encodes MicroPdf417 in Code 128 emulation mode, modes 910, 911
      * let generator = new BarcodeGenerator(EncodeTypes.MICRO_PDF_417, "123456789012345678");
      * generator.getParameters().getBarcode().getPdf417().setCode128Emulation(true);
      * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
-     * reader.readBarCodes().forEach(function(result, i, results)
+     * let results = reader.readBarCodes();
+     * for(let i = 0; i < results.length; i++)
      * {
+     *     let result = results[i];  
      *    console.log(result.getCodeText() + " IsCode128Emulation:" + result.getExtended().getPdf417().isCode128Emulation());
-     * });
+     * }
      * </pre>
      * </pre></blockquote></hr></p>
      */
@@ -7072,30 +7136,36 @@ class AztecExtCodetextBuilder extends ExtCodetextBuilder
  * let generator = new BarcodeGenerator(EncodeTypes.DATA_MATRIX, "10123ABC\u001D10123ABC");
  * generator.getParameters().getBarcode().getDataMatrix().setMacroCharacters(MacroCharacter.MACRO_05);
  * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.GS1DataMatrix);
- * reader.readBarCodes().forEach(function(result, i, results)
+ * let results = reader.readBarCodes();
+ * for(let i = 0; i < results.length; i++)
  * {
+ *     let result = results[i];  
  *     console.log("BarCode CodeText: " + result.getCodeText());
- * });
+ * }
  *
  * @example
  * # Encodes MicroPdf417 with 05 Macro the string: "[)>\u001E05\u001Dabcde1234\u001E\u0004"
  * let generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "abcde1234");
  * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_05);
  * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
- * reader.readBarCodes().forEach(function(result, i, results)
+ * let results = reader.readBarCodes();
+ * for(let i = 0; i < results.length; i++)
  * {
+ *     let result = results[i];  
  *     console.log( result.getCodeText());
- * });
+ * }
  *
  * @example
  * # Encodes MicroPdf417 with 06 Macro the string: "[)>\u001E06\u001Dabcde1234\u001E\u0004"
  * let generator = new BarcodeGenerator(EncodeTypes.MicroPdf417, "abcde1234");
  * generator.getParameters().getBarcode().getPdf417().setMacroCharacters(MacroCharacter.MACRO_06);
  * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), null, DecodeType.MICRO_PDF_417);
- * reader.readBarCodes().forEach(function(result, i, results)
+ * let results = reader.readBarCodes();
+ * for(let i = 0; i < results.length; i++)
  * {
+ *    let result = results[i];
  *    console.log( result.getCodeText());
- * });
+ * }
  * </pre>
  * </pre>
  */
@@ -7116,10 +7186,12 @@ MacroCharacter =
          * let generator = new BarcodeGenerator(EncodeTypes.DATA_MATRIX, "10123ABC\u001D10123ABC");
          * generator.getParameters().getBarcode().getDataMatrix().setMacroCharacters(MacroCharacter.MACRO_05);
          * let reader = new BarCodeReader(generator.generateBarCodeImage(BarcodeImageFormat.PNG), DecodeType.GS_1_DATA_MATRIX);
-         * reader.readBarCodes().forEach(function(result, i, results)
+         * let results = reader.readBarCodes();
+         * for(let i = 0; i < results.length; i++)
          * {
+         *     let result = results[i];  
          *     cosole.log("BarCode CodeText: " + result.getCodeText());
-         * });
+         * }
          */
         MACRO_05: 5,
 
@@ -7401,7 +7473,12 @@ BarCodeImageFormat =
         /**
          * Specifies the Scalable Vector Graphics (SVG) image format.
          */
-        SVG: 7
+        SVG: 7,
+
+        /**
+         * Specifies the Portable Document Format (PDF) image format.
+         */
+        PDF: 8
     };
 
 
@@ -7492,10 +7569,11 @@ Pdf417MacroTerminator =
  *
  * //encode array to string
  * let strBld = "";
- * encodedArr.forEach(function(bval, i, bvals)
+ * for(let i = 0; i < encodedArr.length; i++)
  * {
+ *     let bval = encodedArr[i];
  *     strBld += bval;
- * });
+ * }
  * let codetext = strBld;
  *
  * let generator = new BarcodeGenerator(EncodeTypes.MAXI_CODE, codetext))
@@ -7704,10 +7782,11 @@ MaxiCodeMode =
  * let encodedArr = array( 0xFF, 0xFE, 0xFD, 0xFC, 0xFB, 0xFA, 0xF9 );
  * //encode array to string
  * let codetext = "";
- * encodedArr.forEach(function(bval, i, bvals)
+ * for(let i = 0; i < encodedArr.length; i++)
  * {
+ *     let bval = encodedArr[i];
  *     codetext += bval;
- * });
+ * };
  *
  * @example
  * let generator = new BarcodeGenerator(EncodeTypes.DOT_CODE, codetext);