leblancfg/autocrop

📸 Automatically detects and crops faces from batches of pictures.

What it solves

Autocrop 是一個設計用來自動化裁切圖像以聚焦臉部的工具。它透過自動偵測圖像中最大的臉部並將裁切中心對準該臉部，省去手動裁切個人頭像或身分證照片的繁瑣工作。

How it works

此工具使用 OpenCV 的 YuNet 神經網路臉部偵測器（具體為 face_detection_yunet_2023mar.onnx 模型）來定位圖像中的臉部。它可以作為 Python API 或命令列介面（CLI）使用，允許使用者指定輸出尺寸、縮放選項，以及臉部在圖像高度中所佔的百分比。

Who it’s for

此工具適用於需要批次處理網站、身分證或其他需要以臉部為中心裁切的應用程式的開發者與系統管理員。

Highlights

  • 擁有 CLI 與 Python API，彈性整合。
  • 支援多種輸入與輸出圖像格式。
  • 透過捆綁 YuNet 偵測模型，離線即可運作。
  • 可與 find、xargs、parallel 等 shell 工具組合，進行大批量批次處理。
  • 支援透過 ffmpeg 從影片檔案中擷取的影格處理。