FaceAnalyser.computePhotographicAttributes Method

Module: FaceAnalyser

Definition

Computes the photographic attributes of a detected face. This function must be used for a portrait image with only one face in it.

compute_photographic_attributes(self, image: Image, detected_face: DetectedFace, landmarks: PointList) -> PhotographicAttributes

Parameters

image Image
in Source image to process.

detected_face DetectedFace
in Detected face to process.

landmarks PointList
in Estimated landmarks of the detected face. Must be computed with the face analyser.

Returns

PhotographicAttributes
The estimated photographic attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
PhotographicAttributes computePhotographicAttributes(Image image, DetectedFace detectedFace, PointList landmarks)

Parameters

image Image
in Source image to process.

detectedFace DetectedFace
in Detected face to process.

landmarks PointList
in Estimated landmarks of the detected face. Must be computed with the face analyser.

Returns

PhotographicAttributes
The estimated photographic attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
public PhotographicAttributes ComputePhotographicAttributes(Image image, DetectedFace detectedFace, PointList landmarks)

Parameters

image Image
in Source image to process.

detectedFace DetectedFace
in Detected face to process.

landmarks PointList
in Estimated landmarks of the detected face. Must be computed with the face analyser.

Returns

PhotographicAttributes
The estimated photographic attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
public PhotographicAttributes computePhotographicAttributes(Image image, DetectedFace detectedFace, PointList landmarks) throws FaceException

Parameters

image Image
in Source image to process.

detectedFace DetectedFace
in Detected face to process.

landmarks PointList
in Estimated landmarks of the detected face. Must be computed with the face analyser.

Returns

PhotographicAttributes
The estimated photographic attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
public func computePhotographicAttributes(image: Image, detectedFace: DetectedFace, landmarks: PointList) throws -> PhotographicAttributes

Parameters

image Image
in Source image to process.

detectedFace DetectedFace
in Detected face to process.

landmarks PointList
in Estimated landmarks of the detected face. Must be computed with the face analyser.

Returns

PhotographicAttributes
The estimated photographic attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
int id3FaceAnalyser_ComputePhotographicAttributes (
    ID3_FACE_ANALYSER hFaceAnalyser,
    ID3_FACE_IMAGE hImage,
    ID3_DETECTED_FACE hDetectedFace,
    ID3_FACE_POINT_LIST hLandmarks,
    id3FacePhotographicAttributes * sPhotographicAttributes)

Parameters

hFaceAnalyser ID3_FACE_ANALYSER
in Handle to the FaceAnalyser object.

hImage ID3_FACE_IMAGE
in Source image to process.

hDetectedFace ID3_DETECTED_FACE
in Detected face to process.

hLandmarks ID3_FACE_POINT_LIST
in Estimated landmarks of the detected face. Must be computed with the face analyser.

sPhotographicAttributes id3FacePhotographicAttributes *
out The estimated photographic attributes of the detected face.

Returns

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