Ti presentiamo Google AI Edge Portal: esegui il benchmarking dell'IA di Edge su larga scala. Registrati per richiedere l'accesso durante l'anteprima privata.

Questa pagina è stata tradotta dall'API Cloud Translation.

ImageSegmenter

classe pubblica finale ImageSegmenter

Esegue la segmentazione delle immagini.

Tieni presente che, oltre all'API di segmentazione standard, ERROR(/segment) e ERROR(/segmentForVideo), che acquisiscono un'immagine di input e restituiscono gli output, ma richiedono una copia approfondita dei ritorni, ImageSegmenter supporta anche l'API di callback ERROR(/segmentWithResultListener) e ERROR(/segmentForVideoWithResultListener), che consentono di accedere agli output tramite zero copia.

L'API di callback è disponibile per tutti i RunningMode in ImageSegmenter. Imposta OutputHandler.ResultListener correttamente in ImageSegmenter.ImageSegmenterOptions per utilizzare l'API callback.

L'API si aspetta un modello TFLite con metadati modello TFLite.

Immagine di input MPImage
- L'immagine su cui viene eseguito il segmenter di immagini.
Output ImageSegmenterResult ImageSegmenterResult
- Un ImageSegmenterResult contenente maschere segmentate.

Corsi nidificati

classe	ImageSegmenter.ImageSegmenterOptions		Opzioni per configurare un `ImageSegmenter`.
classe	ImageSegmenter.SegmentationOptions		Opzioni per configurare il comportamento di runtime di `ImageSegmenter`.

Metodi pubblici

ImageSegmenter statico	createFromOptions(Contesto del contesto, ImageSegmenter.ImageSegmenterOptions segmenterOptions) Crea un'istanza `ImageSegmenter` da un `ImageSegmenter.ImageSegmenterOptions`.
List<String>	getLabels() Ottieni l'elenco di etichette delle categorie che il segmento ImageSegmenter è in grado di riconoscere.
ImageSegmenterResult	segment(immagine MPImage, ImageSegmenter.SegmentationOptions segmentationOptions) Esegue la segmentazione dell'immagine singola fornita.
ImageSegmenterResult	segment(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions) Esegue la segmentazione dell'immagine singola fornita.
ImageSegmenterResult	segment(immagine MPImage) Esegue la segmentazione dell'immagine sulla singola immagine fornita con le opzioni di elaborazione delle immagini predefinite, ad esempio
void	segmentAsync(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs) Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini. I risultati saranno disponibili tramite l'`OutputHandler.ResultListener` fornito in `ImageSegmenter.ImageSegmenterOptions`.
void	segmentAsync(MPImage, ImageSegmenter.SegmentationOptions segmentationOptions, timestamp lungoMs) Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini. I risultati saranno disponibili tramite l'`OutputHandler.ResultListener` fornito in `ImageSegmenter.ImageSegmenterOptions`.
void	segmentAsync(immagine MPImage, timestamp lunghiM) Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini con opzioni di elaborazione delle immagini predefinite, ad esempio
ImageSegmenterResult	segmentForVideo(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs) Esegue la segmentazione dell'immagine sul frame video fornito.
ImageSegmenterResult	segmentForVideo(immagine MPImage, timestampM lunghi) Esegue la segmentazione delle immagini sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio
ImageSegmenterResult	segmentForVideo(MPImage, ImageSegmenter.SegmentationOptions segmentazioneOptions, timestamp lungoMs) Esegue la segmentazione dell'immagine sul frame video fornito.
void	segmentForVideoWithResultListener(immagine MPImage, ImageProcessingOptions image elaborazioneOptions, timestamp lungoMs) Esegue la segmentazione delle immagini sul frame video fornito e fornisce risultati copiati tramite `OutputHandler.ResultListener` in `ImageSegmenter.ImageSegmenterOptions`.
void	segmentForVideoWithResultListener(immagine MPImage, ImageSegmenter.SegmentationOptions opzioni di segmentazione, timestamp lunghiMs) Esegue la segmentazione delle immagini sul frame video fornito e fornisce risultati copiati tramite `OutputHandler.ResultListener` in `ImageSegmenter.ImageSegmenterOptions`.
void	segmentForVideoWithResultListener(immagine MPImage, timestampM lungo) Esegue la segmentazione delle immagini sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio
void	segmentWithResultListener(immagine MPImage, ImageProcessingOptions imageElaborazioneOptions) Esegue la segmentazione dell'immagine sulla singola immagine fornita e fornisce risultati copiati tramite `OutputHandler.ResultListener` in `ImageSegmenter.ImageSegmenterOptions`.
void	segmentWithResultListener(immagine MPImage) Esegue la segmentazione dell'immagine sulla singola immagine fornita con le opzioni di elaborazione delle immagini predefinite, ad esempio
void	segmentWithResultListener(immagine MPImage, ImageSegmenter.SegmentationOptions opzioni di segmentazione) Esegue la segmentazione dell'immagine sulla singola immagine fornita e fornisce risultati copiati tramite `OutputHandler.ResultListener` in `ImageSegmenter.ImageSegmenterOptions`.

Metodi ereditati

Dalla classe com.google.mediapipe.tasks.vision.core.BaseVisionTaskApi

void	close() Chiude e pulisce l'attività di visione artificiale di MediaPipe.
statico lungo	generateResultTimestampMs(RunningMode runningMode, pacchetto pacchetto) Genera il timestamp di un oggetto risultato di un'attività di visione dalla modalità di esecuzione dell'attività di visione artificiale e dal pacchetto di output.

Dalla classe java.lang.Object

boolean	uguale a(Object arg0)
final Corso<?>	getClass()
int	hashCode()
finale void	notify()
finale void	notifyAll()
String	toString()
finale void	wait(long arg0, int arg1)
finale void	wait(long arg0)
finale void	wait()

Dall'interfaccia java.lang.AutoCloseable

astratto void

close()

Metodi pubblici

pubblico static ImageSegmenter createFromOptions (Context context, ImageSegmenter.ImageSegmenterOptions segmenterOptions)

Crea un'istanza ImageSegmenter da un ImageSegmenter.ImageSegmenterOptions.

Parametri

context	un `ERROR(/Context)` Android.
segmenterOptions	un'istanza `ImageSegmenter.ImageSegmenterOptions`.

Lanci

	in caso di errore durante la creazione di `ImageSegmenter`.

Public Elenco<String> getLabels ()

Ottieni l'elenco di etichette delle categorie che il segmento ImageSegmenter è in grado di riconoscere. Per il tipo CATEGORY_MASK, l'indice nella maschera della categoria corrisponde alla categoria nell'elenco delle etichette. Per il tipo CONFIDENCE_MASK, l'elenco delle maschere di output nell'indice corrisponde alla categoria nell'elenco delle etichette.

Se non viene fornita alcuna labelmap nel file del modello, viene restituito un elenco di etichette vuoto.

Public ImageSegmenterResult segment (immagine MPImage, ImageSegmenter.SegmentationOptions segmentOptions)

Esegue la segmentazione dell'immagine singola fornita. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
segmentationOptions	`ImageSegmenter.SegmentationOptions` utilizzato per configurare il comportamento di runtime di `ImageSegmenter`.

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

pubblici ImageSegmenterResult segment (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Esegue la segmentazione dell'immagine singola fornita. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE). TODO aggiorna il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
imageProcessingOptions	`ImageProcessingOptions` che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi `ImageProcessingOptions.regionOfInterest()`, questo metodo genererà un'eccezione di IllegalArgumentException.

Lanci

IllegalArgumentException	se `ImageProcessingOptions` specifica una regione di interesse.
	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

Public ImageSegmenterResult segment (MPImage immagine)

Esegue la segmentazione dell'immagine sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE). TODO aggiorna il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

Public void segmentAsync (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)

Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini. I risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al segmenter di immagini. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
imageProcessingOptions	`ImageProcessingOptions` che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi `ImageProcessingOptions.regionOfInterest()`, questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs	il timestamp di input (in millisecondi).

Lanci

IllegalArgumentException	se `ImageProcessingOptions` specifica una regione di interesse.
	in caso di errore interno.

Public void segmentAsync (immagine MPImage, ImageSegmenter.SegmentationOptions segmentOptions, long timestampMs)

Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini. I risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in ImageSegmenter.ImageSegmenterOptions. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al segmenter di immagini. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
segmentationOptions	`ImageSegmenter.SegmentationOptions` utilizzato per configurare il comportamento di runtime di `ImageSegmenter`.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.

Public void segmentAsync (immagine MPImage, timestampM lunghi)

Invia i dati delle immagini in tempo reale per eseguire la segmentazione delle immagini con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e i risultati saranno disponibili tramite l'OutputHandler.ResultListener fornito in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata al segmenter di immagini. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno.

Public ImageSegmenterResult segmentForVideo (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)

Esegue la segmentazione dell'immagine sul frame video fornito. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
imageProcessingOptions	`ImageProcessingOptions` che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi `ImageProcessingOptions.regionOfInterest()`, questo metodo genererà un'eccezione di IllegalArgumentException.
timestampMs	il timestamp di input (in millisecondi).

Lanci

IllegalArgumentException	se `ImageProcessingOptions` specifica una regione di interesse.
	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

Public ImageSegmenterResult segmentForVideo (immagine MPImage, timestamp lungoMs)

Esegue la segmentazione delle immagini sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

pubblici ImageSegmenterResult segmentForVideo (MPImage immagine, ImageSegmenter.SegmentationOptions segmentazioni, timestamp lunghiMs)

Esegue la segmentazione dell'immagine sul frame video fornito. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
segmentationOptions	`ImageSegmenter.SegmentationOptions` utilizzato per configurare il comportamento di runtime di `ImageSegmenter`.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` viene creato con un `OutputHandler.ResultListener`.

Public void segmentForVideoWithResultListener (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions, timestamp lungoMs)

Esegue la segmentazione delle immagini sul frame video fornito e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
imageProcessingOptions
timestampMs	il timestamp di input (in millisecondi).

Lanci

IllegalArgumentException	se `ImageProcessingOptions` specifica una regione di interesse.
	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.

Public void segmentForVideoWithResultListener (immagine MPImage, ImageSegmenter.SegmentationOptions opzioni di segmentazione, timestamp lunghiMs)

Esegue la segmentazione delle immagini sul frame video fornito e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
segmentationOptions	`ImageSegmenter.SegmentationOptions` utilizzato per configurare il comportamento di runtime di `ImageSegmenter`.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.

Public void segmentForVideoWithResultListener (immagine MPImage, timestampM lunghi)

Esegue la segmentazione delle immagini sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.VIDEO).

È necessario fornire il timestamp (in millisecondi) del frame video. I timestamp di input devono essere crescenti in modo monotonico.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
timestampMs	il timestamp di input (in millisecondi).

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.

Public void segmentWithResultListener (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions)

Esegue la segmentazione dell'immagine sulla singola immagine fornita e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE).

TODO aggiorna il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
imageProcessingOptions	`ImageProcessingOptions` che specifica come elaborare l'immagine di input prima di eseguire l'inferenza. Tieni presente che la regione di interesse non è supportata da questa attività: se specifichi `ImageProcessingOptions.regionOfInterest()`, questo metodo genererà un'eccezione di IllegalArgumentException.

Lanci

IllegalArgumentException	se `ImageProcessingOptions` specifica una regione di interesse.
	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.

Public void segmentWithResultListener (immagine MPImage)

Esegue la segmentazione delle immagini sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. La maschera di output ha le stesse dimensioni dell'immagine di input. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE).

TODO aggiorna il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.

Public void segmentWithResultListener (immagine MPImage, ImageSegmenter.SegmentationOptions segmentazioneOptions)

Esegue la segmentazione dell'immagine sulla singola immagine fornita e fornisce risultati copiati tramite OutputHandler.ResultListener in ImageSegmenter.ImageSegmenterOptions. Utilizza questo metodo solo quando ImageSegmenter viene creato con ERROR(/RunningMode.IMAGE).

TODO aggiorna il documento Java per il formato dell'immagine di input.

ImageSegmenter supporta i seguenti tipi di spazi colore:

ERROR(/Bitmap.Config.ARGB_8888)

Parametri

immagine	un oggetto `MPImage` di MediaPipe per l'elaborazione.
segmentationOptions	`ImageSegmenter.SegmentationOptions` utilizzato per configurare il comportamento di runtime di `ImageSegmenter`.

Lanci

	in caso di errore interno. Oppure se `ImageSegmenter` non viene creato con `OutputHandler.ResultListener` impostato in `ImageSegmenter.ImageSegmenterOptions`.