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

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

Классы

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

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

void dispose ()
 Освободить внутренний объект.
 
boolean isDisposed ()
 Проверить освобожден ли объект. Подробнее...
 
String getVersion ()
 Получить версию библиотеки. Потокобезопасный. Подробнее...
 
void forceOnlineLicenseUpdate ()
 Принудительно обновить онлайн-лицензию.
 
Capturer createCapturer (final Config config)
 Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный. Подробнее...
 
Context createContext ()
 создаёт контейнер-Context. Подробнее...
 
Context createContextFromEncodedImage (byte[] data)
 создаёт контейнер-Context из закодированного изображения Подробнее...
 
Context createContextFromFrame (byte[] data, int width, int height, Context.Format format, int baseAngle)
 создаёт контейнер-Context из изображения Подробнее...
 
Context createContextFromJsonFile (final String path)
 создаёт контейнер-Context из json файла Подробнее...
 
ProcessingBlock createProcessingBlock (Context data)
 создаёт процессинг блок Подробнее...
 
AgeGenderEstimator createAgeGenderEstimator (final String ini_file)
 Создать объект AgeGenderEstimator. Потокобезопасный. Подробнее...
 
QualityEstimator createQualityEstimator (final String ini_file)
 Создать объект QualityEstimator. Потокобезопасный. Подробнее...
 
FaceQualityEstimator createFaceQualityEstimator (final String ini_file)
 Создать объект FaceQualityEstimator. Потокобезопасный. Подробнее...
 
LivenessEstimator createLivenessEstimator ()
 Создать объект LivenessEstimator. Потокобезопасный. Подробнее...
 
EmotionsEstimator createEmotionsEstimator (final String ini_file)
 Создать объект EmotionsEstimator. Потокобезопасный. Подробнее...
 
Recognizer createRecognizer (final String ini_file, final boolean processing, final boolean matching, final boolean processing_less_memory_consumption)
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
Recognizer createRecognizer (final Config recognizer_config, final boolean processing, final boolean matching, final boolean processing_less_memory_consumption)
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
VideoWorker createVideoWorker (VideoWorker.Params params)
 Создать объект VideoWorker. Потокобезопасный.
Если при создании VideoWorker указаны параметры matching_thread=0 и processing_thread=0, то потребляется обычная лицензия Capturer.
В зависимости от настроек, VideoWorker потребляет лицензию VideoClient (детекция лиц на видеопотоках) либо VideoClientExt (детекция лиц на видеопотоках, создание шаблонов и сравнение с базой). Подробнее...
 
VideoWorker createVideoWorker (final Config video_worker_config, final String recognizer_ini_file, final int streams_count, final int processing_threads_count, final int matching_threads_count)
 
VideoWorker createVideoWorker (final Config video_worker_config, final Config recognizer_config, final int streams_count, final int processing_threads_count, final int matching_threads_count)
 
RawSample loadRawSample (InputStream binary_stream)
 Загрузить объект RawSample, сохраненный с помощью метода RawSample.save. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample loadRawSampleWithoutImage (InputStream binary_stream, RawImage image)
 Загрузить объект RawSample, сохраненный с помощью метода RawSample.saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample loadRawSampleWithoutImage (InputStream binary_stream, RawImage image, double space_translation_x, double space_translation_y, double space_scale)
 Загрузить объект RawSample, сохраненный с помощью метода RawSample.saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample loadRawSampleWithoutImage (InputStream binary_stream, final byte[] encoded_image_data)
 
RawSample loadRawSampleWithoutImage (InputStream binary_stream, final byte[] encoded_image_data, double space_translation_x, double space_translation_y, double space_scale)
 
CameraCalibrator createCameraCalibrator ()
 Создать объект CameraCalibrator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator createDepthLivenessEstimator (final Config config)
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator createDepthLivenessEstimator (final String ini_file)
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
IRLivenessEstimator createIRLivenessEstimator (final Config config)
 Создать объект IRLivenessEstimator. Потокобезопасный. Подробнее...
 
IRLivenessEstimator createIRLivenessEstimator (final String ini_file)
 Создать объект IRLivenessEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator createLiveness2DEstimator (final Config config)
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
FaceAttributesEstimator createFaceAttributesEstimator (final String ini_file)
 Создать объект FaceAttributesEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator createLiveness2DEstimator (final String ini_file)
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
LicenseState getLicenseState ()
 Получить статус лицензии. Потокобезопасный. Подробнее...
 
void keepAlgorithmsCache ()
 Включить удержание данных для алгоритмов в памяти, даже если не осталось владельцев. Это ускорит повторную инициализацию алгоритмов. Потокобезопасный.
 
void freeAlgorithmsCache ()
 Отключить удержание данных для алгоритмов в памяти. Потокобезопасный.
 

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

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

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

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

Методы

AgeGenderEstimator com.vdt.face_recognition.sdk.FacerecService.createAgeGenderEstimator ( final String  ini_file)
inline

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

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

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

Возвращает
Созданный объект CameraCalibrator.
Capturer com.vdt.face_recognition.sdk.FacerecService.createCapturer ( final Config  config)
inline

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

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект Capturer.
Context com.vdt.face_recognition.sdk.FacerecService.createContext ( )
inline

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

Возвращает
контейнер-Context
Context com.vdt.face_recognition.sdk.FacerecService.createContextFromEncodedImage ( byte[]  data)
inline

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

Аргументы
[in]data- image bytes
Возвращает
контейнер-Context
Context com.vdt.face_recognition.sdk.FacerecService.createContextFromFrame ( byte[]  data,
int  width,
int  height,
Context.Format  format,
int  baseAngle 
)
inline

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

Аргументы
[in]data- байты изображения
[in]width- ширина изображения в пикселях
[in]height- высота изображения в пикселях
[in]format- формат изображения
[in]base_angle- тип угла на значение которого развёрнуто изображение
Возвращает
контейнер-Context
Context com.vdt.face_recognition.sdk.FacerecService.createContextFromJsonFile ( final String  path)
inline

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

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

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

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

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

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

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

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

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

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

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

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект FaceQualityEstimator.
IRLivenessEstimator com.vdt.face_recognition.sdk.FacerecService.createIRLivenessEstimator ( final Config  config)
inline

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

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект IRLivenessEstimator.
IRLivenessEstimator com.vdt.face_recognition.sdk.FacerecService.createIRLivenessEstimator ( final String  ini_file)
inline

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

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

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

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

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

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

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

Возвращает
Созданный объект LivenessEstimator.
ProcessingBlock com.vdt.face_recognition.sdk.FacerecService.createProcessingBlock ( Context  data)
inline

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

Аргументы
[in]data- контейнер-Context содержащий конфигурацию процессинг-блока
Возвращает
процессинг-блок
QualityEstimator com.vdt.face_recognition.sdk.FacerecService.createQualityEstimator ( final String  ini_file)
inline

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

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект QualityEstimator.
Recognizer com.vdt.face_recognition.sdk.FacerecService.createRecognizer ( final String  ini_file,
final boolean  processing,
final boolean  matching,
final boolean  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 com.vdt.face_recognition.sdk.FacerecService.createRecognizer ( final Config  recognizer_config,
final boolean  processing,
final boolean  matching,
final boolean  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 com.vdt.face_recognition.sdk.FacerecService.createService ( final String  dll_path,
final String  facerec_conf_dir,
String  license_dir 
)
inlinestatic

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

Аргументы
[in]dll_pathАбсолютный или относительный путь до файла билиотеки - libfacerec.so на Linux или facerec.dll на Windows.
[in]facerec_conf_dirАбсолютный или относительный путь до каталога с конфигурационными файлами (каталог 'face_sdk/conf/facerec/' в дистрибутиве).
[in]license_dirЕсли требуется указать директорию с файлом лицензии, то абсолютный или относительный путь до этой директории, иначе - пустая строка. В случае пустой строки файл лицензии ищется сначала в каталоге 'face_sdk/license/', затем в каталоге 'face_sdk/conf/facerec/'.
Возвращает
Созданный объект FacerecService.
static FacerecService com.vdt.face_recognition.sdk.FacerecService.createService ( final String  dll_path,
final 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Содержимое лицензии (см. pbio::FacerecService::License)
Возвращает
Созданный объект FacerecService.
VideoWorker com.vdt.face_recognition.sdk.FacerecService.createVideoWorker ( VideoWorker.Params  params)
inline

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

Аргументы
[in]paramsПараметры конструктора VideoWorker.
Возвращает
Созданный объект VideoWorker.
VideoWorker com.vdt.face_recognition.sdk.FacerecService.createVideoWorker ( final Config  video_worker_config,
final String  recognizer_ini_file,
final int  streams_count,
final int  processing_threads_count,
final int  matching_threads_count 
)
inline

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

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

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

Аргументы
[in]video_worker_configКонфигурационный файл VideoWorker с опционально переопределенными параметрами.
[in]recognizer_configКонфигурационный файл Recognizer с опционально переопределенными параметрами.
[in]streams_countКоличество видеопотоков.
[in]processing_threads_countКоличество потоков для создания шаблонов.
[in]matching_threads_countКоличество потоков для сравнения шаблонов, созданных из видеопотоков, с базой.
Возвращает
Созданный объект VideoWorker.
LicenseState com.vdt.face_recognition.sdk.FacerecService.getLicenseState ( )
inline

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

Возвращает
Статус лицензии.
String com.vdt.face_recognition.sdk.FacerecService.getVersion ( )
inline

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

Возвращает
Версия библиотеки.
boolean com.vdt.face_recognition.sdk.FacerecService.isDisposed ( )
inline

Проверить освобожден ли объект.

Возвращает
true если объект освобожден, иначе false
RawSample com.vdt.face_recognition.sdk.FacerecService.loadRawSample ( InputStream  binary_stream)
inline

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

Аргументы
[in]binary_streamОбъект потока ввода.
Возвращает
Загруженный объект RawSample.
RawSample com.vdt.face_recognition.sdk.FacerecService.loadRawSampleWithoutImage ( InputStream  binary_stream,
RawImage  image 
)
inline

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

Возвращает
Загруженный объект RawSample.
Аргументы
[in]binary_streamОбъект потока.
[in]imageИзображение.
RawSample com.vdt.face_recognition.sdk.FacerecService.loadRawSampleWithoutImage ( InputStream  binary_stream,
RawImage  image,
double  space_translation_x,
double  space_translation_y,
double  space_scale 
)
inline

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

Возвращает
Загруженный объект RawSample.
Аргументы
[in]binary_streamОбъект потока.
[in]imageИзображение.
[in]space_translation_xПараметр преобразования пространства координат.
[in]space_translation_yПараметр преобразования пространства координат.
[in]space_scaleПараметр преобразования пространства координат.
RawSample com.vdt.face_recognition.sdk.FacerecService.loadRawSampleWithoutImage ( InputStream  binary_stream,
final byte[]  encoded_image_data 
)
inline

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

Возвращает
Загруженный объект RawSample.
Аргументы
[in]binary_streamОбъект потока ввода.
[in]encoded_image_dataМассив байтов закодированного изображения (или кадра видео) с 8 или 24 битами на пиксел. Поддерживаемые форматы: JPEG, PNG, TIF и BMP.
RawSample com.vdt.face_recognition.sdk.FacerecService.loadRawSampleWithoutImage ( InputStream  binary_stream,
final byte[]  encoded_image_data,
double  space_translation_x,
double  space_translation_y,
double  space_scale 
)
inline

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

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