Класс pbio::Capturer

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

#include <Capturer.h>

Открытые типы
enum	CapturerType { CAPTURER_TYPE_FRONTAL = 0, CAPTURER_TYPE_LEFT_PROFILE = 1, CAPTURER_TYPE_RIGHT_PROFILE = 2 }
	Типы детекторов (см. также RawSample::SampleType). Подробнее...
typedef LightSmartPtr < Capturer >::tPtr	Ptr
	Псевдоним для типа умного указателя на Capturer.

Открытые члены
std::vector< RawSample::Ptr >	capture (const RawImage image)
	Детектировать (и отследить) лица на изображении (кадре видео). Подробнее...
std::vector< RawSample::Ptr >	capture (const unsigned char *data, int data_size)
	Детектировать (и отследить) лица на изображении (кадре видео). Подробнее...
RawSample::Ptr	manualCapture (const RawImage image, float left_eye_x, float left_eye_y, float right_eye_x, float right_eye_y)
	Создать сэмпл вручную с отмеченными позициями глаз. Подробнее...
RawSample::Ptr	manualCapture (const RawImage image, const std::vector< RawSample::Point > &points)
	Создать сэмпл вручную с отмеченными позициями всех точек. Используется для корректировки позиций точек. Подробнее...
RawSample::Ptr	manualCapture (const unsigned char *data, int data_size, float left_eye_x, float left_eye_y, float right_eye_x, float right_eye_y)
	Создать сэмпл вручную с отмеченными позициями глаз. Подробнее...
RawSample::Ptr	manualCapture (const unsigned char *data, int data_size, const std::vector< RawSample::Point > &points)
	Создать сэмпл вручную с отмеченными позициями всех точек. Используется для корректировки позиций точек. Подробнее...
void	resetHistory ()
	Удалить из истории все кадры и лица (только для трекеров).
CapturerType	getType () const
	Получить тип детектора. Подробнее...
void	setParameter (const std::string parameter, const double value)
	Изменить значение параметра в runtime. Подробнее...

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

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

Перечисления

enum pbio::Capturer::CapturerType

Типы детекторов (см. также RawSample::SampleType).

Элементы перечислений
CAPTURER_TYPE_FRONTAL	Детектирует только лица в анфас.
CAPTURER_TYPE_LEFT_PROFILE	Детектирует только лица в профиль, смотрящие влево.
CAPTURER_TYPE_RIGHT_PROFILE	Детектирует только лица в профиль, смотрящие вправо.

Методы

std::vector< RawSample::Ptr > Capturer::capture ( const RawImage  image )

inline

Детектировать (и отследить) лица на изображении (кадре видео).

Аргументы

[in]

image

Изображение или кадр видео.

Возвращает

Вектор найденных лиц.

Предупреждения

Черно-белые изображения не поддерживаются объектами, созданными с некоторыми конфигурационными файлами.

std::vector< RawSample::Ptr > Capturer::capture ( const unsigned char *  data, int  data_size  )

inline

Детектировать (и отследить) лица на изображении (кадре видео).

Аргументы

[in]	data	Указатель на закодированное изображение (или кадр видео) с 8 или 24 битами на пиксел. Поддерживаются форматы JPEG, PNG, TIF и BMP.
[in]	data_size	Размер буфера data в байтах.

Возвращает

Вектор найденных лиц.

Предупреждения

Черно-белые изображения не поддерживаются объектами, созданными с некоторыми конфигурационными файлами.

Capturer::CapturerType Capturer::getType ( ) const

inline

Получить тип детектора.

Возвращает

Тип детектора.

RawSample::Ptr Capturer::manualCapture ( const RawImage  image, float  left_eye_x, float  left_eye_y, float  right_eye_x, float  right_eye_y  )

inline

Создать сэмпл вручную с отмеченными позициями глаз.

Аргументы

[in]	image	Изображение.
[in]	left_eye_x	Координата x левого глаза.
[in]	left_eye_y	Координата y левого глаза.
[in]	right_eye_x	Координата x правого глаза.
[in]	right_eye_y	Координата y правого глаза.

Возвращает

Созданный сэмпл.

RawSample::Ptr Capturer::manualCapture ( const RawImage  image, const std::vector< RawSample::Point > &  points  )

inline

Создать сэмпл вручную с отмеченными позициями всех точек. Используется для корректировки позиций точек.

Предупреждения

Для методов распознавания 7.7, 6.7, 8.7: сэмплы, созданные с помощью этого метода, содержат недостаточно информации о позиции лица (даже если поданный вектор points содержит набор точек FDA), поэтому FDA-алгоритм будет выполнен заново в ходе выполнения Recognizer::processing. В случае, если вы используете этот метод, чтобы избежать сохранения через RawSample::save и хранить изображение самостоятельно, переходите на использование методов RawSample::saveWithoutImage и FacerecService::loadRawSampleWithoutImage.

Аргументы

[in]	image	Изображение.
[in]	points	Вектор точек. Вектор должен быть того же размера, и точки должны быть в том же порядке, как и в векторе, полученном от RawSample::getLandmarks от оригинального сэмпла.

Возвращает

Созданный сэмпл.

RawSample::Ptr Capturer::manualCapture ( const unsigned char *  data, int  data_size, float  left_eye_x, float  left_eye_y, float  right_eye_x, float  right_eye_y  )

inline

Создать сэмпл вручную с отмеченными позициями глаз.

Аргументы

[in]	data	Указатель на закодированное изображение (или кадр видео) с 8 или 24 битами на пиксел. Поддерживаются форматы JPEG, PNG, TIF и BMP.
[in]	data_size	Размер буфера data в байтах.
[in]	left_eye_x	Координата x левого глаза.
[in]	left_eye_y	Координата y левого глаза.
[in]	right_eye_x	Координата x правого глаза.
[in]	right_eye_y	Координата y правого глаза.

Возвращает

Созданный сэмпл.

RawSample::Ptr Capturer::manualCapture ( const unsigned char *  data, int  data_size, const std::vector< RawSample::Point > &  points  )

inline

Создать сэмпл вручную с отмеченными позициями всех точек. Используется для корректировки позиций точек.

Предупреждения

Для методов распознавания 7.7, 6.7, 8.7: сэмплы, созданные с помощью этого метода содержат недостаточно информации о позиции лица (даже если поданный вектор points содержит набор точек FDA), поэтому FDA-алгоритм будет выполнен заново в ходе выполнения Recognizer::processing. В случае, если вы используете этот метод, чтобы избежать сохранения через RawSample::save и хранить изображение самостоятельно, переходите на использование методов RawSample::saveWithoutImage и FacerecService::loadRawSampleWithoutImage.

Аргументы

[in]	data	Указатель на закодированное изображение (или кадр видео) с 8 или 24 битами на пиксел. Поддерживаемые форматы: JPEG, PNG, TIF и BMP.
[in]	data_size	Размер буфера data в байтах.
[in]	points	Вектор точек. Вектор должен быть того же размера, и точки должны быть в том же порядке, как и в векторе, полученном от RawSample::getLandmarks от оригинального сэмпла.

Возвращает

Созданный сэмпл.

void Capturer::setParameter ( const std::string  parameter, const double  value  )

inline

Изменить значение параметра в runtime.

Аргументы

[in]	parameter	Имя параметра (имя тэга из .xml конфигурационного файла).
[in]	value	Новое значение параметра.