ImageEmbedder

публичный финальный класс ImageEmbedder

Выполняет извлечение встраивания изображений.

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
встроить (изображение MPImage )
Выполняет извлечение встраивания предоставленного одного изображения с параметрами обработки изображения по умолчанию, т.е.
пустота
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 временная метка ввода (в миллисекундах).
Броски
если произошла внутренняя ошибка.