3DiVi Face SDK  3.24.0
 Указатель Классы Пространства имен Файлы Функции Переменные Определения типов Перечисления Элементы перечислений Свойства Группы
Класс VDT.FaceRecognition.SDK.FacerecService

Интерфейсный объект для создания других интерфейсных объектов. Подробнее...

Классы

class  Config
 Класс для переопределения параметров конфигурации во время выполнения. Подробнее...
 
struct  License
 Хранение лицензии в виде строковой переменной. Подробнее...
 
class  LicenseState
 Статус лицензии. Подробнее...
 

Открытые члены

String getVersion ()
 Получить версию библиотеки. Потокобезопасный. Подробнее...
 
void forceOnlineLicenseUpdate ()
 Принудительно обновить онлайн-лицензию.
 
Capturer createCapturer (Config config)
 Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный. Подробнее...
 
Capturer createCapturer (string ini_file)
 Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный. Подробнее...
 
AgeGenderEstimator createAgeGenderEstimator (String ini_file)
 Создать объект AgeGenderEstimator. Потокобезопасный. Подробнее...
 
QualityEstimator createQualityEstimator (String ini_file)
 Создать объект QualityEstimator. Потокобезопасный. Подробнее...
 
FaceQualityEstimator createFaceQualityEstimator (String ini_file)
 Создать объект FaceQualityEstimator. Потокобезопасный. Подробнее...
 
LivenessEstimator createLivenessEstimator ()
 Создать объект LivenessEstimator. Потокобезопасный. Подробнее...
 
EmotionsEstimator createEmotionsEstimator (String ini_file)
 Создать объект EmotionsEstimator. Потокобезопасный. Подробнее...
 
Recognizer createRecognizer (String ini_file, bool processing, bool matching, bool processing_less_memory_consumption)
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
Recognizer createRecognizer (Config recognizer_config, bool processing, bool matching, bool processing_less_memory_consumption)
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
VideoWorker createVideoWorker (VideoWorker.Params prms)
 Создать объект VideoWorker. Потокобезопасный.
Если при создании VideoWorker указаны параметры matching_thread=0 и processing_thread=0, то потребляется обычная лицензия Capturer.
В зависимости от настроек, VideoWorker потребляет лицензию VideoClient (детекция лиц на видеопотоках) либо VideoClientExt (детекция лиц на видеопотоках, создание шаблонов и сравнение с базой). Подробнее...
 
VideoWorker createVideoWorker (Config video_worker_config, String recognizer_ini_file, int streams_count, int processing_threads_count, int matching_threads_count)
 
VideoWorker createVideoWorker (Config video_worker_config, Config recognizer_config, int streams_count, int processing_threads_count, int matching_threads_count)
 
RawSample loadRawSample (Stream binary_stream)
 Загрузить объект RawSample, сохраненный с помощью метода RawSample.save. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample loadRawSampleWithoutImage (Stream binary_stream, RawImage image, double space_translation_x=0, double space_translation_y=0, double space_scale=1)
 Загрузить объект RawSample, сохраненный с помощью метода RawSample.saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample loadRawSampleWithoutImage (Stream binary_stream, byte[] image_data, double space_translation_x=0, double space_translation_y=0, double space_scale=1)
 
CameraCalibrator createCameraCalibrator ()
 Создать объект CameraCalibrator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator createDepthLivenessEstimator (Config config)
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator createDepthLivenessEstimator (String ini_file)
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator createLiveness2DEstimator (Config config)
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
FaceAttributesEstimator createFaceAttributesEstimator (String ini_file)
 Создать объект FaceAttributesEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator createLiveness2DEstimator (String ini_file)
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
LicenseState getLicenseState ()
 Получить статус лицензии. Потокобезопасный. Подробнее...
 
void keepAlgorithmsCache ()
 Включить удержание данных для алгоритмов в памяти, даже если не осталось владельцев. Это ускорит повторную инициализацию алгоритмов. Потокобезопасный.
 
void freeAlgorithmsCache ()
 Отключить удержание данных для алгоритмов в памяти. Потокобезопасный.
 
unsafe ProcessingBlock CreateProcessingBlock (Dictionary< object, object > ctx)
 создаёт процессинг блок Подробнее...
 
unsafe Context CreateContext (object ctx)
 создаёт контейнер-Context. Подробнее...
 
unsafe Context CreateContextFromImage (byte[] data)
 создаёт контейнер-Context из закодированного изображения Подробнее...
 
unsafe Context CreateContextFromEncodedImage (byte[] data)
 создаёт контейнер-Context из закодированного изображения Подробнее...
 
unsafe Context CreateContextFromFrame (byte[] data, int width, int height, Context.Format format=Context.Format.FORMAT_BGR, int baseAngle=0)
 создаёт контейнер-Context из изображения Подробнее...
 
unsafe Context CreateContextFromJsonFile (string path)
 создаёт контейнер-Context из json файла Подробнее...
 
- Открытые члены унаследованные от VDT.FaceRecognition.SDK.IDisposableObject
virtual void Dispose ()
 Освободить внутренний объект.
 

Открытые статические члены

static FacerecService createService (String facerec_conf_dir, String license_dir)
 Инициализировать работу с библиотекой libfacerec (нельзя вызывать более одного раза). Подробнее...
 
static FacerecService createService (String facerec_conf_dir, FacerecService.License license)
 Инициализировать работу с библиотекой libfacerec (нельзя вызывать более одного раза). Подробнее...
 

Дополнительные унаследованные члены

- Свойства унаследованные от VDT.FaceRecognition.SDK.IDisposableObject
bool isDisposed [get]
 True если внутренний объект освобожден.
 

Подробное описание

Интерфейсный объект для создания других интерфейсных объектов.

Методы

AgeGenderEstimator VDT.FaceRecognition.SDK.FacerecService.createAgeGenderEstimator ( String  ini_file)
inline

Создать объект AgeGenderEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект AgeGenderEstimators.
CameraCalibrator VDT.FaceRecognition.SDK.FacerecService.createCameraCalibrator ( )
inline

Создать объект CameraCalibrator. Потокобезопасный.

Возвращает
Созданный объект CameraCalibrator.
Capturer VDT.FaceRecognition.SDK.FacerecService.createCapturer ( Config  config)
inline

Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный.

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект Capturer.
Capturer VDT.FaceRecognition.SDK.FacerecService.createCapturer ( string  ini_file)
inline

Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект Capturer.
unsafe Context VDT.FaceRecognition.SDK.FacerecService.CreateContext ( object  ctx)
inline

создаёт контейнер-Context.

Возвращает
контейнер-Context
unsafe Context VDT.FaceRecognition.SDK.FacerecService.CreateContextFromEncodedImage ( byte[]  data)
inline

создаёт контейнер-Context из закодированного изображения

Аргументы
[in]data- данные изображения в векторе
Возвращает
контейнер-Context
unsafe Context VDT.FaceRecognition.SDK.FacerecService.CreateContextFromFrame ( byte[]  data,
int  width,
int  height,
Context.Format  format = Context.Format.FORMAT_BGR,
int  baseAngle = 0 
)
inline

создаёт контейнер-Context из изображения

Аргументы
[in]data- байты изображения
[in]width- ширина изображения в пикселях
[in]height- высота изображения в пикселях
[in]format- формат изображения
[in]base_angle- тип угла на значение которого развёрнуто изображение
Возвращает
контейнер-Context
unsafe Context VDT.FaceRecognition.SDK.FacerecService.CreateContextFromImage ( byte[]  data)
inline

создаёт контейнер-Context из закодированного изображения

Аргументы
[in]data- данные изображения в векторе
Возвращает
контейнер-Context
unsafe Context VDT.FaceRecognition.SDK.FacerecService.CreateContextFromJsonFile ( string  path)
inline

создаёт контейнер-Context из json файла

Аргументы
[in]path- путь до json файла
Возвращает
контейнер-Context
DepthLivenessEstimator VDT.FaceRecognition.SDK.FacerecService.createDepthLivenessEstimator ( Config  config)
inline

Создать объект DepthLivenessEstimator. Потокобезопасный.

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект DepthLivenessEstimator.
DepthLivenessEstimator VDT.FaceRecognition.SDK.FacerecService.createDepthLivenessEstimator ( String  ini_file)
inline

Создать объект DepthLivenessEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект DepthLivenessEstimator.
EmotionsEstimator VDT.FaceRecognition.SDK.FacerecService.createEmotionsEstimator ( String  ini_file)
inline

Создать объект EmotionsEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект EmotionsEstimator.
FaceAttributesEstimator VDT.FaceRecognition.SDK.FacerecService.createFaceAttributesEstimator ( String  ini_file)
inline

Создать объект FaceAttributesEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект FaceAttributesEstimator.
FaceQualityEstimator VDT.FaceRecognition.SDK.FacerecService.createFaceQualityEstimator ( String  ini_file)
inline

Создать объект FaceQualityEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект FaceQualityEstimator.
Liveness2DEstimator VDT.FaceRecognition.SDK.FacerecService.createLiveness2DEstimator ( Config  config)
inline

Создать объект Liveness2DEstimator. Потокобезопасный.

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект Liveness2DEstimator.
Liveness2DEstimator VDT.FaceRecognition.SDK.FacerecService.createLiveness2DEstimator ( String  ini_file)
inline

Создать объект Liveness2DEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект Liveness2DEstimator.
LivenessEstimator VDT.FaceRecognition.SDK.FacerecService.createLivenessEstimator ( )
inline

Создать объект LivenessEstimator. Потокобезопасный.

Возвращает
Созданный объект LivenessEstimator.
unsafe ProcessingBlock VDT.FaceRecognition.SDK.FacerecService.CreateProcessingBlock ( Dictionary< object, object >  ctx)
inline

создаёт процессинг блок

Аргументы
[in]ctx- Dictionary содержащий конфигурацию процессинг-блока
Возвращает
процессинг-блок
QualityEstimator VDT.FaceRecognition.SDK.FacerecService.createQualityEstimator ( String  ini_file)
inline

Создать объект QualityEstimator. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект QualityEstimator.
Recognizer VDT.FaceRecognition.SDK.FacerecService.createRecognizer ( String  ini_file,
bool  processing,
bool  matching,
bool  processing_less_memory_consumption 
)
inline

Создать объект Recognizer. Потокобезопасный.

Аргументы
[in]ini_fileИмя конфигурационного файла.
[in]processingФлаг для включения / выключения метода Recognizer.processing в создаваемом разпознавателе.
[in]matchingФлаг для включения / выключения метода Recognizer.verifyMatch в создаваемом разпознавателе.
[in]processing_less_memory_consumptionФлаг для выключения оптимизаций метода Recognizer.processing, потребляющих много оперативной памяти при создании распознавателя (см. документацию).
Возвращает
Созданный объект Recognizer.
Recognizer VDT.FaceRecognition.SDK.FacerecService.createRecognizer ( Config  recognizer_config,
bool  processing,
bool  matching,
bool  processing_less_memory_consumption 
)
inline

Создать объект Recognizer. Потокобезопасный.

Аргументы
[in]recognizer_configКонфигурационный файл Recognizer с опционально переопределенными параметрами.
[in]processingФлаг для включения / выключения метода Recognizer.processing в создаваемом разпознавателе.
[in]matchingФлаг для включения / выключения метода Recognizer.verifyMatch в создаваемом разпознавателе.
[in]processing_less_memory_consumptionФлаг для выключения оптимизаций метода Recognizer.processing, потребляющих много оперативной памяти при создании распознавателя (см. документацию).
Возвращает
Созданный объект Recognizer.
static FacerecService VDT.FaceRecognition.SDK.FacerecService.createService ( String  facerec_conf_dir,
String  license_dir 
)
inlinestatic

Инициализировать работу с библиотекой libfacerec (нельзя вызывать более одного раза).

Аргументы
[in]facerec_conf_dirАбсолютный или относительный путь до каталога с конфигурационными файлами (каталог 'face_sdk/conf/facerec/' в дистрибутиве).
[in]license_dirЕсли требуется указать директорию с файлом лицензии, то абсолютный или относительный путь до этой директории, иначе - пустая строка. В случае пустой строки файл лицензии ищется сначала в каталоге 'face_sdk/license/', затем в каталоге 'face_sdk/conf/facerec/'.
Возвращает
Созданный объект FacerecService.
static FacerecService VDT.FaceRecognition.SDK.FacerecService.createService ( String  facerec_conf_dir,
FacerecService.License  license 
)
inlinestatic

Инициализировать работу с библиотекой libfacerec (нельзя вызывать более одного раза).

Аргументы
[in]dll_pathАбсолютный или относительный путь до файла билиотеки - libfacerec.so на Linux или facerec.dll на Windows.
[in]facerec_conf_dirАбсолютный или относительный путь до каталога с конфигурационными файлами (каталог 'face_sdk/conf/facerec/' в дистрибутиве).
[in]licenseВы можете передать содержание лицензии в виде строки (см. FacerecService.License)
Возвращает
Созданный объект FacerecService.
VideoWorker VDT.FaceRecognition.SDK.FacerecService.createVideoWorker ( VideoWorker.Params  prms)
inline

Создать объект VideoWorker. Потокобезопасный.
Если при создании VideoWorker указаны параметры matching_thread=0 и processing_thread=0, то потребляется обычная лицензия Capturer.
В зависимости от настроек, VideoWorker потребляет лицензию VideoClient (детекция лиц на видеопотоках) либо VideoClientExt (детекция лиц на видеопотоках, создание шаблонов и сравнение с базой).

Аргументы
[in]prmsПараметры конструктора VideoWorker.
Возвращает
Созданный объект VideoWorker.
VideoWorker VDT.FaceRecognition.SDK.FacerecService.createVideoWorker ( Config  video_worker_config,
String  recognizer_ini_file,
int  streams_count,
int  processing_threads_count,
int  matching_threads_count 
)
inline
Аргументы
[in]video_worker_configКонфигурационный файл VideoWorker с опционально переопределенными параметрами.
[in]recognizer_ini_fileИмя конфигурационного файла для используемого распознавателя (Recognizer).
[in]streams_countКоличество видеопотоков.
[in]processing_threads_countКоличество потоков для создания шаблонов.
[in]matching_threads_countКоличество потоков для сравнения шаблонов, созданных из видеопотоков, с базой.
Возвращает
Созданный объект VideoWorker.
VideoWorker VDT.FaceRecognition.SDK.FacerecService.createVideoWorker ( Config  video_worker_config,
Config  recognizer_config,
int  streams_count,
int  processing_threads_count,
int  matching_threads_count 
)
inline
Аргументы
[in]video_worker_configКонфигурационный файл VideoWorker с опционально переопределенными параметрами.
[in]recognizer_configКонфигурационный файл Recognizer с опционально переопределенными параметрами.
[in]streams_countКоличество видеопотоков.
[in]processing_threads_countКоличество потоков для создания шаблонов.
[in]matching_threads_countКоличество потоков для сравнения шаблонов, созданных из видеопотоков, с базой.
Возвращает
Созданный объект VideoWorker.
LicenseState VDT.FaceRecognition.SDK.FacerecService.getLicenseState ( )
inline

Получить статус лицензии. Потокобезопасный.

Возвращает
Статус лицензии.
String VDT.FaceRecognition.SDK.FacerecService.getVersion ( )
inline

Получить версию библиотеки. Потокобезопасный.

Возвращает
Версия библиотеки.
RawSample VDT.FaceRecognition.SDK.FacerecService.loadRawSample ( Stream  binary_stream)
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample.save. Формат платформонезависимый. Потокобезопасный.

Аргументы
[in]binary_streamОбъект потока ввода.
Возвращает
Загруженный объект RawSample.
RawSample VDT.FaceRecognition.SDK.FacerecService.loadRawSampleWithoutImage ( Stream  binary_stream,
RawImage  image,
double  space_translation_x = 0,
double  space_translation_y = 0,
double  space_scale = 1 
)
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample.saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный.

Аргументы
[in]binary_streamОбъект потока.
[in]imageИзображение.
[in]space_translation_xПараметр преобразования пространства координат.
[in]space_translation_yПараметр преобразования пространства координат.
[in]space_scaleПараметр преобразования пространства координат.
Возвращает
Загруженный объект RawSample.
RawSample VDT.FaceRecognition.SDK.FacerecService.loadRawSampleWithoutImage ( Stream  binary_stream,
byte[]  image_data,
double  space_translation_x = 0,
double  space_translation_y = 0,
double  space_scale = 1 
)
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample.saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный.

Аргументы
[in]binary_streamОбъект потока.
[in]image_dataМассив байтов закодированного изображения с 8 или 24 битами на пиксел. Поддерживаемые форматы: JPEG, PNG, TIF и BMP.
[in]space_translation_xПараметр преобразования пространства координат.
[in]space_translation_yПараметр преобразования пространства координат.
[in]space_scaleПараметр преобразования пространства координат.
Возвращает
Загруженный объект RawSample.