FaceStylizer

classe pubblica finale FaceStylizer

Consente di stilizzare i volti sulle immagini.

Tieni presente che, oltre all'API di stilizzazione standard, stylize(MPImage) e ERROR(/#stylizeForVideo), che acquisiscono un'immagine di input e restituiscono gli output, ma richiedono una copia approfondita dei ritorni, FaceStylizer supporta anche l'API di callback, stylizeWithResultListener(MPImage) e ERROR(/#stylizeForVideoWithResultListener), che consentono di accedere agli output tramite copia zero per la durata del listener dei risultati.

L'API di callback è disponibile per tutti i RunningMode in FaceStylizer. Imposta OutputHandler.ResultListener correttamente in FaceStylizer.FaceStylizerOptions 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 lo stilizzazione del volto.
  • MPImage di output MPImage
    • Un file MPImage contenente un volto stilizzato.

Corsi nidificati

classe FaceStylizer.FaceStylizerOptions Opzioni per configurare un FaceStylizer. 

Metodi pubblici

statico FaceStylizer
createFromOptions(Contesto del contesto, FaceStylizer.FaceStylizerOptions stylizerOptions)
Crea un'istanza FaceStylizer da un FaceStylizer.FaceStylizerOptions.
FaceStylizerResult
stilizza(immagine MPImage, ImageProcessingOptions image elaborazioneOptions)
Consente di stilizzare i volti sulla singola immagine fornita.
FaceStylizerResult
stilizza(immagine MPImage)
Esegue la stilizzazione dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
void
stylizeWithResultListener(immagine MPImage)
Esegue la stilizzazione dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
void
stylizeWithResultListener(immagine MPImage, ImageProcessingOptions imageElaborazioneOptions)
Esegue la stilizzazione dei volti sulla singola immagine fornita e fornisce risultati copiati tramite OutputHandler.ResultListener in FaceStylizer.FaceStylizerOptions.

Metodi ereditati

Metodi pubblici

pubblico statico FaceStylizer createFromOptions (Context context, FaceStylizer.FaceStylizerOptions stylizerOptions)

Crea un'istanza FaceStylizer da un FaceStylizer.FaceStylizerOptions.

Parametri
context un ERROR(/Context) Android.
stylizerOptions un'istanza FaceStylizer.FaceStylizerOptions.
Lanci
in caso di errore durante la creazione di FaceStylizer.

pubblici FaceStylizerResult stilizza (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Consente di stilizzare i volti sulla singola immagine fornita. Utilizza questo metodo solo quando FaceStylizer viene creato con RunningMode.IMAGE.

FaceStylizer supporta i seguenti tipi di spazi colore:

L'immagine di input può essere di qualsiasi dimensione. L'immagine di output è l'immagine stilizzata con il volto più visibile. Le dimensioni dell'immagine di output stilizzata corrispondono a quelle del modello. Quando non viene rilevato alcun volto nell'immagine di input, restituisce Optional.empty().

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 FaceStylizer viene creato con un OutputHandler.ResultListener.

pubblica FaceStylizerResult stilizza (MPImage immagine)

Esegue la stilizzazione dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceStylizer viene creato con RunningMode.IMAGE.

FaceStylizer supporta i seguenti tipi di spazi colore:

L'immagine di input può essere di qualsiasi dimensione. L'immagine di output è l'immagine stilizzata con il volto più visibile. Le dimensioni dell'immagine di output stilizzata corrispondono a quelle del modello. Quando non viene rilevato alcun volto nell'immagine di input, restituisce Optional.empty().

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
in caso di errore interno. Oppure se FaceStylizer viene creato con un OutputHandler.ResultListener.

Public void stylizeWithResultListener (immagine MPImage)

Esegue la stilizzazione dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata, e fornisce risultati con zero copie tramite OutputHandler.ResultListener in FaceStylizer.FaceStylizerOptions. Utilizza questo metodo solo quando FaceStylizer viene creato con RunningMode.IMAGE.

FaceStylizer supporta i seguenti tipi di spazi colore:

L'immagine di input può essere di qualsiasi dimensione. L'immagine di output è l'immagine stilizzata con il volto più visibile. Le dimensioni dell'immagine di output stilizzata corrispondono a quelle del modello. Quando non viene rilevato alcun volto nell'immagine di input, restituisce Optional.empty().

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
IllegalArgumentException se ImageProcessingOptions specifica una regione di interesse.
in caso di errore interno. Oppure se FaceStylizer non viene creato con OutputHandler.ResultListener impostato in FaceStylizer.FaceStylizerOptions.

Public void stylizeWithResultListener (immagine MPImage, ImageProcessingOptions imageElaborazioneOptions)

Esegue la stilizzazione dei volti sulla singola immagine fornita e fornisce risultati copiati tramite OutputHandler.ResultListener in FaceStylizer.FaceStylizerOptions. Utilizza questo metodo solo quando FaceStylizer viene creato con RunningMode.IMAGE.

FaceStylizer supporta i seguenti tipi di spazi colore:

L'immagine di input può essere di qualsiasi dimensione. L'immagine di output è l'immagine stilizzata con il volto più visibile. Le dimensioni dell'immagine di output stilizzata corrispondono a quelle del modello. Quando non viene rilevato alcun volto nell'immagine di input, restituisce Optional.empty().

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 FaceStylizer non viene creato con OutputHandler.ResultListener impostato in FaceStylizer.FaceStylizerOptions.