FaceCropThumb¶
Overview¶
FaceCropThumb is a Python package for generating thumbnails of detected faces in images. It utilizes the MTCNN (Multi-Task Cascaded Convolutional Neural Network) for accurate face detection and OpenCV for image processing.
Contents¶
Features¶
Detect faces in images using the MTCNN model
Crop detected faces with a configurable margin
Generate square thumbnails of detected faces
Option to resize the entire image if no face is detected or face detection is skipped
Command-line utility for easy usage
Quick Installation¶
You can install FaceCropThumb via pip:
pip install facecropthumb
Quick Usage¶
facecropthumb <image_path> [-d/--dir <output_directory>] [-m/--margin <margin_size>] [-F/--no-face] [-S/--skip-face] [-a/--all]
<image_path>
: Path to the input image file.-d/--dir <output_directory>
: Directory to store the output thumbnail. Default is the current directory.-m/--margin <margin_size>
: Margin around the detected face. Default is 50 pixels.-F/--no-face
: Skip face detection and resize the whole image if no face is detected.-S/--skip-face
: Skip face detection and resize the whole image.-a/--all
: Process all images in the specified directory. If no directory is provided, it processes images in the current directory.-v/--version
: Show installed version.-h/--help
: Show help.
Example:
facecropthumb input_image.jpg -d output_directory -m 30 -F
This command will generate a thumbnail of the detected face in
input_image.jpg
, with a margin of 30 pixels, and if no face is
detected, it will resize the whole image to a square of 74 x Y pixels
(~approx).
License¶
This project is licensed under the MIT License - see the LICENSE file for details.