Merge pull request #62 from RachyJ/main

Update README.md

Author: Tom-Dynamsoft

4.use-case/README.md

@@ -1,23 +1,26 @@
 # Use Case Sample Set
 
-This sample set explores some of the most popular real world applications of the `DBR` library that our team has encountered throughout our many years of experience.
+This sample set explores some of the most popular real world applications of Dynamsoft's barcode reader library:
 
-## Filling a Form Field with the Barcode Scanner
+- [fill a form with barcode reading](./1.fill-a-form-with-barcode-reading.html)
+- [read driver license](./2.read-a-drivers-license.html)
 
-The first sample will  demonstrate how to implement one of, if not the most common usage scenario our library encounters: Filling a form or form field based on the barcode result.
+## Filling a Form using Barcode Scanner
 
-Usually this scenario involves oopening the video scanner on the click of a button, and then once the barcode is scanned, the barcode result would show up in a corresponding form field. In some cases, the form field would come with a tooltip style of button to allow the user to open the scanner on the click of that icon.
+The first sample demonstrates how to automatically fill out a form using barcode scanning.
 
-## Filling out Driver's License Info via the Barcode Scanner
+Users can click a button to read barcodes from a video, and once a barcode is scanned, the barcode result will be filled to the corresponding form field. You can customize it further to show a tooltip-style button for users to click and open the scanner.
 
-Another very popular scenario is extracting the driver license info that is encoded on the back of driver licenses into a readable text. The text that is normally encoded in the barcode comes as one large string, separated by abbreviations only. The string will in turn require parsing and mapping to have all the info in its corresponding fields.
+## Filling Out Driver's License Info via Barcode Scanner
 
-In order to ensure that the scanner picks up only PDF417 barcode types, we first ensure that the `barcodeFormatIds` of the `RuntimeSettings` is set to `BF_PDF417`. This way, the scanner is better configured to pick up the driver license barcodes.
+Another popular usage scenario is to scan the barcodes on driver licenses for automatic ID data extraction. 
 
-The core text extraction happens in the function `extractInformation`. Please pay special attention to the `driverLicenseFields` variable, which contains all the mapping defintions for the different abbreviations.
+With the barcode reader library, you can get a large text string from the driver license PDF417 barcode. You can then parse the string and get the value of corresponding fields.
 
-By following a similar extraction and mapping mechanism, you can easily implement this feature in your own web application.
+In this use case, we want the scanner to pick up PDF417 barcode only, so we set `barcodeFormatIds` in `RuntimeSettings` to `BF_PDF417`. 
+
+The core information extraction happens in the function `extractResultAlert()`, in which we are using the SDK **Dynamsoft Code Parser** to parse the raw string and get the actual encoded information.
 
 ## Support
 
-If you have any questions, feel free to contact Dynamsoft support via [email](mailto:support@dynamsoft.com) or [live chat](https://www.dynamsoft.com/barcode-reader/overview/) via the "Let's Chat" button.
+If you have any questions, feel free to [contact Dynamsoft](https://www.dynamsoft.com/company/contact/).

README.md

@@ -1,53 +1,61 @@
 # Dynamsoft Barcode Reader samples for the web
 
-This repository contains multiple samples that demonstrates how to use the [Dynamsoft Barcode Reader JavaScript Edition](https://www.dynamsoft.com/barcode-reader/sdk-javascript/).
+This repository contains multiple samples that demonstrates how to use the [Dynamsoft Barcode Reader JavaScript Edition](https://www.dynamsoft.com/barcode-reader/sdk-javascript/?utm_source=sampleReadme) for creating web-based barcode scanning applications.
 
-## Hello World
+## Request a trial license
+
+A default license is included which allows you to test the sample apps for up to 24 hours. You can [request a trial license](https://www.dynamsoft.com/customer/license/trialLicense?product=dbr&package=js&utm_source=sampleReadme) via Dynamsoft customer portal to evaluate further.
+
+## Documentation
+
+For the developer guide and full API reference of Dynamsoft Barcode Reader JavaScript library, please check out the [documentation](https://www.dynamsoft.com/barcode-reader/programming/javascript/?ver=latest&utm_source=sampleReadme).
+
+## Support
+
+If you have any questions, feel free to [contact Dynamsoft support](https://www.dynamsoft.com/company/contact?utm_source=sampleReadme).
+
+## Sample list
+
+### Hello World
 
 Get the basic features of the library working with plain/native JavaScript or within a framework like [Angular](https://angular.io/), [React](https://reactjs.org/) or [Vue](https://vuejs.org/), etc.
 
-* **Hello World**: Minimum necessary JavaScript code to get the BarcodeScanner (video) up and running.
-* **Read an Existing Image**: Decode barcodes using images that are stored locally, whether on mobile or desktop.
-* **Hello World in Angular**: Decode video stream in an Angular Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in React**: Decode video stream in a React Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in Vue 2**: Decode video stream in a Vue 2 Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in Vue 3**: Decode video stream in a Vue 3 Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in Next.js**: Decode video stream in a Next.js Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in Nuxt**: Decode video stream in a Nuxt Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World in Electron**: Decode video stream in a Electron Application from a USB-connected or built-in camera (desktop only).
-* **Hello World in PWA**: Decode video stream in a PWA Application from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World with RequireJS**: Decode video stream in a simple Application using RequireJS from a USB-connected or built-in camera (mobile or desktop).
-* **Hello World with ES6**: Decode video stream in a simple Application using ES6 from a USB-connected or built-in camera (mobile or desktop).
-
-## Customize Camera UI
+* **Hello World**: Scan barcodes from video stream with minimum code in JavaScript.
+* **Read an Existing Image**: Decode barcodes from existing images that are stored locally, whether on mobile or desktop.
+* **Hello World in Angular**: Decode video stream in an Angular application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in React**: Decode video stream in a React application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in Vue 2**: Decode video stream in a Vue 2 application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in Vue 3**: Decode video stream in a Vue 3 application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in Next.js**: Decode video stream in a Next.js application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in Nuxt**: Decode video stream in a Nuxt application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World in Electron**: Decode video stream in a Electron application from a USB-connected or built-in camera (desktop only).
+* **Hello World in PWA**: Decode video stream in a PWA application from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World with RequireJS**: Decode video stream in an application using RequireJS from a USB-connected or built-in camera (mobile or desktop).
+* **Hello World with ES6**: Decode video stream in an application using ES6 from a USB-connected or built-in camera (mobile or desktop).
+
+### Customize Camera UI
 
 * **Use the Default Camera UI**: Show the default camera UI to decode video stream from a USB-connected or built-in camera (mobile or desktop).
 * **Hide Display Controls**: Hide built-in UI elements (camera selection, resolution selection, etc.) and show only the video stream.
 * **Set up External Controls**: Use custom controllers to manipulate the Camera UI.
 * **Changing Size of Video Viewer**: Enlarge the video stream temporarily to read a barcode.
 * **Customize the Camera UI**: Show the custom camera UI to decode video stream from a USB-connected or built-in camera (mobile or desktop).
 
-## Parameter Settings
+### Parameter Settings
 
-How to configure different settings of the library.
+How to configure different settings of the barcode scanning library.
 
 * **Formats and Count**: Set the barcode formats and control the number of barcodes to read per image/frame.
 * **Localization and Binarization**: Set how localization and binarization are done during barcode decoding.
-* **Blurry or Small codes**: Set DeblurModes and ScaleUpModes for decoding blurry or small barcodes.
-* **Deformed or Incomplete codes**: Set DeformationResistingModes or BarcodeComplementModes for decoding deformed or incomplete barcodes.
-* **Define or Detect the Region**: Set the region of interest manually or regionPredetectionModes to speed up the reading process.
-
-## Use Case
+* **Blurry or Small codes**: Set `DeblurModes` and `ScaleUpModes` for decoding blurry or small barcodes.
+* **Deformed or Incomplete codes**: Set `DeformationResistingModes` or `BarcodeComplementModes` for decoding deformed or incomplete barcodes.
+* **Define or Detect the Region**: Set the region of interest manually or `regionPredetectionModes` to speed up the barcode reading process.
 
-Use cases of the library.
+### Use Cases
 
 * **Read Video and Fill a Form**: Read barcodes to fill a form.
 * **Read a Driver's License**: Read the PDF417 barcode on a driver's license (AAMVA compliant) and parse it.
 
-## Others
+### Others
 
 * **Debug**: Collect the actual image frames for debugging purposes.
-
-## Support
-
-If you have any questions, feel free to contact Dynamsoft support via [email](mailto:support@dynamsoft.com) or [live chat](https://www.dynamsoft.com/barcode-reader/overview/) via the "Let's Chat" button.