aspose.barcode 23.5.0 → 23.6.0

package/lib/Recognition.js

@@ -107,6 +107,9 @@ class BarCodeReader extends joint.BaseJavaClass
         return this.getJavaClass().containsAnySync(decodeTypes);
     }
 
+    /**
+     * internal
+     */
     static convertToString(arg)
     {
         if (is_int(arg))
@@ -144,7 +147,7 @@ class BarCodeReader extends joint.BaseJavaClass
 
     /**
      * Gets the timeout of recognition process in milliseconds.<br>
-     *@example
+     * @example
      * let reader = new BarCodeReader("test.png", null, null);
      * reader.setTimeout(5000);
      * reader.readBarCodes().forEach(function(result, i, results)
@@ -247,10 +250,10 @@ class BarCodeReader extends joint.BaseJavaClass
     }
 
     /**
-     * QualitySettings allows to configure recognition quality and speed manually.
-     * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,
-     * HighQuality, MaxBarCodes or you can manually configure separate options.
-     * Default value of QualitySettings is NormalQuality.
+     * QualitySettings allows to configure recognition quality and speed manually.<br>
+     * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,<br>
+     * HighQuality, MaxBarCodes or you can manually configure separate options.<br>
+     * Default value of QualitySettings is NormalQuality.<br>
      * @return QualitySettings to configure recognition quality and speed.
      *
      * @example
@@ -263,12 +266,16 @@ class BarCodeReader extends joint.BaseJavaClass
      * {
      *   console.log("BarCode CodeText: " + result.getCodeText());
      * });
+     *
+     * @example
      * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
      * //normal quality mode is set by default
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
      *   console.log("BarCode CodeText: " + result.getCodeText());
      * });
+     *
+     * @example
      * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
      * //set high performance mode
      * reader.setQualitySettings(QualitySettings.getHighPerformance());
@@ -279,7 +286,6 @@ class BarCodeReader extends joint.BaseJavaClass
      * {
      *   console.log("BarCode CodeText: " + result.getCodeText());
      * });
-     *
      */
     getQualitySettings()
     {
@@ -287,9 +293,9 @@ class BarCodeReader extends joint.BaseJavaClass
     }
 
     /**
-     * QualitySettings allows to configure recognition quality and speed manually.
-     * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,
-     * HighQuality, MaxBarCodes or you can manually configure separate options.
+     * QualitySettings allows to configure recognition quality and speed manually.<br>
+     * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,<br>
+     * HighQuality, MaxBarCodes or you can manually configure separate options.<br>
      * Default value of QualitySettings is NormalQuality.
      *
      * @example
@@ -301,12 +307,14 @@ class BarCodeReader extends joint.BaseJavaClass
      * {
      *   console.log("BarCode CodeText: " + result.getCodeText());
      * });
+     * @example
      * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
      * //normal quality mode is set by default
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
      *   console.log("BarCode CodeText: " + result.getCodeText());
      * });
+     * @example
      * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
      *  //set high performance mode
      * reader.setQualitySettings(QualitySettings.getHighPerformance());
@@ -334,7 +342,7 @@ class BarCodeReader extends joint.BaseJavaClass
     }
 
     /**
-     * Sets bitmap image and areas for recognition.
+     * Sets bitmap image and areas for recognition.<br>
      * Must be called before ReadBarCodes() method.
      * @example
      * //This sample shows how to detect Code39 and Code128 barcodes.
@@ -386,7 +394,7 @@ class BarCodeReader extends joint.BaseJavaClass
     }
 
     /**
-     * Sets SingleDecodeType type array for recognition.
+     * Sets SingleDecodeType type array for recognition.<br>
      * Must be called before readBarCodes() method.
      * @example
      * //This sample shows how to detect Code39 and Code128 barcodes.
@@ -409,15 +417,19 @@ class BarCodeReader extends joint.BaseJavaClass
         this.getJavaClass().setBarCodeReadTypeSync(types);
     }
 
+    /**
+     * Gets the decode type of the input barcode decoding
+     * @returns {*}
+     */
     getBarCodeDecodeType()
     {
         return this.getJavaClass().getBarCodeDecodeTypeSync();
     }
 
     /**
-     * Exports BarCode properties to the xml-file specified
-     * @param xmlFile The name of  the file
-     * @return Whether or not export completed successfully.
+     * Exports BarCode properties to the xml-file specified<br>
+     * @param xmlFile The name of  the file<br>
+     * @return Whether or not export completed successfully.<br>
      * Returns True in case of success; False Otherwise
      */
     exportToXml(xmlFile)
@@ -439,8 +451,8 @@ class BarCodeReader extends joint.BaseJavaClass
     }
 
     /**
-     * Exports BarCode properties to the xml-file specified
-     * @param xmlFile The name of  the file
+     * Exports BarCode properties to the xml-file specified<br>
+     * @param xmlFile The name of  the file<br>
      * @return Whether or not export completed successfully. Returns True in case of success; False Otherwise
      */
     static importFromXml(xmlFile)
@@ -522,7 +534,7 @@ class Quadrangle extends joint.BaseJavaClass
     }
 
     /**
-     * Gets left-top corner Point of Quadrangle regionValue: A left-top corner Point of Quadrangle region
+     * Sets left-top corner Point of Quadrangle regionValue: A left-top corner Point of Quadrangle region
      */
     setLeftTop(value)
     {
@@ -539,7 +551,7 @@ class Quadrangle extends joint.BaseJavaClass
     }
 
     /**
-     * Gets right-top corner Point of Quadrangle regionValue: A right-top corner Point of Quadrangle region
+     * Sets right-top corner Point of Quadrangle regionValue: A right-top corner Point of Quadrangle region
      */
     setRightTop(value)
     {
@@ -556,7 +568,7 @@ class Quadrangle extends joint.BaseJavaClass
     }
 
     /**
-     * Gets right-bottom corner Point of Quadrangle regionValue: A right-bottom corner Point of Quadrangle region
+     * Sets right-bottom corner Point of Quadrangle regionValue: A right-bottom corner Point of Quadrangle region
      */
     setRightBottom(value)
     {
@@ -573,7 +585,7 @@ class Quadrangle extends joint.BaseJavaClass
     }
 
     /**
-     * Gets left-bottom corner Point of Quadrangle regionValue: A left-bottom corner Point of Quadrangle region
+     * Sets left-bottom corner Point of Quadrangle regionValue: A left-bottom corner Point of Quadrangle region
      */
     setLeftBottom(value)
     {
@@ -727,7 +739,10 @@ class QRExtendedParameters extends joint.BaseJavaClass
     {
         return this.getJavaClass().getQRStructuredAppendModeParityDataSync();
     }
-
+    /**
+     * <p>Tests whether all parameters has only default values</p>Value
+     * @returns <b>true</b> if all parameters has only default values; otherwise, {@code <b>false</b>}.
+     */
     isEmpty()
     {
         return this.getJavaClass().isEmptySync();
@@ -1009,7 +1024,7 @@ class OneDExtendedParameters extends joint.BaseJavaClass
 }
 
 /**
- * Stores special data of Code128 recognized barcode
+ * Stores special data of Code128 recognized barcode<br>
  * Represents the recognized barcode's region and barcode angle
  * @example
  * //This sample shows how to get code128 raw values
@@ -1131,7 +1146,7 @@ class BarcodeSvmDetectorSettings extends joint.BaseJavaClass
     }
 
     /**
-     * High performance detection preset.
+     * High performance detection preset.<br>
      *
      * Default for {@code QualitySettings.PresetType.HighPerformance}
      */
@@ -1641,7 +1656,8 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
         this._dotCodeExtendedParameters = new DotCodeExtendedParameters(this.getJavaClass().getDotCodeSync());
     }
 
-    /** Gets a DataBar additional information DataBarExtendedParameters  of recognized barcode<br>
+    /**
+     * Gets a DataBar additional information DataBarExtendedParameters  of recognized barcode<br>
      * @return mixed A DataBar additional information DataBarExtendedParameters of recognized barcode
      */
     getDataBar()
@@ -1732,9 +1748,9 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
 }
 
 /**
- * QualitySettings allows to configure recognition quality and speed manually.
- * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,
- * HighQuality, MaxBarCodes or you can manually configure separate options.
+ * QualitySettings allows to configure recognition quality and speed manually.<br>
+ * You can quickly set up QualitySettings by embedded presets: HighPerformance, NormalQuality,<br>
+ * HighQuality, MaxBarCodes or you can manually configure separate options.<br>
  * Default value of QualitySettings is NormalQuality.
  * @example
  * //This sample shows how to use QualitySettings with BarCodeReader
@@ -1745,12 +1761,14 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
  * {
  *    console.log("BarCode CodeText: " + result.getCodeText());
  * });
+ * @example
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
  * //normal quality mode is set by default
  * reader.readBarCodes().forEach(function(result, i, results)
  * {
  *   console.log("BarCode CodeText: " + result.getCodeText());
  * });
+ * @example
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
  * //set high quality mode with low speed recognition
  * reader.setQualitySettings(QualitySettings.getHighQuality());
@@ -1758,6 +1776,7 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
  * {
  *   console.log("BarCode CodeText: " + result.getCodeText());
  * });
+ * @example
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
  * //set max barcodes mode, which tries to find all possible barcodes, even incorrect. The slowest recognition mode
  * reader.setQualitySettings(QualitySettings.getMaxBarCodes());
@@ -1765,6 +1784,7 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
  * {
  *   console.log("BarCode CodeText: " + result.getCodeText());
  * });
+ * @example
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
  * //set high performance mode
  * reader.setQualitySettings(QualitySettings.getHighPerformance());
@@ -1775,6 +1795,7 @@ class BarCodeExtendedParameters extends joint.BaseJavaClass
  * {
  *     console.log("BarCode CodeText: " + result.getCodeText());
  * });
+ * @example
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
  * //default mode is NormalQuality
  * //set separate options
@@ -1829,7 +1850,6 @@ class QualitySettings extends joint.BaseJavaClass
      * @example
      * let reader = new BarCodeReader("test.png");
      * reader.setQualitySettings(QualitySettings.getHighPerformance());
-
      */
     static getHighPerformance()
     {
@@ -1865,11 +1885,11 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * MaxQualityDetection recognition quality preset. Same as NormalQuality but with highest quality DetectorSettings.
+     * MaxQualityDetection recognition quality preset. Same as NormalQuality but with highest quality DetectorSettings.<br>
      * Allows to detect diagonal and damaged barcodes.
      *
      * @example
-     *let reader = new BarCodeReader("test.png");
+     * let reader = new BarCodeReader("test.png");
      * reader.setQualitySettings(QualitySettings.getMaxQualityDetection());
      */
     static getMaxQualityDetection()
@@ -1882,7 +1902,7 @@ class QualitySettings extends joint.BaseJavaClass
      * HighQuality recognition quality preset. This preset is developed for low quality barcodes.
      *
      * @example
-     *let reader = new BarCodeReader("test.png");
+     * let reader = new BarCodeReader("test.png");
      * reader.setQualitySettings(QualitySettings.getHighQuality());
      */
     static getHighQuality()
@@ -1922,7 +1942,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine to recognize barcodes which has incorrect checksumm or incorrect values.
+     * Allows engine to recognize barcodes which has incorrect checksumm or incorrect values.<br>
      * Mode can be used to recognize damaged barcodes with incorrect text.
      */
     getAllowIncorrectBarcodes()
@@ -1931,7 +1951,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine to recognize barcodes which has incorrect checksumm or incorrect values.
+     * Allows engine to recognize barcodes which has incorrect checksumm or incorrect values.<br>
      * Mode can be used to recognize damaged barcodes with incorrect text.
      */
     setAllowIncorrectBarcodes(value)
@@ -2042,7 +2062,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine to recognize decreased image as additional scan. Size for decreasing is selected by internal engine algorithms.
+     * Allows engine to recognize decreased image as additional scan. Size for decreasing is selected by internal engine algorithms.<br>
      * Mode helps to recognize barcodes which are noised and blurred but captured with high resolution.
      */
     getAllowDecreasedImage()
@@ -2051,7 +2071,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine to recognize decreased image as additional scan. Size for decreasing is selected by internal engine algorithms.
+     * Allows engine to recognize decreased image as additional scan. Size for decreasing is selected by internal engine algorithms.<br>
      * Mode helps to recognize barcodes which are noised and blurred but captured with high resolution.
      */
     setAllowDecreasedImage(value)
@@ -2093,7 +2113,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine for 1D barcodes to quickly recognize high quality barcodes which fill almost whole image.
+     * Allows engine for 1D barcodes to quickly recognize high quality barcodes which fill almost whole image.<br>
      * Mode helps to quickly recognize generated barcodes from Internet.
      */
     getAllowOneDFastBarcodesDetector()
@@ -2102,7 +2122,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine for 1D barcodes to quickly recognize high quality barcodes which fill almost whole image.
+     * Allows engine for 1D barcodes to quickly recognize high quality barcodes which fill almost whole image.<br>
      * Mode helps to quickly recognize generated barcodes from Internet.
      */
     setAllowOneDFastBarcodesDetector(value)
@@ -2140,7 +2160,7 @@ class QualitySettings extends joint.BaseJavaClass
 
     /**
      * Allows engine for Postal barcodes to recognize slightly noised images. Mode helps to recognize sligtly damaged Postal barcodes.
-       */
+     */
     getAllowMicroWhiteSpotsRemoving()
     {
         return this.getJavaClass().getAllowMicroWhiteSpotsRemovingSync();
@@ -2155,7 +2175,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine for 1D barcodes to quickly recognize middle slice of an image and return result without using any time-consuming algorithms.
+     * Allows engine for 1D barcodes to quickly recognize middle slice of an image and return result without using any time-consuming algorithms.<br>
      * @return Allows engine for 1D barcodes to quickly recognize high quality barcodes.
      */
     getFastScanOnly()
@@ -2164,7 +2184,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine for 1D barcodes to quickly recognize middle slice of an image and return result without using any time-consuming algorithms.
+     * Allows engine for 1D barcodes to quickly recognize middle slice of an image and return result without using any time-consuming algorithms.<br>
      * @param value Allows engine for 1D barcodes to quickly recognize high quality barcodes.
      */
     setFastScanOnly(value)
@@ -2198,14 +2218,14 @@ class QualitySettings extends joint.BaseJavaClass
 
     /**
      * Allows engine to use gap between scans to increase recognition speed. Mode can make recognition problems with low height barcodes.
-      */
+     */
     setAllowDetectScanGap(value)
     {
         this.getJavaClass().setAllowDetectScanGapSync(value);
     }
 
     /**
-     * Allows engine for Datamatrix to recognize dashed industrial Datamatrix barcodes.
+     * Allows engine for Datamatrix to recognize dashed industrial Datamatrix barcodes.<br>
      * Slow mode which helps only for dashed barcodes which consist from spots.
      */
     getAllowDatamatrixIndustrialBarcodes()
@@ -2214,7 +2234,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * Allows engine for Datamatrix to recognize dashed industrial Datamatrix barcodes.
+     * Allows engine for Datamatrix to recognize dashed industrial Datamatrix barcodes.<br>
      * Slow mode which helps only for dashed barcodes which consist from spots.
      */
     setAllowDatamatrixIndustrialBarcodes(value)
@@ -2224,7 +2244,7 @@ class QualitySettings extends joint.BaseJavaClass
 
     /**
      * Allows engine for QR/MicroQR to recognize damaged MicroQR barcodes.
-      */
+     */
     getAllowQRMicroQrRestoration()
     {
         return this.getJavaClass().getAllowQRMicroQrRestorationSync();
@@ -2272,7 +2292,7 @@ class QualitySettings extends joint.BaseJavaClass
     }
 
     /**
-     * apply all values from Src setting to this
+     * apply all values from Src setting to this<br>
      * @param Src source settings
      */
     applyAll(Src)
@@ -2355,7 +2375,7 @@ class Code128DataPortion extends joint.BaseJavaClass
     }
 
     /**
-     * Gets the type of Code128 subset
+     * Sets the type of Code128 subset
      *
      * @return The type of Code128 subset
      */
@@ -2473,7 +2493,7 @@ class AustraliaPostSettings extends joint.BaseJavaClass
     }
 
     /**
-     * Gets or sets the Interpreting Type for the Customer Information of AustralianPost BarCode.DEFAULT is CustomerInformationInterpretingType.OTHER.
+     * Gets the Interpreting Type for the Customer Information of AustralianPost BarCode.DEFAULT is CustomerInformationInterpretingType.OTHER.
      * @return The interpreting type (CTable, NTable or Other) of customer information for AustralianPost BarCode
      */
     getCustomerInformationInterpretingType()
@@ -2482,7 +2502,7 @@ class AustraliaPostSettings extends joint.BaseJavaClass
     }
 
     /**
-     * Gets or sets the Interpreting Type for the Customer Information of AustralianPost BarCode.DEFAULT is CustomerInformationInterpretingType.OTHER.
+     * Sets the Interpreting Type for the Customer Information of AustralianPost BarCode.DEFAULT is CustomerInformationInterpretingType.OTHER.<br>
      * @param value The interpreting type (CTable, NTable or Other) of customer information for AustralianPost BarCode
      */
     setCustomerInformationInterpretingType(value)
@@ -2491,7 +2511,7 @@ class AustraliaPostSettings extends joint.BaseJavaClass
     }
 
     /**
-     * The flag which force AustraliaPost decoder to ignore last filling patterns in Customer Information Field during decoding as CTable method.
+     * The flag which force AustraliaPost decoder to ignore last filling patterns in Customer Information Field during decoding as CTable method.<br>
      * CTable encoding method does not have any gaps in encoding table and sequnce "333" of filling paterns is decoded as letter "z".
      *
      * @example
@@ -2504,8 +2524,8 @@ class AustraliaPostSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().getAustraliaPost().setIgnoreEndingFillingPatternsForCTable(true);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log("BarCode Type: ".result.getCodeType());
-     *     console.log("BarCode CodeText: ".result.getCodeText());
+     *     console.log("BarCode Type: " + result.getCodeType());
+     *     console.log("BarCode CodeText: " + result.getCodeText());
      * });
      *
      * @return The flag which force AustraliaPost decoder to ignore last filling patterns during CTable method decoding
@@ -2515,12 +2535,35 @@ class AustraliaPostSettings extends joint.BaseJavaClass
         return this.getJavaClass().getIgnoreEndingFillingPatternsForCTableSync();
     }
 
+    /**
+     * The flag which force AustraliaPost decoder to ignore last filling patterns in Customer Information Field during decoding as CTable method.<br>
+     * CTable encoding method does not have any gaps in encoding table and sequnce "333" of filling paterns is decoded as letter "z".
+     *
+     * @example
+     *
+     * let generator = new BarcodeGenerator(EncodeTypes.AUSTRALIA_POST, "5912345678AB");
+     * generator.getParameters().getBarcode().getAustralianPost().setAustralianPostEncodingTable(CustomerInformationInterpretingType.C_TABLE);
+     * let image = generator.generateBarCodeImage(BarcodeImageFormat.PNG);
+     * let reader = new BarCodeReader(image, null, DecodeType.AUSTRALIA_POST);
+     * reader.getBarcodeSettings().getAustraliaPost().setCustomerInformationInterpretingType(CustomerInformationInterpretingType.C_TABLE);
+     * reader.getBarcodeSettings().getAustraliaPost().setIgnoreEndingFillingPatternsForCTable(true);
+     * reader.readBarCodes().forEach(function(result, i, results)
+     * {
+     *     console.log("BarCode Type: " + result.getCodeType());
+     *     console.log("BarCode CodeText: " + result.getCodeText());
+     * });
+     *
+     * @return The flag which force AustraliaPost decoder to ignore last filling patterns during CTable method decoding
+     */
     setIgnoreEndingFillingPatternsForCTable(value)
     {
         this.getJavaClass().setIgnoreEndingFillingPatternsForCTableSync(value);
     }
 }
 
+/**
+ * The main BarCode decoding parameters. Contains parameters which make influence on recognized data.
+ */
 class BarcodeSettings extends joint.BaseJavaClass
 {
 
@@ -2566,11 +2609,11 @@ class BarcodeSettings extends joint.BaseJavaClass
     }
 
     /**
-     * Enable checksum validation during recognition for 1D and Postal barcodes.
-     * Default is treated as Yes for symbologies which must contain checksum, as No where checksum only possible.
-     * Checksum never used: Codabar, PatchCode, Pharmacode, DataLogic2of5
-     * Checksum is possible: Code39 Standard/Extended, Standard2of5, Interleaved2of5, ItalianPost25, Matrix2of5, MSI, ItalianPost25, DeutschePostIdentcode, DeutschePostLeitcode, VIN
-     * Checksum always used: Rest symbologies
+     * Enable checksum validation during recognition for 1D and Postal barcodes.<br>
+     * Default is treated as Yes for symbologies which must contain checksum, as No where checksum only possible.<br>
+     * Checksum never used: Codabar, PatchCode, Pharmacode, DataLogic2of5<br>
+     * Checksum is possible: Code39 Standard/Extended, Standard2of5, Interleaved2of5, ItalianPost25, Matrix2of5, MSI, ItalianPost25, DeutschePostIdentcode, DeutschePostLeitcode, VIN<br>
+     * Checksum always used: Rest symbologies<br>
      *
      * @example
      *
@@ -2581,10 +2624,12 @@ class BarcodeSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().setChecksumValidation(ChecksumValidation.OFF);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *      console.log ("BarCode CodeText: ".result.getCodeText());
+     *      console.log ("BarCode CodeText: " + result.getCodeText());
      *      console.log ("BarCode Value: " + result.getExtended().getOneD().getValue());
      *      console.log ("BarCode Checksum: " + result.getExtended().getOneD().getCheckSum());
      * });
+     *
+     * @example
      * let reader = new BarCodeReader("c:/test.png", DecodeType.EAN_13);
      * //checksum enabled
      * reader.getBarcodeSettings().setChecksumValidation(ChecksumValidation.ON);
@@ -2602,11 +2647,11 @@ class BarcodeSettings extends joint.BaseJavaClass
     }
 
     /**
-     * Enable checksum validation during recognition for 1D and Postal barcodes.
-     * Default is treated as Yes for symbologies which must contain checksum, as No where checksum only possible.
-     * Checksum never used: Codabar, PatchCode, Pharmacode, DataLogic2of5
-     * Checksum is possible: Code39 Standard/Extended, Standard2of5, Interleaved2of5, ItalianPost25, Matrix2of5, MSI, ItalianPost25, DeutschePostIdentcode, DeutschePostLeitcode, VIN
-     * Checksum always used: Rest symbologies
+     * Enable checksum validation during recognition for 1D and Postal barcodes.<br>
+     * Default is treated as Yes for symbologies which must contain checksum, as No where checksum only possible.<br>
+     * Checksum never used: Codabar, PatchCode, Pharmacode, DataLogic2of5<br>
+     * Checksum is possible: Code39 Standard/Extended, Standard2of5, Interleaved2of5, ItalianPost25, Matrix2of5, MSI, ItalianPost25, DeutschePostIdentcode, DeutschePostLeitcode, VIN<br>
+     * Checksum always used: Rest symbologies<br>
      *
      * @example
      *
@@ -2617,10 +2662,12 @@ class BarcodeSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().setChecksumValidation(ChecksumValidation.OFF);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *      console.log ("BarCode CodeText: ".result.getCodeText());
+     *      console.log ("BarCode CodeText: " + result.getCodeText());
      *      console.log ("BarCode Value: " + result.getExtended().getOneD().getValue());
      *      console.log ("BarCode Checksum: " + result.getExtended().getOneD().getCheckSum());
      * });
+     *
+     * @example
      * let reader = new BarCodeReader("c:/test.png", DecodeType.EAN_13);
      * //checksum enabled
      * reader.getBarcodeSettings().setChecksumValidation(ChecksumValidation.ON);
@@ -2650,16 +2697,17 @@ class BarcodeSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().setStripFNC(false);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log ("BarCode CodeText: ".result.getCodeText());
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
      * });
      *
+     * @example
      * let reader = new BarCodeReader("c:/test.png", DecodeType.CODE_128);
      *
      * //StripFNC enabled
      * reader.getBarcodeSettings().setStripFNC(true);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log ("BarCode CodeText: ".result.getCodeText());
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
      * });
      *
      * @return Strip FNC1, FNC2, FNC3 characters from codetext. Default value is false.
@@ -2682,16 +2730,17 @@ class BarcodeSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().setStripFNC(false);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log ("BarCode CodeText: ".result.getCodeText());
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
      * });
      *
+     * @example
      * let reader = new BarCodeReader("c:/test.png", DecodeType.CODE_128);
      *
      * //StripFNC enabled
      * reader.getBarcodeSettings().setStripFNC(true);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log ("BarCode CodeText: ".result.getCodeText());
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
      * });
      *
      * @param value  Strip FNC1, FNC2, FNC3 characters from codetext. Default value is false.
@@ -2714,8 +2763,10 @@ class BarcodeSettings extends joint.BaseJavaClass
      * reader.getBarcodeSettings().setDetectEncoding(true);
      * reader.readBarCodes().forEach(function(result, i, results)
      * {
-     *     console.log ("BarCode CodeText: ".result.getCodeText());
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
      * });
+     *
+     * @example
      * //detect encoding is disabled
      * let reader = new BarCodeReader(im, DecodeType.QR);
      * reader.getBarcodeSettings().setDetectEncoding(false);
@@ -2729,6 +2780,31 @@ class BarcodeSettings extends joint.BaseJavaClass
         return this.getJavaClass().getDetectEncodingSync();
     }
 
+    /**
+     * The flag which force engine to detect codetext encoding for Unicode codesets. Default value is true.
+     *
+     * @example
+     *
+     * let generator = new BarcodeGenerator(EncodeTypes.QR, "Слово"))
+     * $im = generator.generateBarcodeImage(BarcodeImageFormat.PNG);
+     *
+     * //detects encoding for Unicode codesets is enabled
+     * let reader = new BarCodeReader(im, DecodeType.QR);
+     * reader.getBarcodeSettings().setDetectEncoding(true);
+     * reader.readBarCodes().forEach(function(result, i, results)
+     * {
+     *     console.log ("BarCode CodeText: " + result.getCodeText());
+     * });
+     *
+     * @example
+     * //detect encoding is disabled
+     * let reader = new BarCodeReader(im, DecodeType.QR);
+     * reader.getBarcodeSettings().setDetectEncoding(false);
+     * reader.readBarCodes().forEach(function(result, i, results)
+     * console.log ("BarCode CodeText: " + result.getCodeText());
+     *
+     * @return The flag which force engine to detect codetext encoding for Unicode codesets
+     */
     setDetectEncoding(value)
     {
         this.getJavaClass().setDetectEncodingSync(value);
@@ -2744,6 +2820,9 @@ class BarcodeSettings extends joint.BaseJavaClass
     }
 }
 
+/**
+ * Represents recognition abort exception which is thrown in timeout exceeding during recognition with BarCodeReader.
+ */
 class RecognitionAbortedException extends Error
 {
     javaClass;
@@ -2908,26 +2987,21 @@ class MaxiCodeExtendedParameters extends joint.BaseJavaClass
 /**
  * <p>
  * Stores special data of DotCode recognized barcode
- * </p><p><hr><blockquote><pre>
- * This sample shows how to get DotCode raw values
- * <pre>
+ * </p>
+ * This sample shows how to get DotCode raw values<br>
  *
+ * @example
  * let generator = new BarcodeGenerator(EncodeTypes.DOT_CODE, "12345");
- * {
- *     generator.save("c:\\test.png", BarCodeImageFormat.PNG);
- * }
+ * generator.save("c:\\test.png", BarCodeImageFormat.PNG);
+ *
  * let reader = new BarCodeReader("c:\\test.png", null, DecodeType.DOT_CODE);
+ * reader.readBarCodes().forEach(function(result, i, results)
  * {
- *     reader.readBarCodes().forEach(function(result, i, results)
- *     {
- *         print("BarCode type: " + result.getCodeTypeName());
- *         print("BarCode codetext: " + result.getCodeText());
- *         print("DotCode barcode ID: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodeId());
- *         print("DotCode barcodes count: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodesCount());
- *     });
- * }
- * </pre>
- * </pre></blockquote></hr></p>
+ *     print("BarCode type: " + result.getCodeTypeName());
+ *     print("BarCode codetext: " + result.getCodeText());
+ *     print("DotCode barcode ID: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodeId());
+ *     print("DotCode barcodes count: " + result.getExtended().getDotCode().getDotCodeStructuredAppendModeBarcodesCount());
+ * });
  */
 class DotCodeExtendedParameters extends joint.BaseJavaClass
 {
@@ -2999,6 +3073,7 @@ class DotCodeExtendedParameters extends joint.BaseJavaClass
 
 /**
  * Specify the type of barcode to read.
+ *
  * @example
  * //This sample shows how to detect Code39 and Code128 barcodes.
  * let reader = new BarCodeReader("test.png", null,  [ DecodeType.CODE_39_STANDARD, DecodeType.CODE_128 ]);
@@ -3011,7 +3086,7 @@ class DotCodeExtendedParameters extends joint.BaseJavaClass
  * @enum
  */
 DecodeType =
-{
+    {
         /**
          * Unspecified decode type.
          */
@@ -3428,6 +3503,16 @@ DecodeType =
          */
         HIBCQRPAS: 76,
 
+        /**
+         *  Specifies that the data should be decoded with <b>Han Xin Code</b> blank specification
+         */
+        HAN_XIN: 78,
+
+        /**
+         * Specifies that the data should be decoded with <b>Han Xin Code</b> blank specification
+         */
+        GS_1_HAN_XIN: 79,
+
         /**
          * Specifies that data will be checked with all of  1D  barcode symbologies
          */
@@ -3496,6 +3581,7 @@ DecodeType =
     };
 
 /**
+ * Contains types of Code128 subset
  * @enum
  */
 Code128SubType =
@@ -3562,7 +3648,7 @@ CustomerInformationInterpretingType =
         /**
          * Use C_TABLE to interpret the customer information. Allows A..Z, a..z, 1..9, space and # sing.
          *
-         * @code
+         * @example
          * let generator = new BarcodeGenerator(EncodeTypes.AUSTRALIA_POST, "5912345678ABCde");
          * generator.getParameters().getBarcode().getAustralianPost().setAustralianPostEncodingTable(CustomerInformationInterpretingType.C_TABLE);
          * let image = generator.generateBarcodeImage(BarcodeImageFormat.PNG);
@@ -3573,14 +3659,13 @@ CustomerInformationInterpretingType =
          *     console.log("BarCode Type: " + result.getCodeType());
          *     console.log("BarCode CodeText: " + result.getCodeText());
          * });
-         * @endcode
          */
         C_TABLE: 0,
 
         /**
          * Use N_TABLE to interpret the customer information. Allows digits.
          *
-         * @code
+         * @example
          *  let generator = new BarcodeGenerator(EncodeTypes.AUSTRALIA_POST, "59123456781234567");
          *  generator.getParameters().getBarcode().getAustralianPost().setAustralianPostEncodingTable(CustomerInformationInterpretingType.N_TABLE);
          *  let image = generator.generateBarcodeImage(BarcodeImageFormat.PNG);
@@ -3613,7 +3698,8 @@ CustomerInformationInterpretingType =
 
 /**
  * Contains recognition confidence level
- *@example
+ *
+ * @example
  * //This sample shows how BarCodeConfidence changed, depending on barcode type
  * //Moderate confidence
  * let generator = new BarcodeGenerator(EncodeTypes.CODE_128, "12345");
@@ -3626,6 +3712,8 @@ CustomerInformationInterpretingType =
  *    console.log("BarCode Confidence: " + result.getConfidence());
  *    console.log("BarCode ReadingQuality: " + result.getReadingQuality());
  * });
+ *
+ * @example
  * //Strong confidence
  * let generator = new BarcodeGenerator(EncodeTypes.QR, "12345");
  * generator.save("test.png");
@@ -3648,7 +3736,7 @@ BarCodeConfidence =
         NONE: 0,
 
         /**
-         * Recognition confidence of barcode (mostly 1D barcodes) with weak checksumm or even without it. Could contains some misrecognitions in codetext
+         * Recognition confidence of barcode (mostly 1D barcodes) with weak checksumm or even without it. Could contains some misrecognitions in codetext<br>
          * or even fake recognitions if  is low
          *
          * @see BarCodeResult.ReadingQuality