Выполняет извлечение встраивания изображений.
API ожидает модель TFLite с необязательными, но настоятельно рекомендуемыми метаданными модели TFLite. .
API поддерживает модели с одним входным тензором изображения и одним или несколькими выходными тензорами. Если быть более конкретным, то вот требования.
- Тензор входного изображения (
kTfLiteUInt8
/kTfLiteFloat32
)- Ввод изображения размера
[batch x height x width x channels]
. - Пакетный вывод не поддерживается (
batch
должен быть равен 1). - поддерживаются только входы RGB (
channels
должно быть 3). - если тип — kTfLiteFloat32, параметры NormalizationOptions необходимо прикрепить к метаданным для нормализации ввода.
- Ввод изображения размера
kTfLiteUInt8
/ kTfLiteFloat32
) формы [1 x N]
, где N — количество измерений в созданных вложениях. Вложенные классы
сорт | ImageEmbedder.ImageEmbedderOptions | Варианты настройки и ImageEmbedder . |
Публичные методы
статический двойной | cosineSimilarity ( Вложение u, Вложение v) Служебная функция для вычисления косинусного сходства между двумя объектами Embedding . |
статический ImageEmbedder | createFromBuffer (контекстный контекст, модель ByteBufferBuffer ) Создает экземпляр ImageEmbedder из буфера модели и ImageEmbedder.ImageEmbedderOptions по умолчанию. |
статический ImageEmbedder | createFromFile (контекстный контекст, String modelPath) Создает экземпляр ImageEmbedder из файла модели и ImageEmbedder.ImageEmbedderOptions по умолчанию. |
статический ImageEmbedder | createFromFile (контекст контекста, файл модели файла ) Создает экземпляр ImageEmbedder из файла модели и ImageEmbedder.ImageEmbedderOptions по умолчанию. |
статический ImageEmbedder | createFromOptions (контекст контекста, параметры ImageEmbedder.ImageEmbedderOptions ) Создает экземпляр ImageEmbedder из экземпляра ImageEmbedder.ImageEmbedderOptions . |
ImageEmbedderResult | встроить (изображение MPImage , ImageProcessingOptions imageProcessingOptions) Выполняет извлечение встраивания предоставленного одного изображения. |
ImageEmbedderResult | |
пустота | embedAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Отправляет данные живого изображения для выполнения извлечения внедрения, и результаты будут доступны через OutputHandler.ResultListener , указанный в ImageEmbedder.ImageEmbedderOptions . |
пустота | embedAsync (изображение MPImage , длинная метка времени) Отправляет данные живого изображения для выполнения извлечения встраивания с параметрами обработки изображений по умолчанию, т.е. |
ImageEmbedderResult | embedForVideo (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs) Выполняет извлечение встраивания предоставленного видеокадра. |
ImageEmbedderResult | embedForVideo (изображение MPImage , длинная временная меткаMs) Выполняет встраивание предоставленного видеокадра с параметрами обработки изображения по умолчанию, т.е. |
Унаследованные методы
Публичные методы
public static double cosineSimilarity ( Embedding u, Embedding v)
Служебная функция для вычисления косинусного сходства между двумя объектами Embedding
.
Параметры
ты | |
---|---|
в |
Броски
IllegalArgumentException | если вложения имеют разные типы (с плавающей запятой или квантованные), имеют разные размеры или имеют норму L2, равную 0. |
---|
public static ImageEmbedder createFromBuffer (контекст контекста, ByteBuffer modelBuffer)
Создает экземпляр ImageEmbedder
из буфера модели и ImageEmbedder.ImageEmbedderOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
модельBuffer | прямой ByteBuffer или ERROR(/MappedByteBuffer) модели внедрения. |
Броски
если при создании ImageEmbedder возникла ошибка. |
public static ImageEmbedder createFromFile (контекстный контекст, String modelPath)
Создает экземпляр ImageEmbedder
из файла модели и ImageEmbedder.ImageEmbedderOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
модельпуть | путь к модели встраивания в ресурсы. |
Броски
если при создании ImageEmbedder возникла ошибка. |
public static ImageEmbedder createFromFile (контекст, файл modelFile)
Создает экземпляр ImageEmbedder
из файла модели и ImageEmbedder.ImageEmbedderOptions
по умолчанию.
Параметры
контекст | ERROR(/Context) . |
---|---|
МодельФайл | экземпляр File модели внедрения. |
Броски
Исключение IO | если при открытии файла модели tflite возникает ошибка ввода-вывода. |
---|---|
если при создании ImageEmbedder возникла ошибка. |
общедоступный статический ImageEmbedder createFromOptions (контекст контекста, параметры ImageEmbedder.ImageEmbedderOptions )
Создает экземпляр ImageEmbedder
из экземпляра ImageEmbedder.ImageEmbedderOptions
.
Параметры
контекст | ERROR(/Context) . |
---|---|
параметры | экземпляр ImageEmbedder.ImageEmbedderOptions . |
Броски
если при создании ImageEmbedder возникла ошибка. |
общедоступная вставка ImageEmbedderResult (изображение MPImage , ImageProcessingOptions imageProcessingOptions)
Выполняет извлечение встраивания предоставленного одного изображения. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.IMAGE)
.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. |
Броски
если произошла внутренняя ошибка. |
встраивание public ImageEmbedderResult (изображение MPImage )
Выполняет встраивание предоставленного одного изображения с параметрами обработки изображения по умолчанию, т. е. использует все изображение в качестве области интереса и без применения поворота. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.IMAGE)
.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|
Броски
если произошла внутренняя ошибка. |
public void embedAsync (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Отправляет данные живого изображения для выполнения извлечения внедрения, и результаты будут доступны через OutputHandler.ResultListener
, указанный в ImageEmbedder.ImageEmbedderOptions
. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.LIVE_STREAM)
.
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в детектор объектов. Входные временные метки должны монотонно увеличиваться.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. |
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |
public void embedAsync (изображение MPImage , длинная отметка времени)
Отправляет данные живого изображения для выполнения извлечения внедрения с параметрами обработки изображения по умолчанию, т. е. использует все изображение в качестве интересующей области и без применения поворота, а результаты будут доступны через OutputHandler.ResultListener
, предоставленный в ImageEmbedder.ImageEmbedderOptions
. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.LIVE_STREAM)
.
Необходимо указать временную метку (в миллисекундах), чтобы указать, когда входное изображение отправляется в детектор объектов. Входные временные метки должны монотонно увеличиваться.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |
public ImageEmbedderResult embedForVideo (изображение MPImage , ImageProcessingOptions imageProcessingOptions, long timestampMs)
Выполняет извлечение встраивания предоставленного видеокадра. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.VIDEO)
.
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно возрастать.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
Параметры обработки изображений | ImageProcessingOptions определяющий, как обрабатывать входное изображение перед выполнением вывода. |
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |
public ImageEmbedderResult embedForVideo (изображение MPImage , длинная временная меткаMs)
Выполняет встраивание предоставленного видеокадра с параметрами обработки изображения по умолчанию, т. е. использует все изображение в качестве интересующей области и без применения поворота. Используйте этот метод только в том случае, если ImageEmbedder
создается с помощью ERROR(/RunningMode.VIDEO)
.
Необходимо указать временную метку видеокадра (в миллисекундах). Входные временные метки должны монотонно увеличиваться.
ImageEmbedder
поддерживает следующие типы цветового пространства:
Параметры
изображение | объект MediaPipe MPImage для обработки. |
---|---|
временная меткаMs | временная метка ввода (в миллисекундах). |
Броски
если произошла внутренняя ошибка. |