Face Detector
Detect faces and facial landmarks on PImage.
Quick Start
// create a Face Detection model
FaceDetector detector = new FaceDetector(this);
// load image
PImage img = loadImage("friends.jpg");
// detect pose
MLFace[] faces = detector.predict(img);Usage
Initialize
FaceDetector detector = new FaceDetector(this);Methods
.predict(PImage image)
Detect faces and 5 facial landmarks from a PImage and returns an array of MLFace object.
// load input image
PImage img = loadImage("friends.jpg");
// run face detection
MLFace[] faces = detector.predict(img);
// plot each facial landmark (keypoint) of the detected faces
for (int i = 0; i < faces.length; i++) {
// get each face
MLFace face = faces[i];
// draw bounding box
noFill();
stroke(240, 121, 81);
rect(face.getX(), face.getY(), face.getWidth(), face.getHeight());
// draw landmarks
noStroke();
fill(250, 255, 112);
for (int j = 0; j < face.getKeyPoints().size(); j++) {
MLKeyPoint keyPoint = face.getKeyPoints().get(j);
circle(keyPoint.getX(), keyPoint.getY(), 5);
}
}Parameters
- PImage image: (required) Image to run face detection on.
Returns
- MLFace[]: An array of MLFace. MLFace contains an ArrayList of 5 MLKeyPoint. Each keypoint represents the following facial landmarks in order:
1. left eye
2. right eye
3. nose
4. left mouth
5. right mouthRead more at MLFace for how to retrieve each facial landmark easily.