ImageSegmenter

classe final pública ImageSegmenter

Realiza a segmentação de imagens em imagens.

Além da API de segmentação padrão, ERROR(/segment) e ERROR(/segmentForVideo), que pegam uma imagem de entrada e retornam as saídas, mas envolvem uma cópia detalhada dos retornos, o Image Segmentr também é compatível com a API de callback ERROR(/segmentWithResultListener) e ERROR(/segmentForVideoWithResultListener), que permitem acessar as saídas sem copiar.

A API callback está disponível para todos os RunningMode no Segmentação por imagem. Defina OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions corretamente para usar a API de callback.

A API espera um modelo do TFLite com TFLite Model Metadata..

  • Imagem de entrada MPImage
    • A imagem em que o segmentador de imagem é executado.
  • Saída de imagem SegmentrResult ImageSegmenterResult
    • Um ImageTargetrResult contendo máscaras segmentadas.

Classes aninhadas

classe ImageSegmenter.ImageSegmenterOptions Opções para configurar um ImageSegmenter
classe ImageSegmenter.SegmentationOptions Opções para configurar o comportamento do ambiente de execução de ImageSegmenter

Métodos públicos

estático ImageSegmenter
createFromOptions(Contexto do contexto, ImageSegmenter.ImageSegmenterOptions segmenterOptions)
List<String>
getLabels()
Acessa a lista de rótulos de categoria que o Image Segmentr consegue reconhecer.
ImageSegmenterResult
segment(imagem MPImage, ImageSegmenter.SegmentationOptions TargetingOptions)
Executa a segmentação de imagens na imagem única fornecida.
ImageSegmenterResult
segment(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa a segmentação de imagens na imagem única fornecida.
ImageSegmenterResult
segment(imagem MPImage)
Executa a segmentação de imagens na imagem única fornecida com opções de processamento de imagem padrão, ou seja,
void
segmentAsync(imagem MPImage, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a segmentação de imagens, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no ImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(imagem MPImage, ImageSegmenter.SegmentationOptions segmentaçõesOptions, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a segmentação de imagens, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no ImageSegmenter.ImageSegmenterOptions.
void
segmentAsync(imagem MPImage, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a segmentação de imagens com opções de processamento de imagem padrão, ou seja,
ImageSegmenterResult
segmentForVideo(imagem MPImage, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)
Executa a segmentação de imagens no frame de vídeo fornecido.
ImageSegmenterResult
segmentForVideo(imagem MPImage, carimbos de data/hora longos)
Executa a segmentação de imagens no frame de vídeo fornecido com as opções de processamento de imagem padrão, ou seja,
ImageSegmenterResult
segmentForVideo(imagem MPImage, ImageSegmenter.SegmentationOptionstargetingOptions, carimbos de data/hora longos)
Executa a segmentação de imagens no frame de vídeo fornecido.
void
segmentForVideoWithResultListener(imagem MPImage, ImageProcessingOptions imageHandlingOptions, carimbos de data/hora longos)
Executa a segmentação de imagem no frame de vídeo fornecido e fornece resultados sem cópias usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(imagem MPImage, ImageSegmenter.SegmentationOptions segmentaçõesOptions, carimbos de data/hora longos)
Executa a segmentação de imagem no frame de vídeo fornecido e fornece resultados sem cópias usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions.
void
segmentForVideoWithResultListener(imagem MPImage, carimbos de data/hora longos)
Executa a segmentação de imagens no frame de vídeo fornecido com as opções de processamento de imagem padrão, ou seja,
void
segmentWithResultListener(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa a segmentação de imagem na única imagem fornecida e fornece resultados sem cópia por meio de OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions.
void
segmentWithResultListener(imagem MPImage)
Executa a segmentação de imagens na imagem única fornecida com opções de processamento de imagem padrão, ou seja,
void
segmentWithResultListener(imagem MPImage, ImageSegmenter.SegmentationOptions TargetingOptions)
Executa a segmentação de imagem na única imagem fornecida e fornece resultados sem cópia por meio de OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions.

Métodos herdados

Métodos públicos

público estático ImageSegmenter createFromOptions (Contexto de contexto, ImageSegmenter.ImageSegmenterOptions segmenterOptions)

Parâmetros
contexto um ERROR(/Context) do Android.
segmenterOptions uma instância ImageSegmenter.ImageSegmenterOptions.
Gera
se houver um erro durante a criação de ImageSegmenter.

public List<String> getLabels ()

Acessa a lista de rótulos de categoria que o Image Segmentr consegue reconhecer. Para o tipo CATEGORY_MASK, o índice na máscara de categorias corresponde à categoria na lista de rótulos. Para o tipo CONFIDENCE_MASK, a lista de máscaras de saída no índice corresponde à categoria na lista de rótulos.

Se não houver nenhum labelmap fornecido no arquivo de modelo, uma lista vazia de rótulos será retornada.

public ImageSegmenterResult segmento (MPImage image, ImageSegmenter.SegmentationOptionstargetingOptions)

Executa a segmentação de imagens na imagem única fornecida. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE). TODO atualização do documento Java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
segmentationOptions o ImageSegmenter.SegmentationOptions usado para configurar o comportamento do tempo de execução do ImageSegmenter.
Gera
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public ImageSegmenterResult segmento (MPImage image, ImageProcessingOptions imageprocessingOptions)

Executa a segmentação de imagens na imagem única fornecida. A máscara de saída tem o mesmo tamanho que a imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE). TODO: atualize o documento java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public ImageSegmenterResult segmento (MPImage image)

Executa a segmentação de imagens na imagem única fornecida com opções de processamento de imagem padrão, ou seja, sem aplicação de qualquer rotação. A máscara de saída tem o mesmo tamanho da imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE). TODO: atualize o documento java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public void segmentAsync (imagem de MPImage, ImageProcessingOptions image ProcessingOptions, long timestampMs)

Envia dados de imagens em tempo real para realizar a segmentação de imagens, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho da imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada ao segmentador de imagem. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public void segmentAsync (MPImage imagem, ImageSegmenter.SegmentationOptions segmentaçõesOptions, long timestampMs)

Envia dados de imagens em tempo real para realizar a segmentação de imagens, e os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no ImageSegmenter.ImageSegmenterOptions. Use esse método somente quando a ImageSegmenter for criada com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada ao segmentador de imagem. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
segmentationOptions o ImageSegmenter.SegmentationOptions usado para configurar o comportamento do tempo de execução do ImageSegmenter.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.

public void segmentAsync (MPImage imagem, carimbos de data/hora longos)

Envia dados de imagens em tempo real para realizar a segmentação com opções de processamento de imagens padrão, ou seja, sem nenhuma rotação aplicada, e os resultados ficam disponíveis por meio do OutputHandler.ResultListener fornecido no ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho que a imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada ao segmentador de imagem. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.

public ImageSegmenterResult segmentForVideo (MPImage image, ImageProcessingOptions imageprocessingOptions, long timestampMs)

Executa a segmentação de imagens no frame de vídeo fornecido. A máscara de saída tem o mesmo tamanho que a imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public ImageSegmenterResult segmentForVideo (MPImage image, long timestampMs)

Executa a segmentação de imagens no frame de vídeo fornecido com opções de processamento de imagem padrão, ou seja, sem aplicação de qualquer rotação. A máscara de saída tem o mesmo tamanho da imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public ImageSegmenterResult segmentForVideo (MPImage image, ImageSegmenter.SegmentationOptions TargetingOptions, long timestampMs)

Executa a segmentação de imagens no frame de vídeo fornecido. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
segmentationOptions o ImageSegmenter.SegmentationOptions usado para configurar o comportamento do tempo de execução do ImageSegmenter.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno. Ou se ImageSegmenter for criado com um OutputHandler.ResultListener.

public void segmentForVideoWithResultListener (MPImage imagem, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)

Executa a segmentação de imagem no frame de vídeo fornecido e fornece resultados sem cópias usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho que a imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.

public void segmentForVideoWithResultListener (imagem de MPImage, ImageSegmenter.SegmentationOptions TargetingOptions, long timestampMs)

Executa a segmentação de imagem no frame de vídeo fornecido e fornece resultados sem cópias usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
segmentationOptions o ImageSegmenter.SegmentationOptions usado para configurar o comportamento do tempo de execução do ImageSegmenter.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.

public void segmentForVideoWithResultListener (MPImage imagem, carimbos de data/hora longos)

Executa segmentação de imagem no frame de vídeo fornecido com opções de processamento de imagem padrão, ou seja, sem nenhuma rotação aplicada, e fornece resultados sem cópias usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho da imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.

public void segmentWithResultListener (MPImage imagem, ImageProcessingOptions imageprocessingOptions)

Executa a segmentação de imagem na única imagem fornecida e fornece resultados sem cópia por meio de OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho que a imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE).

TODO: atualize o documento java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.

public void segmentWithResultListener (MPImage imagem)

Executa segmentação de imagem na imagem única fornecida com opções de processamento de imagem padrão, ou seja, sem nenhuma rotação aplicada, e fornece resultados zero-copiados usando OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. A máscara de saída tem o mesmo tamanho da imagem de entrada. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE).

TODO: atualize o documento java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.

public void segmentWithResultListener (MPImage imagem, ImageSegmenter.SegmentationOptions segmentadasOptions)

Executa a segmentação de imagem na única imagem fornecida e fornece resultados sem cópia por meio de OutputHandler.ResultListener em ImageSegmenter.ImageSegmenterOptions. Use esse método somente quando o ImageSegmenter for criado com ERROR(/RunningMode.IMAGE).

TODO: atualize o documento java para o formato da imagem de entrada.

ImageSegmenter oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
segmentationOptions o ImageSegmenter.SegmentationOptions usado para configurar o comportamento do tempo de execução do ImageSegmenter.
Gera
caso haja um erro interno. Ou se ImageSegmenter não foi criado com OutputHandler.ResultListener definido em ImageSegmenter.ImageSegmenterOptions.