CIFaceDetector
CIFaceDetector is a face detector for Ikaros that uses Apple's Core Image Face Detector. OS X Only.
The module finds all faces in an image as well as the eyes and the mouth. Additional inputs tells whether the face is smiling and if it is novel.
Positions and sizes are given as fractions of the image size.
Example XML definition
A simple example
<module
class = "CIFaceDetector"
name = "CIFaceDetector"
/>
Parameters
| Name | Description | Type | Default |
|---|---|---|---|
| class | The class name for the module; must be "CIFaceDetector". | string | |
| name | The name of this instance of the module. | string | |
| max_faces | maximum number of faces | int | 10 |
| min_size | minimum size of a face (0.2-1.0) | float | 0.1 |
| use_tracking | track faces between frames | bool | yes |
| detect_smiles | detect smiles | bool | yes |
| detect_blinks | detect eye blink | bool | yes |
| mouth_correction | map the mouth position from the detector onto a line that is perpendicular to the line between the eyes and centered between the eyes; this mostly gives a better position than the original detector. | bool | yes |
Module Connections
Inputs
| Name | Description |
|---|---|
| INPUT | The input image |
Outputs
| Name | Description |
|---|---|
| FACE_POSITION | Location of each face in the image |
| FACE_SIZE | Size of each face (width, height) |
| FACE_BOUNDS | Face bounding boxes in image (x0, y0,...x3, y3) |
| EYE_LEFT_POSITION | Location of the left eyes in the image (0-1) |
| EYE_RIGHT_POSITION | Location of the right eyes in the image (0-1) |
| MOUTH_POSITION | Location of the right eyes in the image (0-1) |
| ROTATION | The head tilt in degrees |
| SMILE | This output is 1 if the corresponding face is smiling; 0 otherwise |
| BLINK_LEFT | This output is 1 if the left eye is blinking; 0 otherwise |
| BLINK_RIGHT | This output is 1 if the right eye is blinking; 0 otherwise |
| NOVELTY | This output is 1 if the face just appeared in the image |
| OBJECT_ID | A unique ID for the face. New IDs are assigend everytime a face dissapears and reappears |
| LIFE | This output increases with 1 for each tick that the face is tracked |
| FACE_COUNT | The number of detected faces in the image |
Limitations
OS X only.
Author
Christian Balkenius
christian.balkenius@lucs.lu.se
Lund Univeristy Cognitive Science
Files
CIFaceDetector.h
CIFaceDetector.cc
CIFaceDetector.ikc