IDcardsGenerator/README_ID_Card_Cropper.md

ID Card Cropper

Script đơn giản để cắt ID cards từ ảnh sử dụng Roboflow API.

Cách sử dụng

python id_card_cropper.py input_folder output_folder

Ví dụ:

# 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