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)
Cria uma instância de
FaceLandmarker de um FaceLandmarker.FaceLandmarkerOptions . |
FaceLandmarkerResult | |
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
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)
Cria uma instância de FaceLandmarker
de um FaceLandmarker.FaceLandmarkerOptions
.
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. |