Класс com.vdt.face_recognition.sdk.RawSample

Интерфейсный объект, хранящий образец лица. Подробнее...

Классы
class	Angles
	Углы ориентации лица. Подробнее...
enum	FaceCutType
	Типы обрезки лица. Подробнее...
enum	ImageFormat
	Форматы изображения для сохранения (сериализации). Подробнее...
class	Rectangle
	Прямоугольник на изображении. Подробнее...
enum	SampleType
	Типы образцов (см. также VDT.FaceRecognition.SDK.Capturer.CapturerType). Подробнее...

Открытые члены
void	dispose ()
	Освободить внутренний объект.
boolean	isDisposed ()
	Проверить освобожден ли объект. Подробнее...
Rectangle	getRectangle ()
	Получить ограничивающий прямоугольник лица. Потокобезопасный. Подробнее...
Vector< Point >	getLandmarks ()
	Получить антропометрические точки лица. Только для фронтальных образцов. Потокобезопасный. Подробнее...
Vector< Point >	getIrisLandmarks ()
	Получить характерные точки глаз. Только для фронтальных образцов. Потокобезопасный. Подробнее...
Point	getLeftEye ()
	Получить позицию левого глаза. Только для фронтальных образцов. Потокобезопасный. Подробнее...
Point	getRightEye ()
	Получить позицию правого глаза. Только для фронтальных образцов. Потокобезопасный. Подробнее...
Angles	getAngles ()
	Получить углы ориентации лица. Только для фронтальных образцов. Потокобезопасный. Подробнее...
int	getID ()
	Получить целочисленный идентификатор. Потокобезопасный. Подробнее...
int	getFrameID ()
	Получить ID кадра, на котором был обнаружен образец (для образцов, полученных с помощью VideoWorker). Потокобезопасный. Подробнее...
boolean	hasOriginImage ()
	Хранит ли образец оригинальное изображение, с которого он был получен (true для образцов, полученных с помощью VideoWorker с включенным параметром store_original_frame_in_raw_sample). Потокобезопасный. Подробнее...
float	getScore ()
	Получить уверенность детектирования лица (для образцов, полученных с помощью поддерживаемого Capturer). Потокобезопасный. Подробнее...
float	getFaceVisibilityScore ()
	Получить оценку видимости лица. Потокобезопасный. Подробнее...
RawImage	getOriginImage ()
	Получить оригинальное изображение. Выбрасывается исключение, если образец не содержит оригинальное изображение (проверка через RawSample.hasOriginalImage). Потокобезопасный. Подробнее...
SampleType	getType ()
	Получить тип образца. Потокобезопасный. Подробнее...
Vector< Point >	getFaceCutRectangle (FaceCutType cut_type)
	Получить прямоугольник (для предпросмотра обрезки). Потокобезопасный. Подробнее...
void	cutFaceImage (OutputStream binary_stream, ImageFormat format, FaceCutType cut_type)
	Обрезать лицо и сохранить в указанном формате. Потокобезопасный. Подробнее...
RawImage	cutFaceRawImage (RawImage.Format color_model, FaceCutType cut_type)
	Обрезать лицо и выдать в формате RawImage (с декодированными пикселями). Потокобезопасный. Подробнее...
void	cutFaceImage (final RawImage original_image, OutputStream binary_stream, ImageFormat format, FaceCutType cut_type)
	Обрезать лицо и сохранить в исходном размере в указанном формате. Потокобезопасный. Подробнее...
void	save (OutputStream binary_stream, ImageFormat format)
	Сохранить (сериализовать) образец. Оригинальное изображение не сохраняется (т.е. сохраняется только часть изображения, содержащая лицо). Формат платформонезависимый. Потокобезопасный. Десериализовать образец можно через FacerecService.loadRawSample. Подробнее...
void	saveWithoutImage (OutputStream binary_stream)
	Сохранить (сериализовать) всю информацию, кроме изображения. Вы должны сохранить изображение самостоятельно для того, чтобы подать его в FacerecService.loadRawSampleWithoutImage для десериализации. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Десериализовать образец можно через FacerecService.loadRawSampleWithoutImage. Подробнее...
void	saveWithoutImage (OutputStream binary_stream, double space_translation_x, double space_translation_y, double space_scale)
	Сохранить (сериализовать) всю информацию, кроме изображения. Вы должны сохранить изображение самостоятельно для того, чтобы подать его в FacerecService.loadRawSampleWithoutImage для десериализации. В случае, если над изображением была выполнена трансформация, вы можете указать параметры преобразования пространства координат: (x, y) -> ( (x + space_translation_x) * space_scale, (y + space_translation_y) * space_scale ) которое будет применено к информации о позиции лица. Заметьте, что параметры одного и того же преобразования нужно передавать только один раз - либо при сериализации, либо при десериализации, иначе преобразование будет применено дважды, что неверно. Формат платформонезависимый. Потокобезопасный. Десериализовать образец можно через FacerecService.loadRawSampleWithoutImage. Подробнее...
RawSample	downscaleToPreferredSize ()
	Создать копию образца с внутренним изображением лица, уменьшенным до предпочтительного размера и без оригинального изображения. В целях уменьшения потребления памяти (как в оперативной памяти, так и после сериализации). При работе Capturer и VideoWorker автоматически уменьшают все образцы, если параметр downscale_rawsamples_to_preferred_size включен (включен по умолчанию), но это снижает производительность. Поэтому рекомендуется отключать downscale_rawsamples_to_preferred_size, и использовать RawSample.downscaleToPreferredSize вручную для образцов, которые вам нужно сохранить или в течение длительного времени удерживать в оперативной памяти. Подробнее...

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

Интерфейсный объект, хранящий образец лица.

Методы

void com.vdt.face_recognition.sdk.RawSample.cutFaceImage ( OutputStream  binary_stream, ImageFormat  format, FaceCutType  cut_type  )

inline

Обрезать лицо и сохранить в указанном формате. Потокобезопасный.

Аргументы

[out]	binary_stream	Поток для сохранения закодированного изображения.
[in]	format	Формат для сохранения изображения.
[in]	cut_type	Тип обрезки.

void com.vdt.face_recognition.sdk.RawSample.cutFaceImage ( final RawImage  original_image, OutputStream  binary_stream, ImageFormat  format, FaceCutType  cut_type  )

inline

Обрезать лицо и сохранить в исходном размере в указанном формате. Потокобезопасный.

Аргументы

[in]	original_image	Изображение, используемое для создания образца.
[out]	binary_stream	Объект потока вывода для сохранения изображения.
[in]	format	Формат кодирования изображения.
[in]	cut_type	Тип обрезки лица.

RawImage com.vdt.face_recognition.sdk.RawSample.cutFaceRawImage ( RawImage.Format  color_model, FaceCutType  cut_type  )

inline

Обрезать лицо и выдать в формате RawImage (с декодированными пикселями). Потокобезопасный.

Аргументы

[in]	color_model	Цветовая модель изображения.
[in]	cut_type	Тип обрезки.

Возвращает

RawImage c кропом лица

RawSample com.vdt.face_recognition.sdk.RawSample.downscaleToPreferredSize ( )

inline

Создать копию образца с внутренним изображением лица, уменьшенным до предпочтительного размера и без оригинального изображения. В целях уменьшения потребления памяти (как в оперативной памяти, так и после сериализации).
При работе Capturer и VideoWorker автоматически уменьшают все образцы, если параметр downscale_rawsamples_to_preferred_size включен (включен по умолчанию), но это снижает производительность.
Поэтому рекомендуется отключать downscale_rawsamples_to_preferred_size, и использовать RawSample.downscaleToPreferredSize вручную для образцов, которые вам нужно сохранить или в течение длительного времени удерживать в оперативной памяти.

Возвращает

Созданный RawSample.

Angles com.vdt.face_recognition.sdk.RawSample.getAngles ( )

inline

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

Возвращает

Углы ориентации лица.

Vector<Point> com.vdt.face_recognition.sdk.RawSample.getFaceCutRectangle ( FaceCutType  cut_type )

inline

Получить прямоугольник (для предпросмотра обрезки). Потокобезопасный.

Возвращает

4 точки - углы прямоугольника в порядке против часовой стрелки, начиная с левого верхнего угла.

Аргументы

[in]

cut_type

Тип обрезки.

float com.vdt.face_recognition.sdk.RawSample.getFaceVisibilityScore ( )

inline

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

Возвращает

Один, если лицо полностью видимо,
ноль, если лицо невидимо,
иначе - число в диапазоне [0 ... 1].

int com.vdt.face_recognition.sdk.RawSample.getFrameID ( )

inline

Получить ID кадра, на котором был обнаружен образец (для образцов, полученных с помощью VideoWorker). Потокобезопасный.

Возвращает

Ноль, если образец был получен не через VideoWorker,
иначе - неотрицательное целое число - идентификатор (который был возвращен методом VideoWorker.addVideoFrame) кадра, на котором был обнаружен образец.

int com.vdt.face_recognition.sdk.RawSample.getID ( )

inline

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

Возвращает

• Неотрицательное число, если образец был получен с помощью трекера, или
• Любое отрицательное число в противном случае.

Vector<Point> com.vdt.face_recognition.sdk.RawSample.getIrisLandmarks ( )

inline

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

Возвращает

Вектор позиций точек зрачков и контуров век на оригинальном изображении.

Vector<Point> com.vdt.face_recognition.sdk.RawSample.getLandmarks ( )

inline

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

Возвращает

Вектор позиций антропометрических точек на оригинальном изображении.

Point com.vdt.face_recognition.sdk.RawSample.getLeftEye ( )

inline

Получить позицию левого глаза. Только для фронтальных образцов. Потокобезопасный.

Возвращает

Позиция левого глаза на оригинальном изображении.

RawImage com.vdt.face_recognition.sdk.RawSample.getOriginImage ( )

inline

Получить оригинальное изображение. Выбрасывается исключение, если образец не содержит оригинальное изображение (проверка через RawSample.hasOriginalImage). Потокобезопасный.

Возвращает

Оригинальное изображение.

Rectangle com.vdt.face_recognition.sdk.RawSample.getRectangle ( )

inline

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

Возвращает

Прямоугольник, ограничивающий лицо на оригинальном изображении.

Point com.vdt.face_recognition.sdk.RawSample.getRightEye ( )

inline

Получить позицию правого глаза. Только для фронтальных образцов. Потокобезопасный.

Возвращает

Позиция правого глаза на оригинальном изображении.

float com.vdt.face_recognition.sdk.RawSample.getScore ( )

inline

Получить уверенность детектирования лица (для образцов, полученных с помощью поддерживаемого Capturer). Потокобезопасный.

Возвращает

Один, если образец был получен через неподдерживаемый Capturer,
иначе - число в диапазоне [0 ... 1].

SampleType com.vdt.face_recognition.sdk.RawSample.getType ( )

inline

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

Возвращает

Тип образца.

boolean com.vdt.face_recognition.sdk.RawSample.hasOriginImage ( )

inline

Хранит ли образец оригинальное изображение, с которого он был получен (true для образцов, полученных с помощью VideoWorker с включенным параметром store_original_frame_in_raw_sample). Потокобезопасный.

Возвращает

true, если содержит, иначе false.

boolean com.vdt.face_recognition.sdk.RawSample.isDisposed ( )

inline

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

Возвращает

true если объект освобожден, иначе false

void com.vdt.face_recognition.sdk.RawSample.save ( OutputStream  binary_stream, ImageFormat  format  )

inline

Сохранить (сериализовать) образец. Оригинальное изображение не сохраняется (т.е. сохраняется только часть изображения, содержащая лицо). Формат платформонезависимый. Потокобезопасный. Десериализовать образец можно через FacerecService.loadRawSample.

Аргументы

[out]	binary_stream	Объект потока.
[in]	format	Формат кодирования изображения.

void com.vdt.face_recognition.sdk.RawSample.saveWithoutImage ( OutputStream  binary_stream )

inline

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

Аргументы

[out]

binary_stream

Объект потока для сохранения "сырого" образца.

void com.vdt.face_recognition.sdk.RawSample.saveWithoutImage ( OutputStream  binary_stream, double  space_translation_x, double  space_translation_y, double  space_scale  )

inline

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

Аргументы

[out]	binary_stream	Объект потока для сохранения "сырого" образца.
[in]	space_translation_x	Параметр преобразования пространства координат.
[in]	space_translation_y	Параметр преобразования пространства координат.
[in]	space_scale	Параметр преобразования пространства координат.