FaceLandmarker

classe pubblica finale FaceLandmarker

Esegue il rilevamento dei punti di riferimento dei volti sulle immagini.

Questa API prevede un bundle di asset del modello di punti di riferimento del volto preaddestrato. Vedere la sezione .

  • Immagine di input MPImage
    • L'immagine su cui viene eseguita il rilevamento dei punti di riferimento.
  • Output FaceLandmarkerResult
    • Un FaceLandMarkResult che contiene i punti di riferimento per i volti.

Corsi nidificati

classe FaceLandmarker.FaceLandmarkerOptions Opzioni per configurare un FaceLandmarker

Campi

pubblico statico finale Set<Connection> FACE_LANDMARKS_CONNECTORS
pubblico statico finale Set<Connection> FACE_LANDMARKS_FACE_OVAL
pubblico statico finale Set<Connection> FACE_LANDMARKS_LEFT_EYE
pubblico statico finale Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
pubblico statico finale Set<Connection> FACE_LANDMARKS_LEFT_IRIS
pubblico statico finale Set<Connection> FACE_LANDMARKS_LIPS
pubblico statico finale Set<Connection> FACE_LANDMARKS_RIGHT_EYE
pubblico statico finale Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
pubblico statico finale Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
pubblico statico finale Set<Connection> FACE_LANDMARKS_TESSELATION

Metodi pubblici

statico FaceLandmarker
createFromBuffer(Context context, ByteBuffer modelAssetBuffer)
Crea un'istanza FaceLandmarker da un buffer del bundle di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions.
statico FaceLandmarker
createFromFile(Contesto del contesto, Stringa modelAssetPath)
Crea un'istanza FaceLandmarker da un percorso del pacchetto di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions.
statico FaceLandmarker
createFromFile(Contesto del contesto, File modelAssetFile)
Crea un'istanza FaceLandmarker da un file di bundle di asset modello e il valore predefinito FaceLandmarker.FaceLandmarkerOptions.
statico FaceLandmarker
FaceLandmarkerResult
detect(immagine MPImage)
Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ad esempio
FaceLandmarkerResult
detect(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)
Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita.
void
detectAsync(MPImage immagine, ImageProcessingOptions image elaborazioneOptions, timestamp lunghiMs)
Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento del volto e i risultati saranno disponibili tramite il OutputHandler.ResultListener fornito in FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(immagine MPImage, timestamp lunghiM)
Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento del volto con opzioni di elaborazione delle immagini predefinite, ad esempio
FaceLandmarkerResult
detectForVideo(MPImage immagine, ImageProcessingOptions imageElaborazioneOptions, timestamp lunghiMs)
Esegue il rilevamento dei punti di riferimento del volto sul fotogramma video fornito.
FaceLandmarkerResult
detectForVideo(immagine MPImage, timestamp lunghiM)
Esegue il rilevamento dei punti di riferimento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ad esempio

Metodi ereditati

Campi

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_CONNECTORS

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_FACE_OVAL

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_LEFT_EYE

pubblico statico finale Imposta<Connessione> FACE_LANDMARKS_LEFT_EYE_BROW

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_LEFT_IRIS

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_LIPS

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_RIGHT_EYE

statica pubblica finale Imposta<Connessione> FACE_LANDMARKS_RIGHT_EYE_BROW

statico pubblico finale Imposta<Connessione> FACE_LANDMARKS_RIGHT_IRIS

pubblico statico finale Imposta<Connessione> FACE_LANDMARKS_TESSELATION

Metodi pubblici

pubblico statico FaceLandmarker createFromBuffer (Context context, ByteBuffer modelAssetBuffer)

Crea un'istanza FaceLandmarker da un buffer del bundle di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelAssetBuffer
Lanci
in caso di errore durante la creazione di FaceLandmarker.

pubblico statico FaceLandmarker createFromFile (Context context, String modelAssetPath)

Crea un'istanza FaceLandmarker da un percorso del pacchetto di asset modello e dal valore predefinito FaceLandmarker.FaceLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelAssetPath percorso del modello dei punti di riferimento dei volti con metadati nelle risorse.
Lanci
in caso di errore durante la creazione di FaceLandmarker.

pubblico statico FaceLandmarker createFromFile (Context context, File modelAssetFile)

Crea un'istanza FaceLandmarker da un file di bundle di asset modello e il valore predefinito FaceLandmarker.FaceLandmarkerOptions.

Parametri
context un ERROR(/Context) Android.
modelAssetFile l'istanza del modello File dei punti di riferimento dei volti.
Lanci
IOException se si verifica un errore I/O all'apertura del file del modello tflite.
in caso di errore durante la creazione di FaceLandmarker.

pubblico statico FaceLandmarker createFromOptions (Context context, FaceLandmarker.FaceLandmarkerOptions LandmarkerOptions)

Parametri
context un ERROR(/Context) Android.
landmarkerOptions un'istanza FaceLandmarker.FaceLandmarkerOptions.
Lanci
in caso di errore durante la creazione di FaceLandmarker.

pubblici FaceLandmarkerResult detect (MPImage immagine)

Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceLandmarker viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

FaceLandmarker supporta i seguenti tipi di spazi colore:

Parametri
immagine un oggetto MPImage di MediaPipe per l'elaborazione.
Lanci
in caso di errore interno.

pubblici FaceLandmarkerResult detect (MPImage immagine, ImageProcessingOptions imageElaborazioneOptions)

Esegue il rilevamento dei punti di riferimento dei volti sulla singola immagine fornita. Utilizza questo metodo solo quando FaceLandmarker viene creato con ERROR(/RunningMode.IMAGE). DA FARE aggiornare il documento Java per il formato dell'immagine di input.

FaceLandmarker 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.

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

Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento del volto e i risultati saranno disponibili tramite il OutputHandler.ResultListener fornito in FaceLandmarker.FaceLandmarkerOptions. Utilizza questo metodo solo quando FaceLandmarker viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'elemento di riferimento dei volti. I timestamp di input devono essere crescenti in modo monotonico.

FaceLandmarker 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 detectAsync (immagine MPImage, timestamp lunghiM)

Invia i dati delle immagini in tempo reale per il rilevamento dei punti di riferimento del volto con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione, e i risultati saranno disponibili tramite il OutputHandler.ResultListener fornito in FaceLandmarker.FaceLandmarkerOptions. Utilizza questo metodo solo quando FaceLandmarker viene creato con ERROR(/RunningMode.LIVE_STREAM).

È necessario fornire un timestamp (in millisecondi) per indicare quando l'immagine di input viene inviata all'elemento di riferimento dei volti. I timestamp di input devono essere crescenti in modo monotonico.

FaceLandmarker 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.

pubblici FaceLandmarkerResult detectForVideo (MPImage immagine, ImageProcessingOptions imageProcessOptions, timestamp lunghiMs)

Esegue il rilevamento dei punti di riferimento del volto sul fotogramma video fornito. Utilizza questo metodo solo quando FaceLandmarker 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.

FaceLandmarker 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.

pubblici FaceLandmarkerResult detectForVideo (immagine MPImage, timestamp lungoMs)

Esegue il rilevamento dei punti di riferimento dei volti sul frame video fornito con opzioni di elaborazione delle immagini predefinite, ovvero senza alcuna rotazione applicata. Utilizza questo metodo solo quando FaceLandmarker 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.

FaceLandmarker 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.