|
| 1 | +# Dynamsoft Barcode Reader - Enhanced GUI Application |
| 2 | + |
| 3 | +A modern, feature-rich GUI application for barcode detection and reading using the Dynamsoft Capture Vision SDK. This application provides a comprehensive graphical interface for processing images and PDF files with professional barcode detection capabilities. |
| 4 | + |
| 5 | +## 🚀 Features |
| 6 | + |
| 7 | +### Core Functionality |
| 8 | +- **Multi-format Support**: JPG, PNG, BMP, TIFF, WEBP image files |
| 9 | +- **Native PDF Support**: Multi-page PDF processing using Dynamsoft SDK (no external dependencies) |
| 10 | +- **Real-time Detection**: Fast barcode detection with visual annotations |
| 11 | +- **Multi-page Navigation**: Easy navigation through PDF pages |
| 12 | + |
| 13 | +### User Interface |
| 14 | +- **Modern GUI**: Clean, intuitive interface with professional styling |
| 15 | +- **Zoom & Pan**: Interactive image viewing with zoom controls (10%-500%) |
| 16 | +- **Beautiful Results Display**: Color-coded results with background highlights |
| 17 | +- **Drag & Drop**: Enhanced file loading support |
| 18 | +- **Professional Layout**: Organized panels with clear visual hierarchy |
| 19 | + |
| 20 | +### Results Management |
| 21 | +- **Beautiful Formatting**: Enhanced result display with emojis, colors, and professional styling |
| 22 | +- **Detailed Results**: Format, content, location with corner labels (TL, TR, BR, BL) |
| 23 | +- **Smart Area Display**: Area calculations with K-unit formatting for large values |
| 24 | +- **Export Options**: Export to TXT, CSV, or JSON formats |
| 25 | +- **Clipboard Support**: Quick copy results to clipboard |
| 26 | +- **Multi-page Results**: Organize results by page for PDF files |
| 27 | + |
| 28 | +### Processing Options |
| 29 | +- **Auto-processing**: Automatically detect barcodes when files are loaded |
| 30 | +- **Confidence Display**: Optional confidence scores for each detection |
| 31 | +- **Progress Tracking**: Real-time processing status and timing |
| 32 | +- **Memory Monitoring**: Optional memory usage display |
| 33 | + |
| 34 | +## 📋 Requirements |
| 35 | + |
| 36 | +- Required Dependencies |
| 37 | + |
| 38 | + ```bash |
| 39 | + pip install dynamsoft-capture-vision-bundle opencv-python Pillow tkinterdnd2 psutil |
| 40 | + ``` |
| 41 | + |
| 42 | +- [30-day trial license](https://www.dynamsoft.com/customer/license/trialLicense/?product=dcv&package=cross-platform) |
| 43 | + |
| 44 | +## 🎯 Quick Start |
| 45 | + |
| 46 | +### Run the Enhanced GUI |
| 47 | +```bash |
| 48 | +python gui_barcode_reader_enhanced.py |
| 49 | +``` |
| 50 | +### Alternative: Command Line Interface |
| 51 | +```bash |
| 52 | +python command_line.py |
| 53 | +``` |
| 54 | + |
| 55 | +## 📁 File Structure |
| 56 | + |
| 57 | +``` |
| 58 | +📂 project/ |
| 59 | +├── 📄 command_line.py # Command-line interface |
| 60 | +├── 🖥️ gui_barcode_reader_enhanced.py # Enhanced GUI application |
| 61 | +├── requirements.txt # Dependencies list |
| 62 | +├── 📖 README.md # This documentation |
| 63 | +└── 🎯 Sample files (barcode.jpg, barcodes.pdf) |
| 64 | +``` |
| 65 | +
|
| 66 | +## 🔧 Usage Guide |
| 67 | +
|
| 68 | +### Loading Files |
| 69 | +1. **Click "📂 Load File"** button to browse for files |
| 70 | +2. **Drag and drop** files directly onto the image area (enhanced support) |
| 71 | +3. Supported formats: JPG, PNG, BMP, TIFF, WEBP, PDF (native support) |
| 72 | +
|
| 73 | +### Navigation (PDF Files) |
| 74 | +- Use **◀ Prev/Next ▶** buttons for page navigation |
| 75 | +- **Go to page** field for direct page jumping |
| 76 | +- Page counter shows current position (e.g., "Page: 2/5") |
| 77 | +
|
| 78 | +### Image Controls |
| 79 | +- **Zoom dropdown**: Select zoom level (10%-500% or Fit) |
| 80 | +- **Zoom buttons**: Quick zoom in/out (🔍+ / 🔍-) |
| 81 | +- **Reset button**: Return to fit-to-window view (↻) |
| 82 | +- **Mouse wheel**: Zoom with Ctrl+scroll |
| 83 | +
|
| 84 | +### Processing |
| 85 | +- **Auto-process**: Automatically detect barcodes when loading files |
| 86 | +- **🔍 Detect Barcodes**: Manual processing trigger |
| 87 | +- **Show confidence**: Toggle confidence scores display |
| 88 | +
|
| 89 | +### Results Display |
| 90 | +- **Beautiful Formatting**: Color-coded results with professional styling |
| 91 | +- **Corner Labels**: Location points shown as TL→TR→BR→BL format |
| 92 | +- **Smart Units**: Area display with K-units for large values |
| 93 | +- **Export**: Save results to TXT, CSV, or JSON files |
| 94 | +- **Copy**: Quick copy to clipboard |
| 95 | +- **Page Summary**: Shows barcode count per page |
| 96 | +
|
| 97 | +
|
| 98 | +
|
0 commit comments