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)
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

Metodi pubblici

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

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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.