| Face Engine SDK 5.12.0 A face detection, recognition and tracking engine.

Public Member Functions | List of all members
fsdk::ILivenessFlyingFacesEstimator Struct Referenceabstract

Flying Faces Liveness estimator interface. More...

`#include <ILivenessFlyingFacesEstimator.h>`

Inheritance diagram for fsdk::ILivenessFlyingFacesEstimator:

## Public Member Functions
virtual Result< FSDKError > | estimate (const Image &image, const Detection &detection, LivenessFlyingFacesEstimation &estimation) const noexcept=0
| Helps to check if person is real or not. More...
virtual Result< FSDKError > | estimate (Span< const Image > images, Span< const Detection > detections, Span< LivenessFlyingFacesEstimation > estimations) const noexcept=0
| Helps to check if persons are real or not. More...
virtual Result< FSDKError > | validate (Span< const Image > images, Span< const Detection > detections, Span< Result< FSDKError >> errors) const noexcept=0
| Validate input of multiple frames in a single function call. More...
Public Member Functions inherited from fsdk::IRefCounted
virtual int32_t | retain () noexcept=0
| Increase strong reference count. More...
virtual int32_t | retainLocked () noexcept=0
| Increase strong reference count thread safely. More...
virtual int32_t | release () noexcept=0
| Decrease strong reference count. More...
virtual int32_t | getRefCount () const noexcept=0
| Get actual strong reference count. More...
virtual int32_t | retainWeak () noexcept=0
| Increase weak reference count. More...
virtual int32_t | releaseWeak () noexcept=0
| Decrease weak reference count. More...
virtual int32_t | getWeakRefCount () const noexcept=0
| Get actual weak reference count. More...

## Detailed Description

Flying Faces Liveness estimator interface.

Note
  This estimator is designed for liveness detection.

## Member Function Documentation

## ◆ estimate() [1/2]

virtual Result<FSDKError> fsdk::ILivenessFlyingFacesEstimator::estimate | ( | const Image & | image,
|  | const Detection & | detection,
|  | LivenessFlyingFacesEstimation & | estimation
| ) |  | const
| pure virtual noexcept

Helps to check if person is real or not.

Parameters

  [in] | image | source image.
  [in] | detection | detection coordinates in image space.
  [out] | estimation | estimation score;

Returns
  Result with error code.

See also
  LivenessFlyingFacesEstimation, Detection, Image, Result and FSDKError for details.

Note
  estimation score normalized between 0.0 and 1.0, where 1.0 equals to 100% confidence that person is real, and 0.0 equals to 0%.
  image format must be R8G8B8,

See also
  Format.

## ◆ estimate() [2/2]

virtual Result<FSDKError> fsdk::ILivenessFlyingFacesEstimator::estimate | ( | Span< const Image > | images,
|  | Span< const Detection > | detections,
|  | Span< LivenessFlyingFacesEstimation > | estimations
| ) |  | const
| pure virtual noexcept

Helps to check if persons are real or not.

Parameters

  [in] | images | span of source images.
  [in] | detections | span of detection coordinates in corresponding source images space.
  [out] | estimations | span of estimations.

Returns
  Result with error code.

See also
  LivenessFlyingFacesEstimation, Span, Detection, Image, Result and FSDKError for details.

Note
  estimation score normalized between 0.0 and 1.0, where 1.0 equals to 100% confidence that person on image is alive, and 0.0 equals to 0%.
  images format must be R8G8B8,

See also
  Format.

Note
  all spans should be based on user owned continuous collections.
  all spans should be equal size.

## ◆ validate()

virtual Result<FSDKError> fsdk::ILivenessFlyingFacesEstimator::validate | ( | Span< const Image > | images,
|  | Span< const Detection > | detections,
|  | Span< Result< FSDKError >> | errors
| ) |  | const
| pure virtual noexcept

Validate input of multiple frames in a single function call.

Parameters

  [in] | images | span of source images.
  [in] | detections | span of detection coordinates in corresponding source images space.
  [out] | errors | output span of errors for each image.

Returns
  Result with error code.

See also
  Span, Detection, Image, Result and FSDKError for details.

Note
  images format must be R8G8B8,

See also
  Format.

Note
  all spans should be based on user owned continuous collections.
  all spans should be equal size.

The documentation for this struct was generated from the following file:

- include/fsdk/Estimators/ILivenessFlyingFacesEstimator.h