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.
- de entrada de imagen de tamaño
kTfLiteUInt8
/ kTfLiteFloat32
)- tensor de tamaño
[batch x mask_height x mask_width x num_classes]
, dondebatch
se requiere que sea 1,mask_width
ymask_height
son las dimensiones de las máscaras de segmentación producidos por el modelo, ynum_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 decirColoredLabel.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
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)
Crea un ImageSegmenter
ejemplo de ImageSegmenter.ImageSegmenterOptions
.
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)
Crea un ImageSegmenter
ejemplo de ImageSegmenter.ImageSegmenterOptions
.
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 unaList
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 unaList
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:
- rotación de imagen (a través de
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Su valor predeterminado esImageProcessingOptions.Orientation.TOP_LEFT
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 unaList
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:
- rotación de imagen (a través de
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). Por defecto esImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
no es eficaz.
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 unaList
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 |