Выполняет обнаружение ориентиров лица на изображениях.
Этот API ожидает предварительно обученный пакет ресурсов модели ориентиров лица. ВидетьMPImage
FaceLandmarkerResult
Вложенные классы
сорт | FaceLandmarker.FaceLandmarkerOptions | Варианты настройки FaceLandmarker . |
Поля
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_CONNECTORS | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_FACE_OVAL | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_LEFT_EYE | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_LEFT_EYE_BROW | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_LEFT_IRIS | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_LIPS | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_RIGHT_EYE | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_RIGHT_EYE_BROW | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_RIGHT_IRIS | |
общедоступный статический окончательный набор < Соединение > | FACE_LANDMARKS_TESSELATION |
Публичные методы
статический FaceLandmarker | createFromBuffer (Контекстный контекст, ByteBuffer modelAssetBuffer) Создает экземпляр FaceLandmarker из буфера пакета ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions по умолчанию. |
статический FaceLandmarker | createFromFile (контекст контекста, строка modelAssetPath) Создает экземпляр FaceLandmarker на основе пути к пакету ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions по умолчанию. |
статический FaceLandmarker | createFromFile (контекстный контекст, модель файлаAssetFile ) Создает экземпляр FaceLandmarker из файла пакета ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions по умолчанию. |
статический FaceLandmarker | createFromOptions (контекст контекста, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions) Создает экземпляр FaceLandmarker из FaceLandmarker.FaceLandmarkerOptions . |
ЛицоОриентирРезультат | обнаружить (изображение MPImage ) Выполняет обнаружение ориентиров лица на предоставленном одиночном изображении с параметрами обработки изображения по умолчанию, т.е. |
ЛицоОриентирРезультат | обнаружить (изображение MPImage , ImageProcessingOptions imageProcessingOptions) Выполняет обнаружение ориентиров лица на предоставленном одиночном изображении. |
пустота | обнаружитьAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Отправляет данные живого изображения для обнаружения ориентиров лица, и результаты будут доступны через OutputHandler.ResultListener , указанный в FaceLandmarker.FaceLandmarkerOptions . |
пустота | обнаружитьAsync (изображение MPImage , длинные отметки времени) Отправляет данные живого изображения для обнаружения ориентиров лица с параметрами обработки изображения по умолчанию, т.е. |
ЛицоОриентирРезультат | обнаружитьForVideo (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Выполняет обнаружение ориентиров лица на предоставленном видеокадре. |
ЛицоОриентирРезультат | DetectForVideo (изображение MPImage , длинная временная меткаMs) Выполняет обнаружение ориентиров лица на предоставленном видеокадре с параметрами обработки изображения по умолчанию, т.е. |
Унаследованные методы
Поля
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_CONNECTORS
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_FACE_OVAL
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_LEFT_EYE
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_LEFT_EYE_BROW
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_LEFT_IRIS
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_LIPS
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_RIGHT_EYE
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_RIGHT_EYE_BROW
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_RIGHT_IRIS
общедоступный статический окончательный набор < Соединение > FACE_LANDMARKS_TESSELATION
Публичные методы
общедоступный статический FaceLandmarker createFromBuffer (контекст контекста, ByteBuffer modelAssetBuffer)
Создает экземпляр FaceLandmarker
из буфера пакета ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
модельAssetBuffer |
Броски
если при создании FaceLandmarker произошла ошибка. |
общедоступный статический FaceLandmarker createFromFile (контекст контекста, строка modelAssetPath)
Создает экземпляр FaceLandmarker
на основе пути к пакету ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
модельАссетПат | путь к модели ориентиров лица с метаданными в ресурсах. |
Броски
если при создании FaceLandmarker возникла ошибка. |
общедоступный статический FaceLandmarker createFromFile (Контекстный контекст, ModelAssetFile файла )
Создает экземпляр FaceLandmarker
из файла пакета ресурсов модели и значения FaceLandmarker.FaceLandmarkerOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
МодельАссетФайл | Экземпляр File модели ориентиров лица. |
Броски
Исключение IO | если при открытии файла модели tflite возникает ошибка ввода-вывода. |
---|---|
если при создании FaceLandmarker произошла ошибка. |
общедоступный статический FaceLandmarker createFromOptions (контекст контекста, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions)
Создает экземпляр FaceLandmarker
из FaceLandmarker.FaceLandmarkerOptions
.
Параметры
контекст | ERROR(/Context) . |
---|---|
ОриентирерОпции | экземпляр FaceLandmarker.FaceLandmarkerOptions . |
Броски
если при создании FaceLandmarker произошла ошибка. |
общедоступное обнаружение FaceLandmarkerResult (изображение MPImage )
Выполняет обнаружение ориентиров лица на предоставленном одиночном изображении с параметрами обработки изображения по умолчанию, т. е. без применения поворота. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.IMAGE)
. TODO обновить Java-документ для формата входного изображения.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|
Броски
если произошла внутренняя ошибка. |
общедоступное обнаружение FaceLandmarkerResult (изображение MPImage , ImageProcessingOptions imageProcessingOptions)
Выполняет обнаружение ориентиров лица на предоставленном одиночном изображении. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.IMAGE)
. TODO обновить Java-документ для формата входного изображения.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
Броски
IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
---|---|
если произошла внутренняя ошибка. |
public void defineAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Отправляет данные живого изображения для обнаружения ориентиров лица, и результаты будут доступны через OutputHandler.ResultListener
, указанный в FaceLandmarker.FaceLandmarkerOptions
. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.LIVE_STREAM)
.
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в ориентир лица. Входные временные метки должны монотонно увеличиваться.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
---|---|
если произошла внутренняя ошибка. |
public void defineAsync (изображение MPImage , длинная метка времени)
Отправляет данные живого изображения для обнаружения ориентиров лица с параметрами обработки изображения по умолчанию, т. е. без применения поворота, и результаты будут доступны через OutputHandler.ResultListener
, предоставленный в FaceLandmarker.FaceLandmarkerOptions
. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.LIVE_STREAM)
.
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в ориентир лица. Входные временные метки должны монотонно увеличиваться.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |
public FaceLandmarkerResultDetectForVideo ( изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Выполняет обнаружение ориентиров лица на предоставленном видеокадре. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.VIDEO)
.
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно увеличиваться.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. Обратите внимание, что область интереса не поддерживается этой задачей: указание ImageProcessingOptions.regionOfInterest() приведет к тому, что этот метод выдаст исключение IllegalArgumentException. |
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
IllegalArgumentException | если ImageProcessingOptions указывает интересующую область. |
---|---|
если произошла внутренняя ошибка. |
public FaceLandmarkerResultDetectForVideo ( изображение MPImage , длинная временная меткаMs)
Выполняет обнаружение ориентиров лиц на предоставленном видеокадре с параметрами обработки изображения по умолчанию, т. е. без применения поворота. Используйте этот метод только в том случае, если FaceLandmarker
создается с помощью ERROR(/RunningMode.VIDEO)
.
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно увеличиваться.
FaceLandmarker
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |