faced is a light-weight library for face recognition including features such as eyes, nose and mouth. It requires opencv.
Face is outlined in black, the eyes are red & green for left and right respectively, the nose is outlined in white and the mouth in blue.
Make sure you have OpenCV installed on your machine.
For MacOS X you can use Homebrew
$ brew tap homebrew/science
$ brew install opencv
Just add "faced": "1.x",
to your dependencies list in package.json
.
npm install -g faced
var faced = new Faced();
faced.detect('image.jpg', function (faces, image, file) {
if (!faces) {
return console.log("No faces found!");
}
var face = sface[0];
console.log(
"Found a face at %d,%d with dimensions %dx%d",
face.getX(),
face.getY(),
face.getWidth(),
face.getHeight()
);
console.log(
"What a pretty face, it %s a mouth, it %s a nose, it % a left eye and it %s a right eye!",
face.getMouth() ? "has" : "does not have",
face.getNose() ? "has" : "does not have",
face.getEyeLeft() ? "has" : "does not have",
face.getEyeRight() ? "has" : "does not have",
);
});
Its that simple! See the program used to generate the above image
Loads an image from source
which can be a file path or a buffer and executes function
upon completion.
The callback function expects a prototype like function (faces, image, file) { }
, where the first is an array of Face
, the second is a Matrix
object from opencv and the third is the path of the image.
In case of error the arguments faces
and image
will be undefined
.
Feature.getX()
Returns the upper left corner X position of the faceFeature.getY()
Returns the upper left corner Y position of the faceFeature.getX2()
Returns the lower right corner X position of the faceFeature.getY2()
Returns the lower right conrner Y position of the faceFeature.getWidth()
Returns the widthFeature.getHeight()
Returns the heightFeature.intersect(Feature)
Returns the percentage of shared spaced that the current feature has with the given argument Feature. Although this is used internally it might be useful for client usage.
All of the following method1s return an instance of Feture
or undefined
if it could not detect.
Face.getMouth()
Face.getNose()
Face.getEyeLeft()
Face.getEyeRight()
Other significant methods
Face.getFeature(name)
Returns a feature by name. Possible names are:mouth
,nose
,eyeLeft
andeyeRight
.Face.getFeatures()
Returns an array ofFeature
that the instance has detected.Face.getFeatureCount()
Returns the number of detected features.
$ node examples/identify.js images/lenna.png
Then open images/lenna.features.png
on your favourite image viewer.
faced is licensed under the MIT license
Copyright (c) 2013, Samuel Gordalina [email protected]