![]() |
Face Engine SDK
5.9.0
A face detection, recognition and tracking engine.
|
Descriptor extractor interface. More...
#include <IDescriptor.h>
Public Types | |
| using | FutureResult = vlc::future< float > |
| Common aliases for BestShotQuality asynchronous interface. | |
Public Member Functions | |
| virtual ResultValue< FSDKError, float > | extractFromWarpedImage (const Image &warp, IDescriptor *descriptor) const noexcept=0 |
| Extract descriptor from a warped image. More... | |
| virtual ResultValue< FSDKError, float > | extractFromWarpedImageBatch (Span< const Image > warps, IDescriptorBatch *descriptorBatch, IDescriptor *aggregation, Span< float > garbageScoreBatch) const noexcept=0 |
| Extract batch of descriptors from a batch of images and perform aggregation. More... | |
| virtual Result< FSDKError > | extractFromWarpedImageBatch (Span< const Image > warps, IDescriptorBatch *descriptorBatch, Span< float > garbageScoreBatch) const noexcept=0 |
| Extract batch of descriptors from a batch of images. More... | |
| virtual Result< FSDKError > | validate (Span< const Image > warps, Span< Result< FSDKError >> errors) const noexcept=0 |
| Validate input of multiple frames in a single function call. More... | |
| virtual uint32_t | getModelVersion () const noexcept=0 |
| Get algorithm model version this extractor works with. More... | |
| virtual DescriptorType | getDescriptorType () const noexcept=0 |
| Get type of descriptor this extractor works with. More... | |
| virtual FutureResult | extractFromWarpedImageBatchAsync (Span< const Image > warps, IDescriptorBatch *descriptorBatch, IDescriptor *aggregation, Span< float > garbageScoreBatch) const =0 |
| Asynchronously extract batch of descriptors from a batch of images. 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... | |
Descriptor extractor interface.
Extracts face descriptors from images. The descriptors can be later used for face matching.
|
pure virtualnoexcept |
Extract descriptor from a warped image.
| [in] | warp | image with warped face or human warp. |
| [out] | descriptor | descriptor to fill with data. |
|
pure virtualnoexcept |
Extract batch of descriptors from a batch of images and perform aggregation.
| [in] | warps | span of images with warped faces or human warps. |
| [out] | descriptorBatch | descriptor batch to fill with data. |
| [out] | aggregation | descriptor with aggregation based on descriptor batch. |
| [out] | garbageScoreBatch | span of descriptor scores normalized in range [0, 1] 1 - face on the input warp; 0 - garbage on the input warp. |
|
pure virtualnoexcept |
Extract batch of descriptors from a batch of images.
| [in] | warps | span of images with warped faces or human warps. |
| [out] | descriptorBatch | descriptor batch to fill with data. |
| [out] | garbageScoreBatch | span of descriptor scores normalized in range [0, 1] 1 - face on the input warp; 0 - garbage on the input warp. DT_HUMAN descriptor does not support garbage score. In a case of DT_HUMAN descriptor, you'll get batch filled by 1.0. |
|
pure virtual |
Asynchronously extract batch of descriptors from a batch of images.
| [in] | warps | span of images with warped faces or human warps. |
| [out] | descriptorBatch | descriptor batch to fill with data. |
| [out] | aggregation | descriptor with aggregation based on descriptor batch. |
| [out] | garbageScoreBatch | span of descriptor scores normalized in range [0, 1] 1 - face on the input warp; 0 - garbage on the input warp. DT_HUMAN descriptor does not support garbage score. In a case of DT_HUMAN descriptor, you'll get batch filled by 1.0. |
|
pure virtualnoexcept |
|
pure virtualnoexcept |
Get algorithm model version this extractor works with.
|
pure virtualnoexcept |
Validate input of multiple frames in a single function call.
| [in] | warps | span of images with warped faces or human warps. |
| [out] | errors | output span of errors for each image. |