3DiVi Face SDK  3.24.1
 Указатель Классы Пространства имен Файлы Функции Переменные Определения типов Перечисления Элементы перечислений Свойства Группы
Класс 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< PointgetLandmarks ()
 Получить антропометрические точки лица. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
Vector< PointgetIrisLandmarks ()
 Получить характерные точки глаз. Только для фронтальных образцов. Потокобезопасный. Подробнее...
 
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 ()
 Получить оригинальное изображение. Выбрасывается исключение, если образец не содержит оригинальное изображение (проверка через hasOriginalImage (RawSample)). Потокобезопасный. Подробнее...
 
SampleType getType ()
 Получить тип образца. Потокобезопасный. Подробнее...
 
Vector< PointgetFaceCutRectangle (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 вручную для образцов, которые вам нужно сохранить или в течение длительного времени удерживать в оперативной памяти. Подробнее...
 
Context toContext ()
 преобразет RawSample в контейнер-Context. Подробнее...
 

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

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

Методы

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

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

Возвращает
Оригинальное изображение.
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Параметр преобразования пространства координат.
Context com.vdt.face_recognition.sdk.RawSample.toContext ( )
inline

преобразет RawSample в контейнер-Context.

Возвращает
контейнер-Context