Description
This plugin is a face detector which is able to detect faces in an image (see papillon::PFrame).
The algorithm accepts every pixel formats available in Papillon (see papillon::PImage::EPixelFormat).
Smallest faces that can be detected are about 20x20 pixels.
This face detector has also an option to enable feature points localisation (try to find 16 key points on the face), which is required for Face Recognition.
Important Note: for Face Recognition applications you should favor FaceDetector2 instead.
FaceDetector2 cannot detect faces smaller than 40x40 pixels, but is faster and can detect up to 68 feature points which is a key advantages for Face Recognition.
For Face Recognition applications:
For best results, you should favor faces with at least 80x80 pixels (about 50 pixels between the eyes).
Note about Feature Points:
This face detector computes a confidence score in [0..1] for each feature points; on the following picture, features points with a good enough score appear in green, points with lower scores are in red.

This plugin creates a PDetector object.
- Plugin: PPluginDetectorFace
- Product name: FaceDetector
- Version: 1.0
How to create a face detector from this plugin?
Parameters
To configure this detector you have 3 options:
- Use PProperties container argument in the PDetector::Create() factory
- Use PDetector specific methods, e.g. PDetector::EnableLocaliser() or PDetector::SetMinDetectionSize(), see PDetector documentation to learn more.
- Use PDetector generic PDetector::Set() and PDetector::Get() using PDetector::C_PARAM_XXX strings.
Parameter | Description |
---|---|
MinDetectionSize | Minimum detection size in pixels (minimum and default is 20x20). Faces that are smaller than this size won't be detected. Note that it takes more time to detect small faces. |
MaxDetectionSize | Maximum detection size in pixels (default is 2000x2000). Faces that are greater than this size won't be detected. |
MaxDetections | Maximum number of detected faces in an image (keep only the N largest faces). |
RegionOfInterest (ROI) | Detection area in the image (in pixels): the analysed image is cropped to this specified rectangle before applying the face detector. |
Localiser | Enable/disable feature points localisation: you can use PDetector::EnableLocaliser(). Disabled by default. These points are required for Face Recognition. |