Skip to content

Commit 7ca1f7d

Browse files
committed
Add a PDF reading example
1 parent 4fa4a21 commit 7ca1f7d

File tree

6 files changed

+1848
-0
lines changed

6 files changed

+1848
-0
lines changed

examples/official/pdf/README.md

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
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+

examples/official/pdf/barcode.jpg

129 KB
Loading

examples/official/pdf/barcodes.pdf

642 KB
Binary file not shown.

0 commit comments

Comments
 (0)