Media Server 25.3
Media Server Help

# 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.
DetectionThreshold | The minimum confidence score required to detect a face.
DetectTilted | Whether to detect faces that are tilted to either side when facing the camera.
FaceDirection | Face views to restrict detection to.
GPUDeviceID | The device ID of the GPU to use.
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.
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).
Type | The analysis engine to use. Set this parameter to `FaceDetect`.

## Output Tracks

The following table describes the tracks that are generated by this engine. The Output 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).

Output track | Description | Output
--- | --- | ---
`AlignedImageResult` | Contains one record for each detected face. The records in this track include the identifier of the detected face and an image. The image is rotated so that the face is upright and is cropped around the person's head. You can pass this track to an image encoder to produce images of the detected faces. | No
`Data` | Contains one record, describing the analysis results, per detected face, per video frame. | No
`DataWithSource` | 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
`Result` | 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` | The same as the `Result` track, but each record also includes the best source frame. | No
`SegmentedResult` | (Available only when processing video). The same as the `Result` track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID. | Yes
`SegmentedResultWithSource` | (Available only when processing video). The same as the `ResultWithSource` track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID. | No
`Start` | The same as the `Data` track, except it contains only the first record of each event. | No
`End` | The same as the `Data` track, except it contains only the last record of each event. | No

For more information see Face Detection Results or use the action GetExampleRecord.

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.3

Topic Title: Face Detection