|
visageSDK
|
VisageLivenessSmile is a class that detects whether the person on the live video stream has smiled. More...
#include <VisageLivenessSmile.h>
Public Member Functions | |
| VisageLivenessSmile () | |
| Constructor. | |
| ~VisageLivenessSmile () | |
| Destructor. | |
| int | update (const FaceData *faceData, VsImage *) |
| Method that should be called for each frame until the action is verified. More... | |
| void | reset () |
| Resets action. More... | |
Static Public Attributes | |
| static const int | STATE_WAIT_FOR_FRONTAL = 1 |
| Describes action's state where face in the frame is not frontal (head rotations larger than 0.3 rad, ~17 degrees). More... | |
| static const int | STATE_ACTION_INITIALIZING = 2 |
| Describes action's state while the action is initializing, i.e. More... | |
| static const int | STATE_WAIT_FOR_STABLE = 3 |
| Describes action's state when user is not keeping his head still. | |
| static const int | STATE_WAIT_FOR_ACTION = 4 |
| Describes action's state when smile is trying to be verified. | |
Static Public Attributes inherited from VisageSDK::VisageLivenessAction | |
| static const int | STATE_ACTION_VERIFIED = 0 |
| Describes action's state where the action was performed and verified. | |
VisageLivenessSmile is a class that detects whether the person on the live video stream has smiled.
In order for action to be detected accurately, it is required that the face is frontal and facial expression is neutral for 30 frames before performing smile.
During smile verification, face data from latest 30 frames ("face data sequence"), i.e. last 30 calls of update() is used to verify head stability (STATE_WAIT_FOR_STABLE). Each time the action is reset, face data sequence will be cleared and the action will need to go through initializing state (STATE_ACTION_INITIALIZING) to store initial face data sequence. Additionally, face data sequence is used as a baseline for neutral facial expression when detecting if smile was performed. Algorithm presumes that the face will be neutral before performing smile.
Action should be updated for each frame in order to update its internal state. The action can be in one of the following states (states are sequentially verified in each call of update()):
Definition at line 58 of file VisageLivenessSmile.h.
|
virtual |
|
virtual |
Method that should be called for each frame until the action is verified.
It should only be called when tracking status is TRACK_STAT_OK. Returns action's current state so appropriate message and/or image can be displayed if user interaction is required (e.g. warning for user or instruction on how to perform smile).
| faceData | face data obtained from the tracker |
| frame | optional image to display |
Implements VisageSDK::VisageLivenessAction.
|
static |
Describes action's state while the action is initializing, i.e.
storing initial face data sequence. After each reset, action needs to reinitialize.
Definition at line 96 of file VisageLivenessSmile.h.
|
static |
Describes action's state where face in the frame is not frontal (head rotations larger than 0.3 rad, ~17 degrees).
If this state is detected, the action will be reset.
Definition at line 90 of file VisageLivenessSmile.h.
1.8.17