Face Detection Engine Configuration Parameters

The Face Detection engine detects faces in video. You can send the detected faces to other engines to perform further analysis, such as face recognition.

This section describes the parameters that you can set in the configuration section for a Face Detection task.

Configuration Parameter Description
ColorAnalysis Whether to perform color analysis on detected faces to reduce false detections.
DetectEyes 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.
FrameRate The number of frames to analyze per second of video.
Input The image track to process.
MinSize The minimum size of a face.
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.
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 Tracks

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 FaceAndImage 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 FaceAndImage Contains the same information as the Result track, but each record also includes the best source frame. No

FaceResult

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

FaceAndImage

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

FaceEvent

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

_HP_HTML5_bannerTitle.htm