FaceLandmarker

classe final pública FaceLandmarker

Detecta pontos de referência faciais em imagens.

Essa API espera um pacote de recursos de modelo de pontos de referência pré-treinados. Consulte .

  • Imagem de entrada MPImage
    • A imagem em que a detecção de pontos de referência é executada.
  • Saída FaceLandmarkerResult
    • Um FaceLandmarkerResult contendo pontos de referência de rostos.

Classes aninhadas

classe FaceLandmarker.FaceLandmarkerOptions Opções para configurar um 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, ByteBuffer modelAssetBuffer)
Cria uma instância de FaceLandmarker com base em um buffer de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.
estático FaceLandmarker
createFromFile(contexto de contexto, String modelAssetPath)
Cria uma instância de FaceLandmarker com base em um caminho de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.
estático FaceLandmarker
createFromFile(contexto de contexto, File modelAssetFile)
Cria uma instância de FaceLandmarker com base em um arquivo de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.
estático FaceLandmarker
createFromOptions(Contexto do contexto, FaceLandmarker.FaceLandmarkerOptions marcoerOptions)
FaceLandmarkerResult
detect(imagem MPImage)
Executa detecção de pontos de referência faciais na imagem única fornecida com opções de processamento de imagem padrão, ou seja,
FaceLandmarkerResult
detect(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa detecção de pontos de referência faciais na imagem fornecida.
void
detectAsync(imagem MPImage, ImageProcessingOptions imageHandlingOptions, carimbos de data/hora longos)
Envia dados de imagens em tempo real para realizar a detecção de pontos de referência faciais. Os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no FaceLandmarker.FaceLandmarkerOptions.
void
detectAsync(imagem MPImage, carimbos de data/hora longos)
Envia dados de imagem em tempo real para realizar detecção de pontos de referência faciais com as opções de processamento de imagem padrão, ou seja,
FaceLandmarkerResult
detectForVideo(imagem MPImage, ImageProcessingOptions imageprocessingOptions, carimbos de data/hora longos)
Executa detecção de pontos de referência faciais no frame de vídeo fornecido.
FaceLandmarkerResult
detectForVideo(imagem MPImage, carimbos de data/hora longos)
Executa detecção de pontos de referência faciais no frame de vídeo fornecido com as opções de processamento de imagem padrão, ou seja,

Métodos herdados

Campos

público estático final Definir<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 Definir<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 Definir<Connection> FACE_LANDMARKS_RIGHT_IRIS

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

Métodos públicos

público estático FaceLandmarker createFromBuffer (contexto de contexto, ByteBuffer modelAssetBuffer)

Cria uma instância de FaceLandmarker com base em um buffer de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelAssetBuffer
Gera
se houver um erro durante a criação de FaceLandmarker.

public estático FaceLandmarker createFromFile (contexto de contexto, String modelAssetPath)

Cria uma instância de FaceLandmarker com base em um caminho de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelAssetPath caminho para o modelo de pontos de referência do rosto com metadados nos recursos.
Gera
se houver um erro durante a criação de FaceLandmarker.

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

Cria uma instância de FaceLandmarker com base em um arquivo de pacote de recursos de modelo e o FaceLandmarker.FaceLandmarkerOptions padrão.

Parâmetros
contexto um ERROR(/Context) do Android.
modelAssetFile a instância File do modelo de pontos de referência de rostos.
Gera
IOException se ocorrer um erro de E/S ao abrir o arquivo do modelo do tflite.
se houver um erro durante a criação de FaceLandmarker.

public Static FaceLandmarker createFromOptions (Contexto de contexto, FaceLandmarker.FaceLandmarkerOptions marcoerOptions)

Parâmetros
contexto um ERROR(/Context) do Android.
landmarkerOptions uma instância FaceLandmarker.FaceLandmarkerOptions.
Gera
se houver um erro durante a criação de FaceLandmarker.

public FaceLandmarkerResult detect (MPImage)

Executa detecção de pontos de referência faciais na imagem única fornecida com opções de processamento padrão, ou seja, sem aplicação de rotação. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.IMAGE). TODO atualização do documento Java para o formato da imagem de entrada.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
caso haja um erro interno.

public FaceLandmarkerResult detect (MPImage, ImageProcessingOptions imageprocessingOptions)

Executa detecção de pontos de referência faciais na imagem fornecida. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.IMAGE). TODO update java doc para o formato da imagem de entrada.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public void detectAsync (MPImage imagem, ImageProcessingOptions image ProcessingOptions, long timestampMs)

Envia dados de imagens em tempo real para realizar a detecção de pontos de referência faciais. Os resultados ficam disponíveis pelo OutputHandler.ResultListener fornecido no FaceLandmarker.FaceLandmarkerOptions. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada para o ponto de referência do rosto. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public void detectAsync (MPImage imagem, carimbos de data/hora longos)

Envia dados de imagens em tempo real para realizar detecção de pontos de referência faciais com opções de processamento de imagem padrão, ou seja, sem nenhuma rotação aplicada, e os resultados estarão disponíveis pelo OutputHandler.ResultListener fornecido no FaceLandmarker.FaceLandmarkerOptions. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.LIVE_STREAM).

É necessário informar um carimbo de data/hora (em milissegundos) para indicar quando a imagem de entrada é enviada para o ponto de referência do rosto. Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.

public FaceLandmarkerResult detectForVideo (MPImage image, ImageProcessingOptions imageProcessingOptions, long timestampMs)

Executa detecção de pontos de referência faciais no frame de vídeo fornecido. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
imageProcessingOptions o ImageProcessingOptions que especifica como processar a imagem de entrada antes de executar a inferência. Essa tarefa não oferece suporte à região de interesse: especificar ImageProcessingOptions.regionOfInterest() fará com que esse método gere uma IllegalArgumentException.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno.

public FaceLandmarkerResult detectForVideo (MPImage image, long timestampMs)

Executa detecção de pontos de referência faciais no frame de vídeo fornecido com opções de processamento de imagem padrão, ou seja, sem aplicação de rotação. Use esse método somente quando o FaceLandmarker for criado com ERROR(/RunningMode.VIDEO).

É necessário fornecer o carimbo de data/hora do frame do vídeo (em milissegundos). Os carimbos de data/hora de entrada precisam aumentar monotonicamente.

FaceLandmarker oferece suporte aos seguintes tipos de espaço de cores:

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
timestampMs o carimbo de data/hora de entrada (em milissegundos).
Gera
caso haja um erro interno.