FaceStylizer

classe final pública FaceStylizer

Executa a estilização de rostos em imagens.

Além da API de estilização padrão, stylize(MPImage) e ERROR(/#stylizeForVideo), que recebem uma imagem de entrada e retornam as saídas, mas envolvem uma cópia detalhada dos retornos, o FaceStylizer também é compatível com a API de callback, stylizeWithResultListener(MPImage) e ERROR(/#stylizeForVideoWithResultListener), que permitem acessar as saídas por meio de cópia zero durante o listener de resultado.

A API callback está disponível para todos os RunningMode no FaceStylizer. Defina OutputHandler.ResultListener em FaceStylizer.FaceStylizerOptions corretamente para usar a API de callback.

A API espera um modelo do TFLite com TFLite Model Metadata..

  • Imagem de entrada MPImage
    • A imagem em que o estilizador de rostos é executado.
  • MPImage de saída MPImage
    • Uma MPImage contendo um rosto estilizado.

Classes aninhadas

classe FaceStylizer.FaceStylizerOptions Opções para configurar um FaceStylizer. 

Métodos públicos

estático FaceStylizer
createFromOptions(contexto de contexto, FaceStylizer.FaceStylizerOptions stylizerOptions)
Cria uma instância FaceStylizer de um FaceStylizer.FaceStylizerOptions.
FaceStylizerResult
stylize(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa a estilização do rosto na imagem única fornecida.
FaceStylizerResult
stilize(imagem MPImage)
Executa a estilização do rosto na imagem única fornecida com opções de processamento de imagem padrão, ou seja,
void
stylizeWithResultListener(imagem MPImage)
Executa a estilização do rosto na imagem única fornecida com opções de processamento de imagem padrão, ou seja,
void
stylizeWithResultListener(imagem MPImage, ImageProcessingOptions imageprocessingOptions)
Executa a estilização de rostos na imagem única fornecida e fornece resultados copiados de zero a partir de OutputHandler.ResultListener em FaceStylizer.FaceStylizerOptions.

Métodos herdados

Métodos públicos

public Static FaceStylizer createFromOptions (Contexto de contexto, FaceStylizer.FaceStylizerOptions stylizerOptions)

Cria uma instância FaceStylizer de um FaceStylizer.FaceStylizerOptions.

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

public FaceStylizerResult estilizar (MPImage, ImageProcessingOptions image ProcessingOptions)

Executa a estilização do rosto na imagem única fornecida. Use esse método somente quando o FaceStylizer for criado com RunningMode.IMAGE.

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

A imagem de entrada pode ter qualquer tamanho. A imagem de saída é a imagem estilizada com o rosto mais visível. O tamanho da imagem de saída estilizada é igual ao tamanho da saída do modelo. Quando nenhum rosto é detectado na imagem de entrada, Optional.empty() é retornado.

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. Ou se FaceStylizer for criado com um OutputHandler.ResultListener.

public FaceStylizerResult estilizar (MPImage)

Executa a estilização do rosto na imagem única fornecida com opções de processamento de imagem padrão, ou seja, sem aplicação de qualquer rotação. Use esse método somente quando o FaceStylizer for criado com RunningMode.IMAGE.

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

A imagem de entrada pode ter qualquer tamanho. A imagem de saída é a imagem estilizada com o rosto mais visível. O tamanho da imagem de saída estilizada é igual ao tamanho da saída do modelo. Quando nenhum rosto é detectado na imagem de entrada, Optional.empty() é retornado.

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
caso haja um erro interno. Ou se FaceStylizer for criado com um OutputHandler.ResultListener.

public void stylizeWithResultListener (MPImage imagem)

Executa a estilização de rostos na imagem única fornecida com opções de processamento de imagem padrão, ou seja, sem nenhuma rotação aplicada, e fornece resultados sem cópia por OutputHandler.ResultListener em FaceStylizer.FaceStylizerOptions. Use esse método somente quando o FaceStylizer for criado com RunningMode.IMAGE.

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

A imagem de entrada pode ter qualquer tamanho. A imagem de saída é a imagem estilizada com o rosto mais visível. O tamanho da imagem de saída estilizada é igual ao tamanho da saída do modelo. Quando nenhum rosto é detectado na imagem de entrada, Optional.empty() é retornado.

Parâmetros
imagem um objeto MPImage do MediaPipe para processamento.
Gera
IllegalArgumentException se ImageProcessingOptions especificar uma região de interesse.
caso haja um erro interno. Ou se FaceStylizer não foi criado com OutputHandler.ResultListener definido em FaceStylizer.FaceStylizerOptions.

public void stylizeWithResultListener (MPImage imagem, ImageProcessingOptions image ProcessingOptions)

Executa a estilização de rostos na imagem única fornecida e fornece resultados copiados de zero a partir de OutputHandler.ResultListener em FaceStylizer.FaceStylizerOptions. Use esse método somente quando o FaceStylizer for criado com RunningMode.IMAGE.

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

A imagem de entrada pode ter qualquer tamanho. A imagem de saída é a imagem estilizada com o rosto mais visível. O tamanho da imagem de saída estilizada é igual ao tamanho da saída do modelo. Quando nenhum rosto é detectado na imagem de entrada, Optional.empty() é retornado.

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. Ou se FaceStylizer não foi criado com OutputHandler.ResultListener definido em FaceStylizer.FaceStylizerOptions.