Files
IDcardsGenerator/README_ID_Card_Cropper.md
Nguyễn Phước Thành a4e7573dca YOLO crop model
2025-08-05 20:21:47 +07:00

56 lines
1.3 KiB
Markdown

# ID Card Cropper
Script đơn giản để cắt ID cards từ ảnh sử dụng Roboflow API.
## Cách sử dụng
```bash
python id_card_cropper.py input_folder output_folder
```
### Ví dụ:
```bash
# Sử dụng API key mặc định
python id_card_cropper.py data/IDcards/Archive output/cropped_cards
# Sử dụng API key tùy chỉnh
python id_card_cropper.py data/IDcards/Archive output/cropped_cards --api-key YOUR_API_KEY
```
## Tham số
- `input_folder`: Thư mục chứa ảnh cần xử lý
- `output_folder`: Thư mục lưu ID cards đã cắt
- `--api-key`: API key Roboflow (mặc định: demo key)
## Hỗ trợ định dạng ảnh
- JPG/JPEG
- PNG
- BMP
- TIFF
## Kết quả
Script sẽ:
1. Tìm tất cả ảnh trong thư mục input
2. Phát hiện ID cards trong mỗi ảnh
3. Cắt và lưu ID cards vào thư mục output
4. Đặt tên file theo format: `{tên_ảnh_gốc}_card_{số}.jpg`
## Ví dụ kết quả
```
output/cropped_cards/
├── im1__card_1.jpg
├── im5_card_1.jpg
├── im11_card_1.jpg
└── im11_card_2.jpg
```
## Lưu ý
- Cần kết nối internet để sử dụng Roboflow API
- Có delay 1 giây giữa các request để tránh rate limiting
- Chỉ lưu ID cards đã cắt, không lưu ảnh gốc với bounding boxes