Merge branch 'main' into preview

DMGithubPublisher · web-flow · commit 12a7bf257f00 · 2025-04-21T02:44:56.000-07:00
diff --git a/_includes/sidelist-faq.html b/_includes/sidelist-faq.html
@@ -1,23 +1,29 @@
 <li>
-    <a href="{{ site.faq_general }}index.html" class="otherLinkColour">FAQ</a>
+    <a class="otherLinkColour">FAQ</a>
     <ul>
 
         <li>
             <a href="{{ site.faq_general }}general.html">General</a>
         </li>
         <li>
-            <a href="{{ site.faq_general }}license-usage.html">Licensing & Usage</a>
+            <a href="{{ site.faq_general }}license-usage.html">Dynamsoft Licensing & Usage</a>
         </li>
         <li>
-            <a href="{{ site.faq_general }}configuration.html">Configuration</a>
+            <a href="{{ site.faq_general }}configuration.html">Dynamsoft Barcode Reader Configuration</a>
 
         </li>
         <li>
-            <a href="{{ site.faq_general }}multi-platform.html">Multi Platform</a>
+            <a href="https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/faq/">Dynamsoft Barcode Reader for JS</a>
         </li>
 
         <li>
-            <a href="{{ site.faq_general }}error-debug.html">Error & Debug</a>
+            <a href="https://www.dynamsoft.com/barcode-reader/docs/mobile/programming/objectivec-swift/faq/">Dynamsoft Barcode Reader for iOS</a>
+        </li>
+        <li>
+            <a href="https://www.dynamsoft.com/barcode-reader/docs/mobile/programming/android/faq/">Dynamsoft Barcode Reader for Android</a>
+        </li>
+        <li>
+            <a href="https://www.dynamsoft.com/barcode-reader/docs/mobile/programming/maui/faq/">Dynamsoft Barcode Reader for MAUI</a>
         </li>
     </ul>
 </li>
diff --git a/faq/general/configuration.md b/faq/general/configuration.md
@@ -17,10 +17,10 @@ permalink: /faq/general/configuration.html
 
 3. [How to filter incorrect results with the barcode result length?](avoid-incorrect-results.html)
 
-4. [What will happen if licenses are not renewed in time?](what-happens-if-license-expires.html)
+4. [How to Handle Non-printable Characters Like "\u{1D}" or "{GS}" from the Barcode Text?](unprintable-character.html)
 
-5. [How to Handle Non-printable Characters Like "\u{1D}" or "{GS}" from the Barcode Text?](unprintable-character.html)
+5. [How to create custom settings template?](custom-settings-template.html)
 
-6. [How to create custom settings template?](custom-settings-template.html)
+6. [How can I sort the barcodes of my image in reading order?](sort-barcodes-image.html)
 
-7. [How can I sort the barcodes of my image in reading order?](sort-barcodes-image.html)
+7. [How to Scan EAN/UPC with Addon Codes?](how-to-scan-ean-upc-with-addon.md)
diff --git a/faq/general/custom-settings-template.md b/faq/general/custom-settings-template.md
@@ -11,7 +11,7 @@ permalink: /faq/general/custom-settings-template.html
 
 One of the strengths of the Dynamsoft Barcode Reader is its wide range of cuztomizable options that can optimize the performance of the SDK. Whether you are looking to prioritize read rate or speed, these settings can be used in many ways to match the targeted use case.
 
-If you are looking to create your own custom template of settings to use with the [InitSettingsFromFile][https://www.dynamsoft.com/capture-vision/docs/server/programming/cplusplus/api-reference/capture-vision-router/settings.html?product=dbr&repoType=server#initsettingsfromfile] methods, here are the steps:
+If you are looking to create your own custom template of settings to use with the [InitSettingsFromFile](https://www.dynamsoft.com/capture-vision/docs/server/programming/cplusplus/api-reference/capture-vision-router/settings.html?product=dbr&repoType=server#initsettingsfromfile) method, here are the steps:
 
 1. Visit the main [online demo](https://demo.dynamsoft.com/barcode-reader/).
 
@@ -23,6 +23,6 @@ If you are looking to create your own custom template of settings to use with th
 
 5. Copy the JSON code under *Template* and paste it into your own JSON file, or you can download the template JSON file straight from the demo.
 
-6. The template you downloaded is currently Barcode Reader version 9 template and the latest version is version 10. Use the [TemplateConverter Tool](https://download2.dynamsoft.com/dcv/TemplateConverter.zip) to convert the template to Barcode Reader version 10 compatible template.
+Note: If you have a JSON file that you previously used in version 9 and would like to keep using that, please note that the format needs to change to be useable in version 10.x of the SDK. Please use the [TemplateConverter Tool](https://download2.dynamsoft.com/dcv/TemplateConverter.zip) to convert the template to Barcode Reader version 10 compatible template.
 
-And with that, you have your own template to use with the `InitSettingsFromFile` method! 
+And with that, you have your own template to use with the `InitSettingsFromFile` method! 
diff --git a/faq/general/error-license-buffer.md b/faq/general/error-license-buffer.md
@@ -17,10 +17,25 @@ When initializing the license for cloud hosted services, it is common to come ac
 
 This error occurs when Dynamsoft sdk attempts to write the license file to the local usr/home directory or Home directory, but is unable to do so due to lack of permission to read or write the license file in that directory.
 
-To resolve this issue, please set the license file cache path to a directory that your program has read and write permissions for.
+To resolve this issue, please set the license file cache path to a directory that your program has read and write permissions for. Please place the code before license initializtion.
 
 
-Code snippet in C++
+C++
 ```C++
 static int SetLicenseCachePath(const char* directoryPath)
-```
+```
+Python
+```Python
+LicenseManager.set_license_cache_path("DIRECTORY-PATH-FOR-LICENSE-CACHE")
+```
+Java
+```Java
+BarcodeReader.setLicenseCachePath("DIRECTORY-PATH-FOR-LICENSE-CACHE");
+```
+.NET
+```.NET
+LicenseManager.SetLicenseCachePath("DIRECTORY-PATH-FOR-LICENSE-CACHE");
+```
+
+For more language, please refer to [this page](https://www.dynamsoft.com/barcode-reader/docs/core/). Select the language and then navigate to API Reference -> DynamsoftLicense -> LicenseManager
+
diff --git a/faq/general/general.md b/faq/general/general.md
@@ -22,5 +22,3 @@ permalink: /faq/general/general.html
 5. [How to scan specific pages of a pdf file?](scan-specific-page.html)
 
 6. [How to scan barcodes on US Driver's Licenses and extract the information?](scan-us-drivers-license.html)
-
-7. [How does your SDK compare to other commercial SDKs?](competitors-comparison.html)
diff --git a/faq/general/how-to-scan-ean-upc-with-addon.md b/faq/general/how-to-scan-ean-upc-with-addon.md
@@ -0,0 +1,83 @@
+---
+layout: default-layout
+title: How to Scan EAN/UPC with Addon Codes?
+keywords: Dynamsoft Barcode Reader, FAQ, tech basic, EAN-2, EAN-5, UPC–A, Add-On, supplement
+description: How to Scan EAN/UPC with Addon Codes?
+needAutoGenerateSidebar: false
+permalink: /faq/general/how-to-scan-ean-upc-with-addon.html
+---
+
+# How to Scan EAN/UPC with Addon Codes?
+
+[<< Back to FAQ index](index.md)
+
+UPC and EAN are barcode formats commonly used for product identification. These formats can include supplemental 2-digit or 5-digit barcodes (known as AddOn Codes), typically found on the right side of the main barcode. These AddOn Codes are often used for magazines, books, or other products to encode additional information like pricing or issue numbers.
+
+Dynamsoft Barcode Reader (DBR) does not enable reading such AddOn Codes by default.
+
+![EAN-13 + EAN-5 on a book](https://www.dynamsoft.com/codepool/img/2024/10/add-on/ean_13.jpg)
+![UPC-E + UPC-2 on a magazine](https://www.dynamsoft.com/codepool/img/2024/10/add-on/upc_e.jpg)
+
+To enable AddOn Code scanning, the property `EnableAddOnCode` in the `BarcodeFormatSpecificationOptions` array must be set to 1.
+
+If you want to limit the Dynamsoft Barcode Reader to only decode UPC and EAN codes with AddOn Codes, consider the following additional configurations:
+1. **Regular Expression Filtering:** Use `BarcodeTextRegExPattern` to exclude results without AddOn Codes.
+2. **Barcode Format Restriction:** Restrict the barcode formats to EAN and UPC only by setting `BarcodeFormatIds`.
+
+### Using JSON Templates
+
+Modify all of the `EnableAddOnCode` property in your template file by setting its value to `1`:
+```json
+{
+    "BarcodeFormatSpecificationOptions": 
+    [
+        {
+            "EnableAddOnCode": 1, // Enable AddOn Codes
+            "Name": "bfs1",
+            // (OPTIONAL) Apply Regular Expression Filtering
+            // Exclude All Other Results Without Addon Codes
+            "BarcodeTextRegExPattern" : "\\d+-\\d+",
+			...
+        },
+		...
+    ],
+    "BarcodeReaderTaskSettingOptions" : 
+    [
+      { // (OPTIONAL) Restrict Formats to EAN and UPC Only
+        "BarcodeFormatIds" : 
+        [ "BF_EAN_8", "BF_EAN_13", "BF_UPC_A", "BF_UPC_E" ],
+      }
+    ],
+	...
+}
+```
+
+### Using JavaScript Code
+
+```javascript
+let settings = await cvRouter.outputSettings(); // Retrieve the runtime settings
+let formatOptionsArray = settings.BarcodeFormatSpecificationOptions;
+for (let index = 0; index < formatOptionsArray.length; index++) {
+  const options = formatOptionsArray[index];
+  // Enable AddOn Codes
+  options["EnableAddOnCode"] = 1;
+  // (OPTIONAL) Apply Regular Expression Filtering
+  // Exclude Results Without AddOn Codes
+  options["BarcodeTextRegExPattern"] = "\\d+-\\d+";
+}
+
+// -------------------- (OPTIONAL) -------------------------------------------
+// Restrict Expected Barcode Formats to EAN and UPC Only
+let barcodeOptionsArray = settings.BarcodeReaderTaskSettingOptions;
+for (let index = 0; index < barcodeOptionsArray.length; index++) {
+  const options = barcodeOptionsArray[index];
+  options["BarcodeFormatIds"] = ["BF_EAN_8", "BF_EAN_13", "BF_UPC_A", "BF_UPC_E"];
+}
+// ---------------------------------------------------------------------------
+
+await cvRouter.initSettings(settings); // Apply the modified settings
+```
+
+### Sample Code
+
+You may also find it helpful to explore our [blog post on scanning EAN/UPC and AddOn codes with JavaScript](https://www.dynamsoft.com/codepool/scan-ean-upc-and-its-add-on-javascript.html).
diff --git a/faq/general/index.md b/faq/general/index.md
@@ -41,6 +41,8 @@ permalink: /faq/general/index.html
 
 7. [How can I sort the barcodes of my image in reading order?](sort-barcodes-image.md)
 
+8. [How to Scan EAN/UPC with Addon Codes?](how-to-scan-ean-upc-with-addon.md)
+
 ## [License & Usage](license-usage.md)
 
 1. [Can the SDK work without internet connection?](sdk-works-without-internet.md)
diff --git a/faq/general/license-usage.md b/faq/general/license-usage.md
@@ -28,3 +28,5 @@ permalink: /faq/general/license-usage.html
 8. [How does license tracking work with the three standard licensing options - Per Scan, Per Device, Per Concurrent Device?](how-license-tracking-works.html)
 
 9. [When is a new license spot taken when using a per-device licensing model?](new-license-required-per-device-licensing.html)
+
+10. [What will happen if licenses are not renewed in time?](what-happens-if-license-expires.html)
diff --git a/programming/features/barcode-scan-region.md b/programming/features/barcode-scan-region.md
@@ -33,6 +33,18 @@ settings.roi.points[2] = {x:90, y:90};
 settings.roi.points[3] = {x:10, y:90};
 // Update the settings to a specific template.
 await router.updateSettings("ReadSingleBarcode", settings);
+//============================================================
+// Alternatively, you can set the scan region directly at the image source in a simpler way.
+// If you’re using Dynamsoft Camera Enhancer, the following example demonstrates 
+// how to specify a single scan region without modifying the template.
+let cameraEnhancer = await Dynamsoft.DCE.CameraEnhancer.createInstance();
+cameraEnhancer.setScanRegion({
+  x: 10,
+  y: 10,
+  width: 80,
+  height: 80,
+  isMeasuredInPercentage: true,
+});
 ```
 >
 ```c++
diff --git a/programming/features/use-runtimesettings-or-templates.md b/programming/features/use-runtimesettings-or-templates.md
@@ -139,7 +139,7 @@ Basic steps:
 
 1. Build a JSON template and configure the required parameters
 2. Save the template to a file or convert it to string
-3. Call method `InitSettingsFromFile` or `InitSettings` to apply the settings
+3. Call method `InitSettingsFromFile` (or `InitSettings` if you are using the JavaScript edition) to apply the settings
 
 > Read [Parameter Template Structure]({{ site.parameters }}structure-and-interfaces-of-parameters.html) to learn more about the structure of templates.
 
@@ -173,7 +173,7 @@ The following steps demonstrates how to specify barcode formats via `JSON Templa
 
   * Save the above template to file `setting.json` or Convert the above content into a string format for the respective programming language.
 
-  * Call method `InitSettingsFromFile` or `InitSettings` to apply the settings
+  * Call method `InitSettingsFromFile` (or `InitSettings` if you are using the JavaScript edition) to apply the settings
 
     <div class="sample-code-prefix template2"></div>
        >- JavaScript
