FaceLandmarker

clase final pública FaceLandmarker

Realiza la detección de puntos de referencia faciales en las imágenes.

Esta API espera un paquete de recursos de modelo de puntos de referencia de rostros previamente entrenado. Consulta .

  • Imagen de entrada MPImage
    • La imagen en la que se ejecuta la detección de puntos de referencia de rostros.
  • Salida FaceLandmarkerResult
    • Un FaceLandmarkerResult que contiene puntos de referencia de rostros.

Categorías anidadas

clase FaceLandmarker.FaceLandmarkerOptions Opciones para configurar un FaceLandmarker

Campos

público estático final Set<Connection> FACE_LANDMARKS_CONNECTORS
público estático final Set<Connection> FACE_LANDMARKS_FACE_OVAL
público estático final Set<Connection> FACE_LANDMARKS_LEFT_EYE
público estático final Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW
público estático final Set<Connection> FACE_LANDMARKS_LEFT_IRIS
público estático final Set<Connection> FACE_LANDMARKS_LIPS
público estático final Set<Connection> FACE_LANDMARKS_RIGHT_EYE
público estático final Set<Connection> FACE_LANDMARKS_RIGHT_EYE_BROW
público estático final Set<Connection> FACE_LANDMARKS_RIGHT_IRIS
público estático final Set<Connection> FACE_LANDMARKS_TESSELATION

Métodos públicos

estático FaceLandmarker
createFromBuffer(contexto de contexto, modelAssetBuffer de ByteBuffer)
Crea una instancia FaceLandmarker a partir de un búfer de paquete de recursos de modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.
estático FaceLandmarker
createFromFile(contexto de contexto, String modelAssetPath)
Crea una instancia FaceLandmarker a partir de la ruta de un paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.
estático FaceLandmarker
createFromFile(contexto de contexto, archivo modelAssetFile)
Crea una instancia FaceLandmarker a partir de un archivo de paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.
estático FaceLandmarker
createFromOptions(contexto de contexto, FaceLandmarker.FaceLandmarkerOptions puntos de referencia de)
Crea una instancia de FaceLandmarker a partir de un FaceLandmarker.FaceLandmarkerOptions.
FaceLandmarkerResult
detect(imagen MPImage)
Realiza la detección de puntos de referencia facial en la imagen única proporcionada con las opciones de procesamiento de imágenes predeterminadas, es decir,
FaceLandmarkerResult
detect(imagen MPImage, ImageProcessingOptions imageProcessingOptions)
Realiza la detección de puntos de referencia faciales en la imagen única proporcionada.
void
detectAsync(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales, y los resultados estarán disponibles a través del OutputHandler.ResultListener proporcionado en FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(imagen MPImage, timestampMs largo)
Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales con las opciones de procesamiento de imágenes predeterminadas, p.ej.,
FaceLandmarkerResult
detectForVideo(imagen MPImage, ImageProcessingOptions imageProcessingOptions, marca de tiempo largaMs)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado.
FaceLandmarkerResult
detectForVideo(imagen MPImage, timestampMs largo)
Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado con las opciones de procesamiento de imágenes predeterminadas, es decir,

Métodos heredados

Campos

público estático final Set<Connection> FACE_LANDMARKS_CONNECTORS

público estático final Set<Connection> FACE_LANDMARKS_FACE_OVAL

público estático final Set<Connection> FACE_LANDMARKS_LEFT_EYE

público estático final Set<Connection> FACE_LANDMARKS_LEFT_EYE_BROW

público estático final Set<Connection> FACE_LANDMARKS_LEFT_IRIS

público estático final Configurar<Conexión> FACE_LANDMARKS_LIPS

público estático final Establecer<Conexión> FACE_LANDMARKS_RIGHT_EYE

público estático final Configurar<Conexión> FACE_LANDMARKS_RIGHT_EYE_BROW

público estático final Configurar<Conexión> FACE_LANDMARKS_RIGHT_IRIS

público estático final Establecer<Conexión> FACE_LANDMARKS_TESSELATION

Métodos públicos

publica estática estática FaceLandmarker createFromBuffer (contexto de contexto, ByteBuffer modelAssetBuffer)

Crea una instancia FaceLandmarker a partir de un búfer de paquete de recursos de modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.

Parámetros
Contexto un ERROR(/Context) de Android
modelAssetBuffer
Arroja
Si se produce un error durante la creación de FaceLandmarker.

estático público FaceLandmarker createFromFile (contexto de contexto, String modelAssetPath)

Crea una instancia FaceLandmarker a partir de la ruta de un paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.

Parámetros
Contexto un ERROR(/Context) de Android
modelAssetPath ruta de acceso al modelo de puntos de referencia de rostros con metadatos en los recursos.
Arroja
Si se produce un error durante la creación de FaceLandmarker.

estático público FaceLandmarker createFromFile (contexto de contexto, archivo modelAssetFile)

Crea una instancia FaceLandmarker a partir de un archivo de paquete de recursos del modelo y el FaceLandmarker.FaceLandmarkerOptions predeterminado.

Parámetros
Contexto un ERROR(/Context) de Android
modelAssetFile la instancia File del modelo de puntos de referencia de rostros.
Arroja
IOException si se produce un error de E/S cuando se abre el archivo del modelo de tflite.
Si se produce un error durante la creación de FaceLandmarker.

público estático FaceLandmarker createFromOptions (contexto de contexto, FaceLandmarker.FaceLandmarkerOptions puntos de referencia de opciones)

Crea una instancia de FaceLandmarker a partir de un FaceLandmarker.FaceLandmarkerOptions.

Parámetros
Contexto un ERROR(/Context) de Android
landmarkerOptions una instancia de FaceLandmarker.FaceLandmarkerOptions.
Arroja
Si se produce un error durante la creación de FaceLandmarker.

public FaceLandmarkerResult detect (imagen de MPImage)

Realiza la detección de puntos de referencia facial en la imagen única proporcionada con las opciones de procesamiento de imagen predeterminadas, es decir, sin ninguna rotación. Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.IMAGE). TODO update java doc para el formato de imagen de entrada.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
Arroja
si se produce un error interno.

público FaceLandmarkerResult detect (MPImage imagen, ImageProcessingOptions imageProcessingOptions)

Realiza la detección de puntos de referencia faciales en la imagen única proporcionada. Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.IMAGE). TODO update java doc para el formato de imagen de entrada.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
imageProcessingOptions ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException.
Arroja
IllegalArgumentException si ImageProcessingOptions especifica una región de interés.
si se produce un error interno.

public void detectAsync (imagen MPImage, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Envía datos de imágenes en vivo para realizar la detección de puntos de referencia faciales, y los resultados estarán disponibles a través del OutputHandler.ResultListener proporcionado en FaceLandmarker.FaceLandmarkerOptions. Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.LIVE_STREAM).

Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia facial. Las marcas de tiempo de entrada deben aumentar monótonamente.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
imageProcessingOptions ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException.
timestampMs la marca de tiempo de entrada (en milisegundos).
Arroja
IllegalArgumentException si ImageProcessingOptions especifica una región de interés.
si se produce un error interno.

public void detectAsync (imagen MPImage, timestampMs largo)

Envía datos de imágenes en vivo para realizar la detección de puntos de referencia facial con opciones de procesamiento de imagen predeterminadas (es decir, sin rotación), y los resultados estarán disponibles a través del OutputHandler.ResultListener proporcionado en FaceLandmarker.FaceLandmarkerOptions. Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.LIVE_STREAM).

Se debe proporcionar una marca de tiempo (en milisegundos) para indicar cuándo se envía la imagen de entrada al punto de referencia facial. Las marcas de tiempo de entrada deben aumentar monótonamente.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
timestampMs la marca de tiempo de entrada (en milisegundos).
Arroja
si se produce un error interno.

público FaceLandmarkerResult detectForVideo (MPImage imagen, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado. Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.VIDEO).

Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
imageProcessingOptions ImageProcessingOptions que especifica cómo procesar la imagen de entrada antes de ejecutar la inferencia. Ten en cuenta que la región de interés no es compatible con esta tarea: especificar ImageProcessingOptions.regionOfInterest() hará que este método arroje una IllegalArgumentException.
timestampMs la marca de tiempo de entrada (en milisegundos).
Arroja
IllegalArgumentException si ImageProcessingOptions especifica una región de interés.
si se produce un error interno.

público FaceLandmarkerResult detectForVideo (MPImage imagen, timestampMs largo)

Realiza la detección de puntos de referencia faciales en el fotograma de video proporcionado con las opciones de procesamiento de imágenes predeterminadas (es decir, sin aplicar ninguna rotación). Usa este método solo cuando se cree el FaceLandmarker con ERROR(/RunningMode.VIDEO).

Es obligatorio proporcionar la marca de tiempo del fotograma del video (en milisegundos). Las marcas de tiempo de entrada deben aumentar de forma monótona.

FaceLandmarker admite los siguientes tipos de espacios de color:

Parámetros
imagen un objeto MPImage de MediaPipe para su procesamiento
timestampMs la marca de tiempo de entrada (en milisegundos).
Arroja
si se produce un error interno.