FaceDetector.detectFaces Method

Module: FaceDetector

Definition

Detects faces in an image and store their info in a DetectedFaceList object.

Note

The algorithm searches for faces in the range [16px;512px]. If the image is too large to fit this range, one must resize it before the detection process.

Important

Loading a face detector model is required to use this function. This SDK supports id3 face detectors 3A and 3B.

detect_faces(self, image: Image) -> DetectedFaceList

Parameters

image Image
in Source image to process.

Returns

The list of detected faces.

Exceptions

An error has occurred during Face Library execution.
DetectedFaceList detectFaces(Image image)

Parameters

image Image
in Source image to process.

Returns

The list of detected faces.

Exceptions

An error has occurred during Face Library execution.
public DetectedFaceList DetectFaces(Image image)

Parameters

image Image
in Source image to process.

Returns

The list of detected faces.

Exceptions

An error has occurred during Face Library execution.
public DetectedFaceList detectFaces(Image image) throws FaceException

Parameters

image Image
in Source image to process.

Returns

The list of detected faces.

Exceptions

An error has occurred during Face Library execution.
public func detectFaces(image: Image) throws -> DetectedFaceList

Parameters

image Image
in Source image to process.

Returns

The list of detected faces.

Exceptions

An error has occurred during Face Library execution.
int id3FaceDetector_DetectFaces (
    ID3_FACE_DETECTOR hFaceDetector,
    ID3_FACE_IMAGE hImage,
    ID3_DETECTED_FACE_LIST hDetectedFaceList)

Parameters

hFaceDetector ID3_FACE_DETECTOR
in Handle to the FaceDetector object.

in Source image to process.

hDetectedFaceList ID3_DETECTED_FACE_LIST
out The list of detected faces.

Returns

int
An error code.
See id3FaceError file for the list of possible error codes.