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