# FaceDetection

Runs face detection on the file(s) associated with an IDOL document FlowFile, and adds information about any detected faces to the IDOL document.

The processor can handle the following file formats:

- TIFF
- JPEG
- JPEG 2000
- PNG
- GIF (only the first frame of an animated GIF)
- BMP (compressed BMP files are not supported) and ICO
- PBM, PGM, and PPM
- WebP

Additionally, if you configure your MediaServiceImpl controller service to use a KeyView Export Service, the processor can handle document formats, including:

- Adobe PDF
- Microsoft Word Document (.DOC and .DOCX)
- Microsoft Excel Sheet (.XLS and .XLSX)
- Microsoft PowerPoint Presentation (.PPT and .PPTX)
- OpenDocument Text (.ODT)
- OpenDocument Spreadsheet (.ODS)
- OpenDocument Presentation (.ODP)
- Rich Text (RTF)

The processor does not support video.

## Properties

Name | Default Value | Description
--- | --- | ---
IDOL License Service |  | An IdolLicenseServiceImpl that provides a way to communicate with an IDOL License Server.
Media Service |  | A MediaServiceImpl that manages media analysis resources.
Orientation | upright | The orientation of faces in the media source.
Front-view Faces Only | false | Specifies whether to detect faces looking at the camera (true), or looking in any direction (false).
Minimum Face Size | 0 | The minimum size of a face. NiFi Ingest does not attempt to detect faces that are smaller than the specified size. Increasing the minimum size can increase processing speed.
Units of Minimum Face Size | pixels | The units for "Minimum Face Size". You can use pixels or a percentage of the smallest image dimension (width or height).

## Relationships

Name | Description
--- | ---
success | Processing was successful.
failure | Processing failed.

_FT_HTML5_bannerTitle.htm