3DiVi Face SDK  3.24.1
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Groups
pbio::Liveness2DEstimator Class Reference

Interface object used to estimate face liveness in order to prevent spoofing attacks. More...

#include <Liveness2DEstimator.h>

Classes

struct  LivenessAndScore
 Estimated liveness and score. More...
 

Public Types

enum  Liveness {
  NOT_ENOUGH_DATA = 0, REAL = 1, FAKE = 2, NOT_COMPUTED = 3,
  FACE_NOT_FULLY_FRAMED = 4, MULTIPLE_FACE_FRAMED = 5, FACE_TURNED_RIGHT = 6, FACE_TURNED_LEFT = 7,
  FACE_TURNED_UP = 8, FACE_TURNED_DOWN = 9, BAD_IMAGE_LIGHTING = 10, BAD_IMAGE_NOISE = 11,
  BAD_IMAGE_BLUR = 12, BAD_IMAGE_FLARE = 13
}
 Estimated liveness. More...
 
typedef LightSmartPtr
< Liveness2DEstimator >::tPtr 
Ptr
 Alias for the type of a smart pointer to Liveness2DEstimator.
 

Public Member Functions

Liveness estimateLiveness (const pbio::RawSample &sample)
 Estimates liveness of an observed face. More...
 
LivenessAndScore estimate (const pbio::RawSample &sample)
 liveness and score of an observed face. More...
 

Detailed Description

Interface object used to estimate face liveness in order to prevent spoofing attacks.

Warning
This is a deprecated version (see the new one in Processing Block API). It's support will end in 2024.

Member Enumeration Documentation

Estimated liveness.

Enumerator
NOT_ENOUGH_DATA 

Not enough information.

REAL 

The observed face belongs to a real person.

FAKE 

The observed face is taken from a photo.

NOT_COMPUTED 

The observed face was not checked.

FACE_NOT_FULLY_FRAMED 

The observed face is out of image boundaries.

MULTIPLE_FACE_FRAMED 

More than one face detected on the input image.

FACE_TURNED_RIGHT 

The observed face is not frontal and turned right.

FACE_TURNED_LEFT 

The observed face is not frontal and turned left.

FACE_TURNED_UP 

The Observed face is not frontal and turned up.

FACE_TURNED_DOWN 

The Observed face is not frontal and turned down.

BAD_IMAGE_LIGHTING 

Input image has bad lighting.

BAD_IMAGE_NOISE 

Input image is too noisy.

BAD_IMAGE_BLUR 

Input image is too blurry.

BAD_IMAGE_FLARE 

Input image is too flared.

Member Function Documentation

Liveness2DEstimator::LivenessAndScore pbio::Liveness2DEstimator::estimate ( const pbio::RawSample sample)
inline

liveness and score of an observed face.

Parameters
[in]sampleFace sample.
Returns
liveness and score (see LivenessAndScore for details).
Liveness2DEstimator::Liveness pbio::Liveness2DEstimator::estimateLiveness ( const pbio::RawSample sample)
inline

Estimates liveness of an observed face.

Parameters
[in]sampleFace sample.
Returns
Estimated liveness (see Liveness2DEstimator.Liveness for details).