detect

abstract fun detect(faceImage: FaceImage, query: FaceDetectionQuery = FaceDetectionQuery(), limit: Int): List<FaceDetector.Face>

Detect faces in the image. This operation should be called on a background thread.

Return

List of faces or an empty list when no faces are detected.

Parameters

faceImage

Image with expected face size ratio interval.

query

Query for extra evaluations. It allows for additional processing beyond basic face detection. The default, FaceDetectionQuery, signifies no extra evaluations and is optimized for speed.

limit

The number of faces to detect.

Throws

If DOT Face library with the detection module is not activated or if any of the requested attributes in query requires extra module, which is not activated.