Face Engine SDK  5.8.0
A face detection, recognition and tracking engine.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
IIndex.h
1 #pragma once
2 
3 #include "IAsyncContext.h"
4 #include "IDescriptor.h"
5 
6 namespace fsdk {
7 
8  #ifndef DOXYGEN_SHOULD_SKIP_THIS
9  DECLARE_SMARTPTR(IStaticDescriptorStorage);
10  DECLARE_SMARTPTR(IDynamicDescriptorStorage);
11  DECLARE_SMARTPTR(IIndex);
12  DECLARE_SMARTPTR(IDenseIndex);
13  DECLARE_SMARTPTR(IDynamicIndex);
14  DECLARE_SMARTPTR(IIndexBuilder);
15  #endif
16 
18  using DescriptorId = size_t;
19 
26 
28  SearchResult() noexcept
29  : MatchingResult()
30  , index(std::numeric_limits<DescriptorId>::max())
31  {}
32 
40  float distance,
41  float similarity,
42  DescriptorId index) noexcept
44  , index(index)
45  {}
46  };
47 
64  const DescriptorId index,
65  IDescriptor* descriptor) const noexcept = 0;
66 
71  virtual uint32_t getDescriptorVersion() const noexcept = 0;
72 
77  virtual uint64_t size() const noexcept = 0;
78  };
79 
98  const IDescriptor* descriptor) noexcept = 0;
99 
113  const IDescriptorBatch* batch) noexcept = 0;
114 
130  virtual Result<FSDKError> removeDescriptor(const DescriptorId index) noexcept = 0;
131  };
132 
137  struct IIndex
138  : IRefCounted {
150  const IDescriptor* reference,
151  int maxResultsCount,
152  SearchResult* results) const noexcept = 0;
153  };
154 
158  struct IDenseIndex
160  , IIndex {
161 
162  };
163 
169  , IIndex {
179  virtual Result<FSDKError> saveToDenseIndex(const char* path) const noexcept = 0;
180 
190  virtual Result<FSDKError> saveToDynamicIndex(const char* path) const noexcept = 0;
191 
205  virtual uint64_t countOfIndexedDescriptors() const noexcept = 0;
206  };
207 
217  virtual void progress(const float completion) const noexcept = 0;
218  };
219 
225  , IRefCounted {
235  const IProgressTracker* const progressTracker = nullptr) noexcept = 0;
236 
248  IAsyncContext* const asyncContext,
249  const IProgressTracker* const progressTracker = nullptr) noexcept = 0;
250  };
251 
252 
253 }
254 
virtual ResultValue< FSDKError, DescriptorId > appendDescriptor(const IDescriptor *descriptor) noexcept=0
Appends descriptor to internal storage. If used on.
#define DECLARE_SMARTPTR(X)
Smart ptr declaration helper macro.
Definition: Def.h:59
virtual uint32_t getDescriptorVersion() const noexcept=0
Return version of stored descriptors.
virtual Result< FSDKError > removeDescriptor(const DescriptorId index) noexcept=0
Removes descriptor out of internal storage. If used on.
virtual Result< FSDKError > saveToDenseIndex(const char *path) const noexcept=0
Saves index as dense.
A structure that encapsulates an action result enumeration.
Definition: Result.h:29
Base index interface.
Definition: IIndex.h:137
Progress tracker interface.
Definition: IIndex.h:212
Result of index search.
Definition: IIndex.h:23
Descriptor batch interface.
Definition: IDescriptor.h:139
virtual ResultValue< FSDKError, Future< ResultValue< FSDKError, IDynamicIndex * > > > buildIndexAsync(IAsyncContext *const asyncContext, const IProgressTracker *const progressTracker=nullptr) noexcept=0
Builds index with every descriptor appended. Non blocking operation.
virtual uint64_t size() const noexcept=0
Return size of internal storage.
virtual uint64_t countOfIndexedDescriptors() const noexcept=0
Returns count of indexed descriptors.
Base strong reference counted object interface.
Definition: IRefCounted.h:36
Interface for running tasks asynchronously.
Definition: IAsyncContext.h:24
SearchResult() noexcept
Default constructor.
Definition: IIndex.h:28
virtual Result< FSDKError > descriptorByIndex(const DescriptorId index, IDescriptor *descriptor) const noexcept=0
Requests descriptor data out of internal storage.
Descriptor extractor and matcher interfaces.
float similarity
similarity (normalized in [0..1] range).
Definition: IDescriptor.h:36
Dynamic index interface.
Definition: IIndex.h:167
size_t DescriptorId
Intergral type used as identification of descriptor in internal storage.
Definition: IIndex.h:18
virtual Result< FSDKError > saveToDynamicIndex(const char *path) const noexcept=0
Saves index as dynamic.
Addon for Result to output some value aside the result. Specialization for copiable types...
Definition: ResultValue.h:25
MatchingResult(void) noexcept
Initializes result to default values.
Definition: IDescriptor.h:41
Async context interface.
SearchResult(float distance, float similarity, DescriptorId index) noexcept
Construct structure with parameters.
Definition: IIndex.h:39
Dense (read only) index interface.
Definition: IIndex.h:158
Result of descriptor matching.
Definition: IDescriptor.h:34
DescriptorId index
Identificator of descriptor in some storage.
Definition: IIndex.h:25
virtual ResultValue< FSDKError, int > search(const IDescriptor *reference, int maxResultsCount, SearchResult *results) const noexcept=0
Search for descriptors with the shorter distance to passed descriptor.
Descriptor interface.
Definition: IDescriptor.h:91
float distance
distance between descriptor vectors.
Definition: IDescriptor.h:35
virtual ResultValue< FSDKError, IDynamicIndex * > buildIndex(const IProgressTracker *const progressTracker=nullptr) noexcept=0
Builds index with every descriptor appended. Blocks until completed.
Dynamic descriptor storage interface.
Definition: IIndex.h:84
Index builder interface.
Definition: IIndex.h:223
virtual ResultValue< FSDKError, DescriptorId > appendBatch(const IDescriptorBatch *batch) noexcept=0
Appends batch of descriptors to internal storage. If used on.
Static descriptor storage interface.
Definition: IIndex.h:52
virtual void progress(const float completion) const noexcept=0
Function is called on some operation progress change.