Face Detection detects faces in media. After detecting faces you can send the information to other tasks to perform further analysis, such as face recognition.
Configuration Parameter | Description |
---|---|
ColorAnalysis | Whether to perform color analysis on detected faces to reduce false detections. |
DetectEyes | (Deprecated) Specifies whether to include in the output the location of each person's eyes. |
DetectTilted | Whether to detect faces that are tilted to either side when facing the camera. |
FaceDirection | Face views to restrict detection to. |
Input | The image track to process. |
MinSize | The minimum size of a face. |
NumParallel | The maximum number of video frames to analyze simultaneously. |
Orientation | The orientation of faces in the video. |
Region | A region of the frame to restrict processing to. |
RegionUnit | The units that the Region parameter uses to specify the size and position of a region. |
RestrictToInputRegion | Specifies whether to analyze a region of the input image or video frame that is specified in the input record, instead of the entire image. |
SampleInterval | The interval at which frames are selected to be analyzed. |
SizeUnit | The units that the MinSize parameter uses to specify the minimum face size. |
Type | The analysis engine to use. Set this parameter to FaceDetect . |
Output track | Type | Description | Output1This column indicates whether the information contained in the track is included by default in the output created by an output task (when you don't set the Input parameter for the output task). |
---|---|---|---|
Data
|
FaceResult | Contains a record for every frame in which a face is detected (multiple records are created when the same face appears in consecutive frames). The record contains the location of the face. | No |
DataWithSource
|
FaceResultAndImage | Contains the same information as the Data track, but each record also includes the source frame. This information can be passed to other analysis engines to run tasks such as face recognition or demographic analysis. |
No |
Event
|
FaceEvent | The engine creates a record in the Event track when a face appears or disappears in the video. |
Yes |
Result
|
FaceResult |
Contains a single record for each detected face (the same face might appear in many consecutive frames). This track only contains the best result from face detection. |
Yes |
ResultWithSource
|
FaceResultAndImage | Contains the same information as the Result track, but each record also includes the best source frame. |
No |
Field name | Type | Description |
---|---|---|
id | UUIDData | A universally unique identifier to identify the face (there is one UUID per face; records with the same UUID represent the same face in different frames) |
face | FaceData | Face data, including the location of the face in the frame |
Field name | Type | Description |
---|---|---|
id | UUIDData | A universally unique identifier to identify the face (there is one UUID per face; records with the same UUID represent the same face in different frames) |
face | FaceData | Face data, including the location of the face in the frame |
image | ImageData | The source frame |
Field name | Type | Description |
---|---|---|
id | UUIDData | A universally unique identifier to identify the face (there is one UUID per face; records with the same UUID represent the same face in different frames) |
event | TrackingEventData | The type of event (begin/end), and the elapsed time since the face appeared |
|