Add tesseract OCR sample

Author: yushulx

examples/official/tesseract/README.md

@@ -0,0 +1,53 @@
+# OCR-Enhanced Barcode Validation 
+
+This project demonstrates how to use **Tesseract OCR** as a complementary technology to enhance barcode reading accuracy, especially when dealing with damaged or low-quality barcode images.
+
+
+## Features
+
+- **Dual Recognition**: Attempts barcode scanning first, falls back to OCR if needed
+- **Multiple Format Support**: Handles various 1D barcode formats (Codabar, Code 128, etc.)
+- **Damage Resilience**: Extracts text from damaged or low-quality barcode images
+- **Detailed Output**: Provides barcode location coordinates and format information
+- **Digit Extraction**: Filters OCR results to extract only numeric characters
+
+## Prerequisites
+- Obtain a [30-day free trial license](https://www.dynamsoft.com/customer/license/trialLicense/?product=dcv&package=cross-platform) for Dynamsoft Barcode Reader.
+- Python 3.6 or higher
+- Tesseract OCR installation
+  - Windows: Install [Tesseract](https://github.com/UB-Mannheim/tesseract/wiki)
+  - macOS:
+   
+        ```bash
+        brew install tesseract
+        ```
+  
+  - Linux: 
+       ```bash
+        sudo apt update
+        sudo apt install tesseract-ocr -y
+        sudo apt install libtesseract-dev -y
+        ```
+
+- Python dependencies
+    
+    ```bash
+    pip install dynamsoft-capture-vision-bundle pytesseract pillow
+    ```
+
+## Quick Start
+1. Set the license key in `app.py`:
+   ```python
+   error_code, error_message = LicenseManager.init_license("YOUR_LICENSE_KEY_HERE")
+   ```
+
+2. Run the application:
+   ```bash
+   python app.py
+   ```
+
+## Sample Images
+The project includes two test images:
+- `codabar.jpg` - A clear Codabar barcode image
+- `damaged.png` - A damaged barcode image to demonstrate OCR fallback
+

examples/official/tesseract/app.py

@@ -0,0 +1,76 @@
+from PIL import Image
+import pytesseract
+import os
+import sys
+from dynamsoft_capture_vision_bundle import LicenseManager, EnumErrorCode, CaptureVisionRouter, EnumPresetTemplate
+def main():
+
+    print("**********************************************************")
+    print("Welcome to Dynamsoft Barcode Reader")
+    print("**********************************************************")
+
+    error_code, error_message = LicenseManager.init_license(
+        "DLS2eyJoYW5kc2hha2VDb2RlIjoiMjAwMDAxLTE2NDk4Mjk3OTI2MzUiLCJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSIsInNlc3Npb25QYXNzd29yZCI6IndTcGR6Vm05WDJrcEQ5YUoifQ==")
+    if error_code != EnumErrorCode.EC_OK and error_code != EnumErrorCode.EC_LICENSE_CACHE_USED:
+        print("License initialization failed: ErrorCode:",
+              error_code, ", ErrorString:", error_message)
+    else:
+        cvr_instance = CaptureVisionRouter()
+        while (True):
+            image_path = input(
+                ">> Input your image full path:\n"
+                ">> 'Enter' for sample image or 'Q'/'q' to quit\n"
+            ).strip('\'"')
+
+            if image_path.lower() == "q":
+                sys.exit(0)
+
+            if image_path == "":
+                image_path = "codabar.jpg"
+
+            if not os.path.exists(image_path):
+                print("The image path does not exist.")
+                continue
+            result = cvr_instance.capture(
+                image_path, EnumPresetTemplate.PT_READ_BARCODES.value)
+            if result.get_error_code() != EnumErrorCode.EC_OK:
+                print("Error:", result.get_error_code(),
+                      result.get_error_string())
+            else:
+            
+                items = result.get_items()
+                print('Found {} barcodes.'.format(len(items)))
+                for item in items:
+                    format_type = item.get_format_string()
+                    text = item.get_text()
+                    print("Barcode Format:", format_type)
+                    print("Barcode Text:", text)
+
+                    location = item.get_location()
+                    x1 = location.points[0].x
+                    y1 = location.points[0].y
+                    x2 = location.points[1].x
+                    y2 = location.points[1].y
+                    x3 = location.points[2].x
+                    y3 = location.points[2].y
+                    x4 = location.points[3].x
+                    y4 = location.points[3].y
+                    print("Location Points:")
+                    print("({}, {})".format(x1, y1))
+                    print("({}, {})".format(x2, y2))
+                    print("({}, {})".format(x3, y3))
+                    print("({}, {})".format(x4, y4))
+                    print("-------------------------------------------------")
+
+
+            ## Inovke Tesseract OCR
+            result = pytesseract.image_to_string(Image.open(image_path))
+            digits = ''
+            for i in result:
+                if ord(i) >= 48 and ord(i) <= 57:
+                    digits += i
+
+            print(f'OCR Result: {digits}')
+
+if __name__ == "__main__":
+    main()