FacerecService

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

Функции
def	face_sdk.modules.facerec_service.FacerecService.create_context
	создаёт контейнер-Context из dict. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_context_from_encoded_image
	создаёт контейнер-Context из закодированного изображения Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_context_from_frame
	создаёт контейнер-Context из изображения Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_context_from_json_file
	создаёт контейнер-Context из json файла Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_processing_block
	создаёт процессинг блок Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_service
	Инициализировать работу с библиотекой libfacerec (нельзя вызывать более одного раза). Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.get_version
	Получить имя метода. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_capturer
	Создать объект Capturer. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_age_gender_estimator
	Создать объект AgeGenderEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_emotions_estimator
	Создать объект EmotionsEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_face_quality_estimator
	Создать объект FaceQualityEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_quality_estimator
	Создать объект QualityEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_depth_liveness_estimator
	Создать объект DepthLivenessEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_ir_liveness_estimator
	Создать объект IRLivenessEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_liveness_2d_estimator
	Создать объект Liveness2DEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_face_attributes_estimator
	Создать объект FaceAttributesEstimator. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_recognizer
	Создать объект Recognizer. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.create_video_worker
	Создать объект VideoWorker. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.load_raw_sample_without_image
	Загрузить объект RawSample, сохраненный с помощью метода RawSample.save_without_image. Подробнее...
def	face_sdk.modules.facerec_service.FacerecService.load_raw_sample
	Загрузить объект RawSample, сохраненный с помощью метода RawSample.save. Подробнее...

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

Функции

def face_sdk.modules.facerec_service.FacerecService.create_age_gender_estimator	(		self,
			ini_file
	)

Создать объект AgeGenderEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла.

Возвращает

Созданный объект AgeGenderEstimators.

def face_sdk.modules.facerec_service.FacerecService.create_capturer	(		self,
			config
	)

Создать объект Capturer.

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

Аргументы

[in]

config

Имя конфигурационного файла или конфигурационный файл с опционально переопределенными параметрами.

Возвращает

Созданный объект Capturer.

def face_sdk.modules.facerec_service.FacerecService.create_context	(		self,
			ctx
	)

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

Аргументы

[in]

ctx

- dict

Возвращает

контейнер-Context

def face_sdk.modules.facerec_service.FacerecService.create_context_from_encoded_image	(		self,
			data
	)

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

Аргументы

[in]

data

- байты изображения

Возвращает

контейнер-Context

def face_sdk.modules.facerec_service.FacerecService.create_context_from_frame	(		self,
			data
	)

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

Аргументы

[in]	data	- байты изображения
[in]	width	- ширина изображения в пикселях
[in]	height	- высота изображения в пикселях
[in]	format	- формат изображения
[in]	base_angle	- тип угла на значение которого развёрнуто изображение

Возвращает

контейнер-Context

def face_sdk.modules.facerec_service.FacerecService.create_context_from_json_file	(		self,
			path
	)

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

Аргументы

[in]

path

- путь до файла

Возвращает

контейнер-Context

def face_sdk.modules.facerec_service.FacerecService.create_depth_liveness_estimator	(		self,
			config
	)

Создать объект DepthLivenessEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла или конфигурационный файл с опционально переопределенными параметрами

Возвращает

Созданный объект DepthLivenessEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_emotions_estimator	(		self,
			ini_file
	)

Создать объект EmotionsEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла.

Возвращает

Созданный объект EmotionsEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_face_attributes_estimator	(		self,
			config
	)

Создать объект FaceAttributesEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла

Возвращает

Созданный объект FaceAttributesEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_face_quality_estimator	(		self,
			ini_file
	)

Создать объект FaceQualityEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла.

Возвращает

Созданный объект FaceQualityEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_ir_liveness_estimator	(		self,
			config
	)

Создать объект IRLivenessEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла или конфигурационный файл с опционально переопределенными параметрами

Возвращает

Созданный объект IRLivenessEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_liveness_2d_estimator	(		self,
			config
	)

Создать объект Liveness2DEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла или конфигурационный файл с опционально переопределенными параметрами

Возвращает

Созданный объект Liveness2DEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_processing_block	(		self,
			ctx
	)

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

Аргументы

[in]

config

- контейнер-Context содержащий конфигурацию процессинг-блока

Возвращает

процессинг-блок

def face_sdk.modules.facerec_service.FacerecService.create_quality_estimator	(		self,
			ini_file
	)

Создать объект QualityEstimator.

Потокобезопасный.

Аргументы

[in]

ini_file

Имя конфигурационного файла.

Возвращает

Созданный объект QualityEstimator.

def face_sdk.modules.facerec_service.FacerecService.create_recognizer	(		self,
			recognizer_config
	)

Создать объект Recognizer.

Потокобезопасный.

Аргументы

[in]	recognizer_config	Имя конфигурационного файла или конфигурационный файл Recognizer с опционально переопределенными параметрами.
[in]	processing	Флаг для включения / выключения метода Recognizer.processing в создаваемом разпознавателе.
[in]	matching	Флаг для включения / выключения метода Recognizer.verify_match в создаваемом разпознавателе.
[in]	processing_less_memory_consumption	Флаг для выключения оптимизаций метода Recognizer.processing, потребляющих много оперативной памяти при создании распознавателя (см. документацию).

Возвращает

Созданный объект Recognizer.

def face_sdk.modules.facerec_service.FacerecService.create_service	(		cls,
			dll_path
	)

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

Аргументы

[in]	dll_path	Абсолютный или относительный путь до файла билиотеки - libfacerec.so на Linux или facerec.dll на Windows.
[in]	facerec_conf_dir	Абсолютный или относительный путь до каталога с конфигурационными файлами (каталог 'face_sdk_3divi/conf/facerec/' в дистрибутиве).
[in]	license_dir	Если требуется указать директорию с файлом лицензии, то абсолютный или относительный путь до этой директории, иначе - пустая строка. В случае пустой строки файл лицензии ищется сначала в каталоге 'face_sdk_3divi/license/', затем в каталоге 'face_sdk_3divi/conf/facerec/'.

Возвращает

Созданный объект FacerecService.

def face_sdk.modules.facerec_service.FacerecService.create_video_worker	(		self,
			params
	)

Создать объект VideoWorker.

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

Аргументы

[in]

params

Параметры конструктора VideoWorker.

Возвращает

Созданный объект VideoWorker.

def face_sdk.modules.facerec_service.FacerecService.get_version	(		self,
			str
	)

Получить имя метода.

Потокобезопасный.

Возвращает

Имя метода.

def face_sdk.modules.facerec_service.FacerecService.load_raw_sample	(		self,
			binary_stream
	)

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

Формат платформонезависимый. Потокобезопасный.

Аргументы

[in]

binary_stream

Объект потока ввода. Поток файла (std::ifstream) необходимо открывать с флагом std::ios_base::binary.

Возвращает

Загруженный объект RawSample.

def face_sdk.modules.facerec_service.FacerecService.load_raw_sample_without_image	(		self,
			binary_stream
	)

Загрузить объект RawSample, сохраненный с помощью метода RawSample.save_without_image.

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

Аргументы

[in]	binary_stream	Объект потока ввода. Поток файла (std::ifstream) необходимо открывать с флагом std::ios_base::binary.
[in]	image	Изображение.
[in]	space_translation_x	Параметр преобразования пространства координат.
[in]	space_translation_y	Параметр преобразования пространства координат.
[in]	space_scale	Параметр преобразования пространства координат.

Возвращает

Загруженный объект RawSample.