FaceAnalyser.computeGeometricAttributes Method

Module: FaceAnalyser

Definition

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

compute_geometric_attributes(self, image: Image, detected_face: DetectedFace, landmarks: PointList) -> GeometricAttributes

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

GeometricAttributes
The estimated geometric attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
GeometricAttributes computeGeometricAttributes(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

GeometricAttributes
The estimated geometric attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
public GeometricAttributes ComputeGeometricAttributes(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

GeometricAttributes
The estimated geometric attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
public GeometricAttributes computeGeometricAttributes(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

GeometricAttributes
The estimated geometric attributes of the detected face.

Exceptions

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

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

GeometricAttributes
The estimated geometric attributes of the detected face.

Exceptions

FaceException
An error has occurred during Face Library execution.
int id3FaceAnalyser_ComputeGeometricAttributes (
    ID3_FACE_ANALYSER hFaceAnalyser,
    ID3_FACE_IMAGE hImage,
    ID3_DETECTED_FACE hDetectedFace,
    ID3_FACE_POINT_LIST hLandmarks,
    id3FaceGeometricAttributes * sGeometricAttributes)

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.

sGeometricAttributes id3FaceGeometricAttributes *
out The estimated geometric attributes of the detected face.

Returns

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