Face Detection

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.
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.
MaxInputQueueLength Can be used to place a limit on latency.
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.
SegmentDuration The maximum duration of a record in the SegmentedResult or SegmentedResultWithSource track. (Available only when processing video).
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 one record, describing the analysis results, per detected face, per video frame. No
DataWithSource FaceResultAndImage The same 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 (Deprecated) Media Server creates a record in the Event track when a face appears or disappears. Yes
Result FaceResult Contains one record, describing the analysis results, for each detected face. When the same face appears in many consecutive frames, Media Server produces a single result. Yes
ResultWithSource FaceResultAndImage

The same as the Result track, but each record also includes the best source frame.

No
SegmentedResult FaceResult (Available only when processing video). Contains one or more records, describing the analysis results, for each detected face. The maximum duration of records in this track is limited by the parameter SegmentDuration, so multiple records are created with the same ID when a face remains in the scene for longer than this duration. Yes
SegmentedResultWithSource FaceResultAndImage

(Available only when processing video). The same as the SegmentedResult track, but each record also includes the best source frame.

No
Start FaceResult

The same as the Data track, except it contains only the first record of each event.

No
End FaceResult

The same as the Data track, except it contains only the last record of each event.

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

FaceResultAndImage

The same as FaceResult records, with the following additional fields.

Field name Type Description
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

_FT_HTML5_bannerTitle.htm