Package ai.deepar.ar

Class DeepAR.FaceData

java.lang.Object

ai.deepar.ar.DeepAR.FaceData

Enclosing class:

DeepAR

public static class DeepAR.FaceData
extends Object

Represents data structure containing all the information available about the detected face.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	EMOTION_IDX_ANGER	Detected anger on face.
static final int	EMOTION_IDX_HAPPINESS	Detected happiness on face.
static final int	EMOTION_IDX_NEUTRAL	Detected neutral face emotion.
static final int	EMOTION_IDX_SADNESS	Detected sadness on face.
static final int	EMOTION_IDX_SURPRISE	Detected surprise on face.
float[]	emotions	Estimated emotions for the face.
boolean	faceDetected	Determines whether the face is detected or not.
float[]	faceRect	A rectangle containing the face in screen coordinates (X, Y, Width, Height).
float[]	landmarks	Detected face feature points in 3D space (X, Y, Z).
float[]	landmarks2d	Detected face feature points in 2D screen space coordinates (X, Y).
float[]	poseMatrix	Translation and rotation in matrix form (D3D style, column-major order).
float[]	rotation	The pitch, yaw and roll rotation values in euler angles (degrees) of the face in the scene.
float[]	translation	The X, Y and Z translation values of the face in the scene.

Constructor Summary

Constructors

Constructor	Description
FaceData()	Creates an empty face data.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

EMOTION_IDX_NEUTRAL

public static final int EMOTION_IDX_NEUTRAL

Detected neutral face emotion.

See Also:

• Constant Field Values

EMOTION_IDX_HAPPINESS

public static final int EMOTION_IDX_HAPPINESS

Detected happiness on face.

See Also:

• Constant Field Values

EMOTION_IDX_SURPRISE

public static final int EMOTION_IDX_SURPRISE

Detected surprise on face.

See Also:

• Constant Field Values

EMOTION_IDX_SADNESS

public static final int EMOTION_IDX_SADNESS

Detected sadness on face.

See Also:

• Constant Field Values

EMOTION_IDX_ANGER

public static final int EMOTION_IDX_ANGER

Detected anger on face.

See Also:

• Constant Field Values

faceDetected

public boolean faceDetected

Determines whether the face is detected or not.

translation

public float[] translation

The X, Y and Z translation values of the face in the scene.

rotation

public float[] rotation

The pitch, yaw and roll rotation values in euler angles (degrees) of the face in the scene.

poseMatrix

public float[] poseMatrix

Translation and rotation in matrix form (D3D style, column-major order).

landmarks

public float[] landmarks

Detected face feature points in 3D space (X, Y, Z). Read more here.

landmarks2d

public float[] landmarks2d

Detected face feature points in 2D screen space coordinates (X, Y). Usually more precise than 3D points but no estimation for Z translation. Read more here about feature points here.

faceRect

public float[] faceRect

A rectangle containing the face in screen coordinates (X, Y, Width, Height).

emotions

public float[] emotions

Estimated emotions for the face. Each emotion has a value in [0.0, 1.0] range. The 1.0 value means 100% detected emotion.

We differentiate 5 different emotions:

• Index 0 is neutral (EMOTION_IDX_NEUTRAL)
• Index 1 is happiness (EMOTION_IDX_HAPPINESS)
• Index 2 is surprise (EMOTION_IDX_SURPRISE)
• Index 3 is sadness (EMOTION_IDX_SADNESS)
• Index 4 is anger (EMOTION_IDX_ANGER)

Constructor Details

FaceData

public FaceData()

Creates an empty face data.