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

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

Face detection area warper interface. More...

`#include <IWarper.h>`

Inheritance diagram for fsdk::IWarper:

## Public Member Functions
virtual Transformation | createTransformation (const Detection &detection, const Landmarks5 &landmarks) const noexcept=0
| Create transformation data struct. More...
virtual Result< FSDKError > | warp (const Image &image, const Transformation &transformation, Image &transformedImage) const noexcept=0
| Warp image. More...
virtual Result< FSDKError > | warp (const Landmarks5 &landmarks, const Transformation &transformation, Landmarks5 &transformedLandmarks) const noexcept=0
| Warp landmarks of size 5. More...
virtual Result< FSDKError > | warp (const Landmarks68 &landmarks68, const Transformation &transformation, Landmarks68 &transformedLandmarks68) const noexcept=0
| Warp landmarks of size 68. More...
virtual Result< FSDKError > | unwarp (const EyesEstimation &eyesEstimationInWarpCoordinates, const Transformation &transformation, EyesEstimation &eyesEstimation) const noexcept=0
| Warp irisLandmarks in EyesEstimation struct for both eyes. More...
virtual Result< FSDKError > | unwarp (const Landmarks5 &warpedLandmarks5, const Transformation &transformation, Landmarks5 &landmarks5) const noexcept=0
| Warp landmarks of size 5 back to source image coords. More...
virtual Result< FSDKError > | unwarp (const Landmarks68 &warpedLandmarks68, const Transformation &transformation, Landmarks68 &landmarks68) const noexcept=0
| Warp landmarks of size 68 back to source image coords. More...
virtual fsdk::Result< FSDKError > | unwarp (const fsdk::GazeEstimation &warpedAngles, const Transformation &transformation, fsdk::GazeEstimation &angles) const noexcept=0
Public Member Functions inherited from fsdk::IRefCounted
virtual int32_t | retain () noexcept=0
| Increase strong reference count. 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

Face detection area warper interface.

Perform affine transformations on an image to properly align depicted face for descriptor extraction.

## Member Function Documentation

## ◆ createTransformation()

virtual Transformation fsdk::IWarper::createTransformation | ( | const Detection & | detection,
|  | const Landmarks5 & | landmarks
| ) |  | const
| pure virtual noexcept

Create transformation data struct.

Parameters

  [in] | detection | detection rect where landmarks are.
  [in] | landmarks | vector of landmarks to calculate warping angles.

## ◆ unwarp() [1/3]

virtual Result<FSDKError> fsdk::IWarper::unwarp | ( | const EyesEstimation & | eyesEstimationInWarpCoordinates,
|  | const Transformation & | transformation,
|  | EyesEstimation & | eyesEstimation
| ) |  | const
| pure virtual noexcept

Warp irisLandmarks in EyesEstimation struct for both eyes.

Warps from warped image coord. space to source image coord. space, the one that was used to create transformation.

Parameters

  [in] | eyesEstimationInWarpCoordinates | EyesEstimation straight out of EyeEstimator. Should be create from warpedImage, that was created with the same transformation object as the one passed.
  [in] | transformation | transformation data.
  [out] | eyesEstimation | eyes estimation with iris landmarks warped to source image coord. space.

Returns
  error code.

## ◆ unwarp() [2/3]

virtual Result<FSDKError> fsdk::IWarper::unwarp | ( | const Landmarks5 & | warpedLandmarks5,
|  | const Transformation & | transformation,
|  | Landmarks5 & | landmarks5
| ) |  | const
| pure virtual noexcept

Warp landmarks of size 5 back to source image coords.

Parameters

  [in] | warpedLandmarks5 | warped landmarks array of size 5.
  [in] | transformation | transformation data.
  [out] | landmarks5 | landmarks of size 5 warped back to source image coords.

Returns
  error code.

## ◆ unwarp() [3/3]

virtual Result<FSDKError> fsdk::IWarper::unwarp | ( | const Landmarks68 & | warpedLandmarks68,
|  | const Transformation & | transformation,
|  | Landmarks68 & | landmarks68
| ) |  | const
| pure virtual noexcept

Warp landmarks of size 68 back to source image coords.

Parameters

  [in] | warpedLandmarks5 | warped landmarks array of size 68.
  [in] | transformation | transformation data.
  [out] | landmarks5 | landmarks of size 68 warped back to source image coords.

Returns
  error code.

## ◆ warp() [1/3]

virtual Result<FSDKError> fsdk::IWarper::warp | ( | const Image & | image,
|  | const Transformation & | transformation,
|  | Image & | transformedImage
| ) |  | const
| pure virtual noexcept

Warp image.

Parameters

  [in] | image | input image in R8G8B8 format.
  [in] | transformation | transformation data.
  [out] | transformedImage | output transformed image.

Returns
  error code.

## ◆ warp() [2/3]

virtual Result<FSDKError> fsdk::IWarper::warp | ( | const Landmarks5 & | landmarks,
|  | const Transformation & | transformation,
|  | Landmarks5 & | transformedLandmarks
| ) |  | const
| pure virtual noexcept

Warp landmarks of size 5.

Parameters

  [in] | landmarks | landmarks array of size 5
  [in] | transformation | transformation data.
  [out] | transformedLandmarks | output transformed landmarks. If transformation is created with detection, it's in the coords of transformed warped image, otherwise in the coords of detection.

Returns
  error code.

## ◆ warp() [3/3]

virtual Result<FSDKError> fsdk::IWarper::warp | ( | const Landmarks68 & | landmarks68,
|  | const Transformation & | transformation,
|  | Landmarks68 & | transformedLandmarks68
| ) |  | const
| pure virtual noexcept

Warp landmarks of size 68.

Parameters

  [in] | landmarks68 | landmarks to warp.
  [in] | transformation | transformation data.
  [out] | transformedLandmarks68 | output transformed landmarks of size 68. If transformation is created with detection, it's in the coords of transformed warped image, otherwise in the coords of detection.

Returns
  error code.

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

- fsdk.framework/Headers/IWarper.h