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

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

#import <RawSample.h>

Методы экземпляра

(nonnull Rectangle *) - getRectangle
 Получить ограничивающий прямоугольник лица. Потокобезопасный. Подробнее...
 
(nonnull NSMutableArray *) - getLandmarks
 Получить антропометрические точки лица. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
(nonnull Point2 *) - getLeftEye
 Получить позицию левого глаза. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
(nonnull Point2 *) - getRightEye
 Получить позицию правого глаза. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
(nonnull Angles *) - getAngles
 Получить углы ориентации лица. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
(int) - getID
 Получить целочисленный идентификатор. Потокобезопасный. Подробнее...
 
(int) - getFrameID
 Получить ID кадра, на котором был обнаружен образец (для образцов, полученных с помощью VideoWorker). Потокобезопасный. Подробнее...
 
(bool) - hasOriginalImage
 Хранит ли образец оригинальное изображение, с которого он был получен (true для образцов, полученных с помощью VideoWorker с включенным параметром store_original_frame_in_raw_sample). Потокобезопасный. Подробнее...
 
(SampleType) - getType
 Получить тип образца. Потокобезопасный. Подробнее...
 
(nonnull RawImage *) - cutFaceRawImage
 Обрезать лицо и выдать в формате RawImage (с декодированными пикселями). Потокобезопасный. Подробнее...
 
(void) - save:
 Сохранить (сериализовать) образец. Оригинальное изображение не сохраняется. (т.е. сохраняется только часть изображения, содержащая лицо). Формат платформонезависимый. Потокобезопасный. Подробнее...
 
(nonnull NSMutableArray *) - getFaceCutRectangle:
 Получить прямоугольник (для предпросмотра обрезки). Потокобезопасный. Подробнее...
 

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

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

Документация метода

- (nonnull RawImage *) cutFaceRawImage

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

Аргументы
[in]color_modelЦветовая модель изображения.
[in]cut_typeТип обрезки.
Возвращает
RawImage c кропом лица
- (nonnull Angles *) getAngles

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

Возвращает
Углы ориентации лица.
- (nonnull NSMutableArray *) getFaceCutRectangle: (FaceCutType)  cut_type

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

Возвращает
4 точки - углы прямоугольника в порядке против часовой стрелки, начиная с левого верхнего угла.
Аргументы
[in]cut_typeТип обрезки.
- (int) getFrameID

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

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

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

Возвращает
  • Неотрицательное число, если образец был получен с помощью трекера, или
  • Любое отрицательное число в противном случае.
- (nonnull NSMutableArray *) getLandmarks

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

Возвращает
Вектор позиций антропометрических точек на оригинальном изображении.
- (nonnull Point2 *) getLeftEye

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

Возвращает
Позиция левого глаза на оригинальном изображении.
- (nonnull Rectangle *) getRectangle

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

Возвращает
Прямоугольник, ограничивающий лицо на оригинальном изображении.
- (nonnull Point2 *) getRightEye

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

Возвращает
Позиция правого глаза на оригинальном изображении.
- (SampleType) getType

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

Возвращает
Тип образца.
- (bool) hasOriginalImage

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

Возвращает
true, если содержит, иначе false.
- (void) save: (const char *_Nullable)  file_path

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

Аргументы
[out]file_path