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

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

#include <FacerecService.h>

Классы

struct  License
 Хранение лицензии в виде строковой переменной. Подробнее...
 
struct  LicenseState
 Статус лицензии. Подробнее...
 

Открытые типы

typedef LightSmartPtr
< FacerecService >::tPtr 		Ptr
 Псевдоним для типа умного указателя на FacerecService.
 

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

std::string getVersion () const
 Получить версию библиотеки. Потокобезопасный. Подробнее...
 
void forceOnlineLicenseUpdate () const
 Принудительно обновить онлайн-лицензию.
 
Capturer::Ptr createCapturer (const pbio::FacerecService::Config config) const
 Создать объект Capturer. Тип и возможности зависят от указанного конфигурационного файла. Потокобезопасный. Подробнее...
 
AgeGenderEstimator::Ptr createAgeGenderEstimator (const std::string ini_file) const
 Создать объект AgeGenderEstimator. Потокобезопасный. Подробнее...
 
QualityEstimator::Ptr createQualityEstimator (const std::string ini_file) const
 Создать объект QualityEstimator. Потокобезопасный. Подробнее...
 
FaceQualityEstimator::Ptr createFaceQualityEstimator (const std::string ini_file) const
 Создать объект FaceQualityEstimator. Потокобезопасный. Подробнее...
 
LivenessEstimator::Ptr createLivenessEstimator () const
 Создать объект LivenessEstimator. Потокобезопасный. Подробнее...
 
EmotionsEstimator::Ptr createEmotionsEstimator (const std::string ini_file) const
 Создать объект EmotionsEstimator. Потокобезопасный. Подробнее...
 
Recognizer::Ptr createRecognizer (const char *ini_file, const bool processing=true, const bool matching=true, const bool processing_less_memory_consumption=false) const
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
Recognizer::Ptr createRecognizer (const pbio::FacerecService::Config recognizer_config, const bool processing=true, const bool matching=true, const bool processing_less_memory_consumption=false) const
 Создать объект Recognizer. Потокобезопасный. Подробнее...
 
VideoWorker::Ptr createVideoWorker (const pbio::VideoWorker::Params params) const
 Создать объект VideoWorker. Потокобезопасный.
Если при создании VideoWorker указаны параметры matching_thread=0 и processing_thread=0, то потребляется обычная лицензия Capturer.
В зависимости от настроек, VideoWorker потребляет лицензию VideoClient (детекция лиц на видеопотоках) либо VideoClientExt (детекция лиц на видеопотоках, создание шаблонов и сравнение с базой). Подробнее...
 
VideoWorker::Ptr createVideoWorker (const pbio::FacerecService::Config video_worker_config, const char *recognizer_ini_file, const int streams_count, const int processing_threads_count, const int matching_threads_count) const
 
VideoWorker::Ptr createVideoWorker (const pbio::FacerecService::Config video_worker_config, const pbio::FacerecService::Config recognizer_config, const int streams_count, const int processing_threads_count, const int matching_threads_count) const
 
RawSample::Ptr loadRawSample (std::istream &binary_stream) const
 Загрузить объект RawSample, сохраненный с помощью метода RawSample::save. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample::Ptr loadRawSample (pbio::stl_wraps::WrapIStream &binary_stream) const
 Загрузить объект RawSample, сохраненный с помощью метода RawSample::save. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample::Ptr loadRawSampleWithoutImage (pbio::stl_wraps::WrapIStream &binary_stream, const RawImage image, const double space_translation_x=0, const double space_translation_y=0, const double space_scale=1) const
 Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample::Ptr loadRawSampleWithoutImage (std::istream &binary_stream, const RawImage image, const double space_translation_x=0, const double space_translation_y=0, const double space_scale=1) const
 Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Подробнее...
 
RawSample::Ptr loadRawSampleWithoutImage (pbio::stl_wraps::WrapIStream &binary_stream, const unsigned char *image_data, int image_data_size, const double space_translation_x=0, const double space_translation_y=0, const double space_scale=1) const
 
RawSample::Ptr loadRawSampleWithoutImage (std::istream &binary_stream, const unsigned char *image_data, int image_data_size, const double space_translation_x=0, const double space_translation_y=0, const double space_scale=1) const
 
CameraCalibrator::Ptr createCameraCalibrator () const
 Создать объект CameraCalibrator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator::Ptr createDepthLivenessEstimator (const std::string ini_file) const
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
DepthLivenessEstimator::Ptr createDepthLivenessEstimator (const pbio::FacerecService::Config config) const
 Создать объект DepthLivenessEstimator. Потокобезопасный. Подробнее...
 
IRLivenessEstimator::Ptr createIRLivenessEstimator (const std::string ini_file) const
 Создать объект IRLivenessEstimator. Потокобезопасный. Подробнее...
 
IRLivenessEstimator::Ptr createIRLivenessEstimator (const pbio::FacerecService::Config config) const
 Создать объект IRLivenessEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator::Ptr createLiveness2DEstimator (const std::string ini_file) const
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
Liveness2DEstimator::Ptr createLiveness2DEstimator (const pbio::FacerecService::Config config) const
 Создать объект Liveness2DEstimator. Потокобезопасный. Подробнее...
 
FaceAttributesEstimator::Ptr createFaceAttributesEstimator (const std::string ini_file) const
 Создать объект FaceAttributesEstimator. Потокобезопасный. Подробнее...
 
LicenseState getLicenseState () const
 Получить статус лицензии. Потокобезопасный. Подробнее...
 
void keepAlgorithmsCache () const
 Включить удержание данных для алгоритмов в памяти, даже если не осталось владельцев. Это ускорит повторную инициализацию алгоритмов. Потокобезопасный.
 
void freeAlgorithmsCache () const
 Отключить удержание данных для алгоритмов в памяти. Потокобезопасный.
 
InternalImageBuffer::Ptr createInternalImageBuffer (const int width, const int height, const RawImage::Format format)
 Создать InternalImageBuffer для указанного размера и формата изображения. Потокобезопасный. Всегда создавайте новый InternalImageBuffer для каждого изображения или кадра видео. Никогда не изменяйте данные изображения после первого использования. Подробнее...
 
void convertYUV2ARGB (const RawImage image, const bool downscale_x2, void *const result_buffer)
 Конвертировать входное изображение в формат android.graphics.Bitmap.Config.ARGB_8888. Формат входного изображения должен быть YUV_NV21 или YUV_NV12. Замечание: в действительности порядок байт BGRA, а название ARGB_8888 похоже предполагает нотацию 32-битного little-endian целого числа. Потокобезопасный. Подробнее...
 

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

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

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

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

Методы

void FacerecService::convertYUV2ARGB ( const RawImage  image,
const bool  downscale_x2,
void *const  result_buffer 
)
inline

Конвертировать входное изображение в формат android.graphics.Bitmap.Config.ARGB_8888. Формат входного изображения должен быть YUV_NV21 или YUV_NV12. Замечание: в действительности порядок байт BGRA, а название ARGB_8888 похоже предполагает нотацию 32-битного little-endian целого числа. Потокобезопасный.

Аргументы
[in]imageИзображение в формате YUV_NV21 или YUV_NV12.
[in]downscale_x2Уменшить изображение в процессе конвертации, так что результат будет размера image.width/2 x image.height/2.
[out]result_bufferБуффер для сохранения результата размера image.width * image.height байт, если downscale_x2, либо размера 4 * image.width * image.height байт в противном случае.
AgeGenderEstimator::Ptr FacerecService::createAgeGenderEstimator ( const std::string  ini_file) const
inline

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

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

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

Возвращает
Созданный объект CameraCalibrator.
Capturer::Ptr FacerecService::createCapturer ( const pbio::FacerecService::Config  config) const
inline

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

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

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

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект DepthLivenessEstimator.
DepthLivenessEstimator::Ptr FacerecService::createDepthLivenessEstimator ( const pbio::FacerecService::Config  config) const
inline

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

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект DepthLivenessEstimator.
EmotionsEstimator::Ptr FacerecService::createEmotionsEstimator ( const std::string  ini_file) const
inline

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

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

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

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

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

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект FaceQualityEstimator.
InternalImageBuffer::Ptr FacerecService::createInternalImageBuffer ( const int  width,
const int  height,
const RawImage::Format  format 
)
inline

Создать InternalImageBuffer для указанного размера и формата изображения. Потокобезопасный. Всегда создавайте новый InternalImageBuffer для каждого изображения или кадра видео. Никогда не изменяйте данные изображения после первого использования.

Аргументы
[in]widthШирина изображения.
[in]heightВысота изображения.
[in]formatФормат изображения.
Возвращает
Созданный объект InternalImageBuffer.
IRLivenessEstimator::Ptr FacerecService::createIRLivenessEstimator ( const std::string  ini_file) const
inline

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

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

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

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

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

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

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

Аргументы
[in]configКонфигурационный файл с опционально переопределенными параметрами.
Возвращает
Созданный объект Liveness2DEstimator.
LivenessEstimator::Ptr FacerecService::createLivenessEstimator ( ) const
inline

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

Возвращает
Созданный объект LivenessEstimator.
QualityEstimator::Ptr FacerecService::createQualityEstimator ( const std::string  ini_file) const
inline

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

Аргументы
[in]ini_fileИмя конфигурационного файла.
Возвращает
Созданный объект QualityEstimator.
Recognizer::Ptr FacerecService::createRecognizer ( const char *  ini_file,
const bool  processing = true,
const bool  matching = true,
const bool  processing_less_memory_consumption = false 
) const
inline

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

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

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

Аргументы
[in]recognizer_configКонфигурационный файл Recognizer с опционально переопределенными параметрами.
[in]processingФлаг для включения / выключения метода Recognizer::processing в создаваемом разпознавателе.
[in]matchingФлаг для включения / выключения метода Recognizer::verifyMatch в создаваемом разпознавателе.
[in]processing_less_memory_consumptionФлаг для выключения оптимизаций метода Recognizer::processing, потребляющих много оперативной памяти при создании распознавателя (см. документацию).
Возвращает
Созданный объект Recognizer.
FacerecService::Ptr FacerecService::createService ( const std::string  dll_path,
std::string  facerec_conf_dir,
const std::string  license_dir = std::string() 
)
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.
FacerecService::Ptr FacerecService::createService ( const std::string  dll_path,
std::string  facerec_conf_dir,
const pbio::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::Ptr FacerecService::createVideoWorker ( const pbio::VideoWorker::Params  params) const
inline

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

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

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

Возвращает
Статус лицензии.
std::string FacerecService::getVersion ( ) const
inline

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

Возвращает
Версия библиотеки.
RawSample::Ptr FacerecService::loadRawSample ( std::istream &  binary_stream) const
inline

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

Аргументы
[in]binary_streamОбъект потока ввода. Поток файла (std::ifstream) необходимо открывать с флагом std::ios_base::binary.
Возвращает
Загруженный объект RawSample.
RawSample::Ptr FacerecService::loadRawSample ( pbio::stl_wraps::WrapIStream &  binary_stream) const
inline

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

Аргументы
[in]binary_streamОбъект потока ввода. Поток файла (std::ifstream) необходимо открывать с флагом std::ios_base::binary.
Возвращает
Загруженный объект RawSample.
RawSample::Ptr FacerecService::loadRawSampleWithoutImage ( pbio::stl_wraps::WrapIStream &  binary_stream,
const RawImage  image,
const double  space_translation_x = 0,
const double  space_translation_y = 0,
const double  space_scale = 1 
) const
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (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.
RawSample::Ptr FacerecService::loadRawSampleWithoutImage ( std::istream &  binary_stream,
const RawImage  image,
const double  space_translation_x = 0,
const double  space_translation_y = 0,
const double  space_scale = 1 
) const
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (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.
RawSample::Ptr FacerecService::loadRawSampleWithoutImage ( pbio::stl_wraps::WrapIStream &  binary_stream,
const unsigned char *  image_data,
int  image_data_size,
const double  space_translation_x = 0,
const double  space_translation_y = 0,
const double  space_scale = 1 
) const
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (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_dataУказатель на закодированное изображение с 8 или 24 битами на пиксел. Поддерживаемые форматы: JPEG, PNG, TIF и BMP.
[in]image_data_sizeРазмер буфера image_data в байтах.
[in]space_translation_xПараметр преобразования пространства координат.
[in]space_translation_yПараметр преобразования пространства координат.
[in]space_scaleПараметр преобразования пространства координат.
Возвращает
Загруженный объект RawSample.
RawSample::Ptr FacerecService::loadRawSampleWithoutImage ( std::istream &  binary_stream,
const unsigned char *  image_data,
int  image_data_size,
const double  space_translation_x = 0,
const double  space_translation_y = 0,
const double  space_scale = 1 
) const
inline

Загрузить объект RawSample, сохраненный с помощью метода RawSample::saveWithoutImage. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (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_dataУказатель на закодированное изображение с 8 или 24 битами на пиксел. Поддерживаемые форматы: JPEG, PNG, TIF и BMP.
[in]image_data_sizeРазмер буфера image_data в байтах.
[in]space_translation_xПараметр преобразования пространства координат.
[in]space_translation_yПараметр преобразования пространства координат.
[in]space_scaleПараметр преобразования пространства координат.
Возвращает
Загруженный объект RawSample.