ImageSegmenter

ImageSegmenter public final class

Realiza segmentación de imágenes.

La API espera un modelo TFLite con TFLite modelo de metadatos. .

La API admite modelos con un tensor de entrada de imagen y un tensor de salida. Para ser más específicos, estos son los requisitos.

  • Tensor de la imagen de entrada ( kTfLiteUInt8 / kTfLiteFloat32 )
    • de entrada de imagen de tamaño [batch x height x width x channels] .
    • No se admite la inferencia por lotes ( batch se requiere que sea 1).
    • solamente entradas RGB son compatibles ( channels se requiere que sea 3).
    • si el tipo es kTfLiteFloat32 , se requieren NormalizationOptions que se adjunta a los metadatos para la normalización de entrada.
  • Salida de imagen tensor ( kTfLiteUInt8 / kTfLiteFloat32 )
    • tensor de tamaño [batch x mask_height x mask_width x num_classes] , donde batch se requiere que sea 1, mask_width y mask_height son las dimensiones de las máscaras de segmentación producidos por el modelo, y num_classes es el número de clases soportadas por el modelo.
    • Los mapas de etiquetas opcionales (pero recomendados) se pueden adjuntar como AssociatedFile-s con el tipo TENSOR_AXIS_LABELS, que contienen una etiqueta por línea. La primera de tales AssociatedFile (si existe) se utiliza para llenar el nombre de clase, es decir, ColoredLabel.getlabel() de los resultados. El nombre de visualización, es decir ColoredLabel.getDisplayName() , se llena desde el AssociatedFile (si lo hay) cuya configuración regional coincide con el campo `` display_names_locale` del ImageSegmenterOptions` utilizado en la creación de tiempo ( "en" por defecto, es decir, Inglés). Si ninguno de estos está disponible, solo se completará el campo "índice" de los resultados.

Un ejemplo de tal modelo se puede encontrar en TensorFlow concentradores. .

Clases anidadas

clase ImageSegmenter.ImageSegmenterOptions Las opciones para la creación de un ImageSegmenter .

Métodos públicos

estática ImageSegmenter
createFromBuffer ( ByteBuffer modelBuffer)
Crea un ImageSegmenter ejemplo con un tampón de modelo y el valor predeterminado ImageSegmenter.ImageSegmenterOptions .
estática ImageSegmenter
estática ImageSegmenter
CreateFromFile (contexto Contexto, Cadena modelPath)
Crea un ImageSegmenter ejemplo, de los predeterminados ImageSegmenter.ImageSegmenterOptions .
estática ImageSegmenter
CreateFromFile ( Archivo MODELFILE)
Crea un ImageSegmenter ejemplo, de los predeterminados ImageSegmenter.ImageSegmenterOptions .
estática ImageSegmenter
estática ImageSegmenter
Lista < Segmentación >
segmento (largo frameBufferHandle, ImageProcessingOptions opciones)
Lista < Segmentación >
segmento ( TensorImage imagen)
Realiza una segmentación real en la imagen proporcionada.
Lista < Segmentación >
segmento ( MlImage imagen)
Realiza la segmentación real en el proporcionado MlImage .
Lista < Segmentación >
segmento ( TensorImage imagen, ImageProcessingOptions opciones)
Realiza la segmentación real en la imagen proporcionada con ImageProcessingOptions .
Lista < Segmentación >
segmento ( MlImage imagen, ImageProcessingOptions opciones)
Realiza la segmentación real en el proporcionado MlImage con ImageProcessingOptions .

Métodos heredados

Métodos públicos

public static ImageSegmenter createFromBuffer ( ByteBuffer modelBuffer)

Crea un ImageSegmenter ejemplo con un tampón de modelo y el valor predeterminado ImageSegmenter.ImageSegmenterOptions .

Parámetros
modelBuffer una directa ByteBuffer o una MappedByteBuffer del modelo de segmentación
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el búfer no es un modelo directo ByteBuffer o una MappedByteBuffer

public static ImageSegmenter createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSegmenter.ImageSegmenterOptions opciones)

Crea un ImageSegmenter ejemplo con un tampón de modelo y ImageSegmenter.ImageSegmenterOptions .

Parámetros
modelBuffer una directa ByteBuffer o una MappedByteBuffer del modelo de segmentación
opciones
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el búfer no es un modelo directo ByteBuffer o una MappedByteBuffer

public static ImageSegmenter CreateFromFile (contexto Contexto, Cadena modelPath)

Crea un ImageSegmenter ejemplo, de los predeterminados ImageSegmenter.ImageSegmenterOptions .

Parámetros
contexto
modelPath ruta del modelo de segmentación con metadatos en los activos
Lanza
IOException si se produce un error de E / S al cargar el modelo tflite
Argumento de excepción ilegal si un argumento no es válido
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado

public static ImageSegmenter CreateFromFile ( Archivo MODELFILE)

Crea un ImageSegmenter ejemplo, de los predeterminados ImageSegmenter.ImageSegmenterOptions .

Parámetros
modelFile la segmentación modelo File instancia
Lanza
IOException si se produce un error de E / S al cargar el modelo tflite
Argumento de excepción ilegal si un argumento no es válido
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado

public static ImageSegmenter createFromFileAndOptions ( Archivo MODELFILE, ImageSegmenter.ImageSegmenterOptions opciones)

Parámetros
modelFile la segmentación modelo File instancia
opciones
Lanza
IOException si se produce un error de E / S al cargar el modelo tflite
Argumento de excepción ilegal si un argumento no es válido
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado

public static ImageSegmenter createFromFileAndOptions (contexto Contexto, Cadena modelPath, ImageSegmenter.ImageSegmenterOptions opciones)

Parámetros
contexto
modelPath ruta del modelo de segmentación con metadatos en los activos
opciones
Lanza
IOException si se produce un error de E / S al cargar el modelo tflite
Argumento de excepción ilegal si un argumento no es válido
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado

pública Lista < Segmentación > segmento (larga frameBufferHandle, ImageProcessingOptions opciones)

Parámetros
frameBufferHandle
opciones

pública Lista < Segmentación > segmento ( TensorImage imagen)

Realiza una segmentación real en la imagen proporcionada.

ImageSegmenter soporta los siguientes TensorImage tipos de espacio de color:

Parámetros
imagen un UINT8 TensorImage objeto que representa una imagen RGB o YUV
Devoluciones
  • resultados de realizar la segmentación de imágenes. Tenga en cuenta que en el momento, una sola Segmentation se espera elemento a ser devuelto. El resultado se almacena en una List para la extensión posterior para por ejemplo, modelos de segmentación de ejemplo, que puede devolver uno segmentación por objeto.
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el tipo de espacio de color de la imagen no es compatible

pública Lista < Segmentación > segmento ( MlImage imagen)

Realiza la segmentación real en el proporcionado MlImage .

Parámetros
imagen un MlImage a segmento.
Devoluciones
  • resultados de realizar la segmentación de imágenes. Tenga en cuenta que en el momento, una sola Segmentation se espera elemento a ser devuelto. El resultado se almacena en una List para la extensión posterior para por ejemplo, modelos de segmentación de ejemplo, que puede devolver uno segmentación por objeto.
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el tipo de almacenamiento o el formato de la imagen no es compatible

pública Lista < Segmentación > segmento ( TensorImage imagen, ImageProcessingOptions opciones)

Realiza la segmentación real en la imagen proporcionada con ImageProcessingOptions .

ImageSegmenter soporta los siguientes TensorImage tipos de espacio de color:

ImageSegmenter soporta las siguientes opciones:

Parámetros
imagen un UINT8 TensorImage objeto que representa una imagen RGB o YUV
opciones las opciones configuran cómo preprocesar la imagen
Devoluciones
  • resultados de realizar la segmentación de imágenes. Tenga en cuenta que en el momento, una sola Segmentation se espera elemento a ser devuelto. El resultado se almacena en una List para la extensión posterior para por ejemplo, modelos de segmentación de ejemplo, que puede devolver uno segmentación por objeto.
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el tipo de espacio de color de la imagen no es compatible

pública Lista < Segmentación > segmento ( MlImage imagen, ImageProcessingOptions opciones)

Realiza la segmentación real en el proporcionado MlImage con ImageProcessingOptions .

ImageSegmenter soporta las siguientes opciones:

Parámetros
imagen un MlImage a segmento.
opciones las opciones configuran cómo preprocesar la imagen.
Devoluciones
  • resultados de realizar la segmentación de imágenes. Tenga en cuenta que en el momento, una sola Segmentation se espera elemento a ser devuelto. El resultado se almacena en una List para la extensión posterior para por ejemplo, modelos de segmentación de ejemplo, que puede devolver uno segmentación por objeto.
Lanza
IllegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error de otro modo no especificado
Argumento de excepción ilegal si el tipo de espacio de color de la imagen no es compatible