Effectue un stylisation du visage sur les images.
Notez qu'en plus de l'API de stylisation standard stylize(MPImage) et ERROR(/#stylizeForVideo), qui prend une image d'entrée et renvoie les sorties, mais implique une copie complète des retours, FaceStylizer est également compatible avec l'API de rappel, stylizeWithResultListener(MPImage) et ERROR(/#stylizeForVideoWithResultListener), qui vous permettent d'accéder aux sorties via zéro copie pendant toute la durée de l'écouteur du résultat.
L'API de rappel est disponible pour tous les RunningMode dans FaceStylizer. Définissez correctement OutputHandler.ResultListener dans FaceStylizer.FaceStylizerOptions pour utiliser l'API de rappel.
L'API attend un modèle TFLite avec les métadonnées de modèle TFLite.
Classes imbriquées
| classe | FaceStylizer.FaceStylizerOptions | Options de configuration d'un FaceStylizer. |
|
Méthodes publiques
| FaceStylizer |
createFromOptions(Contexte, FaceStylizer.FaceStylizerOptions stylizerOptions)
Crée une instance
FaceStylizer à partir d'un FaceStylizer.FaceStylizerOptions. |
| FaceStylizerResult |
stylize(image MPImage, ImageProcessingOptions imageProcessingOptions)
Effectue une stylisation du visage sur l'image unique fournie.
|
| FaceStylizerResult | |
| void |
stylizeWithResultListener(image MPImage)
Effectue un stylisation du visage sur l'image unique fournie avec des options de traitement d'image par défaut, par exemple
|
| void |
stylizeWithResultListener(image MPImage, ImageProcessingOptions imageProcessingOptions)
Effectue une stylisation du visage sur l'image unique fournie et fournit des résultats sans copie via
OutputHandler.ResultListener dans FaceStylizer.FaceStylizerOptions. |
Méthodes héritées
Méthodes publiques
public statique FaceStylizer createFromOptions (Contexte, FaceStylizer.FaceStylizerOptions stylizerOptions)
Crée une instance FaceStylizer à partir d'un FaceStylizer.FaceStylizerOptions.
Paramètres
| context | un ERROR(/Context) Android. |
|---|---|
| stylizerOptions | une instance FaceStylizer.FaceStylizerOptions. |
Génère
si une erreur se produit lors de la création de FaceStylizer.
|
public FaceStylizerResult stylize (MPImage image, ImageProcessingOptions imageProcessingOptions)
Effectue une stylisation du visage sur l'image unique fournie. N'utilisez cette méthode que lorsque le FaceStylizer est créé avec RunningMode.IMAGE.
FaceStylizer accepte les types d'espaces colorimétriques suivants:
L'image d'entrée peut être de n'importe quelle taille. L'image de sortie est l'image stylisée avec le visage le plus visible. La taille stylisée de l'image de sortie est identique à la taille de sortie du modèle. Si aucun visage n'est détecté sur l'image d'entrée, renvoie Optional.empty().
Paramètres
| Image | un objet MPImage MediaPipe à traiter. |
|---|---|
| imageProcessingOptions | Le ImageProcessingOptions, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez ImageProcessingOptions.regionOfInterest(), cette méthode générera une exception IllegalArgumentException. |
Génère
| IllegalArgumentException | si ImageProcessingOptions spécifie une région d'intérêt. |
|---|---|
en cas d'erreur interne. Ou si FaceStylizer est créé avec un OutputHandler.ResultListener.
|
public FaceStylizerResult stylize (MPImage image)
Effectue une stylisation du visage sur l'image unique fournie avec des options de traitement d'image par défaut, c'est-à-dire sans appliquer de rotation. N'utilisez cette méthode que lorsque le FaceStylizer est créé avec RunningMode.IMAGE.
FaceStylizer accepte les types d'espaces colorimétriques suivants:
L'image d'entrée peut être de n'importe quelle taille. L'image de sortie est l'image stylisée avec le visage le plus visible. La taille stylisée de l'image de sortie est identique à la taille de sortie du modèle. Si aucun visage n'est détecté sur l'image d'entrée, renvoie Optional.empty().
Paramètres
| Image | un objet MPImage MediaPipe à traiter. |
|---|
Génère
en cas d'erreur interne. Ou si FaceStylizer est créé avec un OutputHandler.ResultListener.
|
public void stylizeWithResultListener (image MPImage)
Effectue une stylisation du visage sur l'image unique fournie avec des options de traitement d'image par défaut, c'est-à-dire sans appliquer de rotation, et fournit des résultats zéro copie via OutputHandler.ResultListener dans FaceStylizer.FaceStylizerOptions. N'utilisez cette méthode que lorsque le FaceStylizer est créé avec RunningMode.IMAGE.
FaceStylizer accepte les types d'espaces colorimétriques suivants:
L'image d'entrée peut être de n'importe quelle taille. L'image de sortie est l'image stylisée avec le visage le plus visible. La taille stylisée de l'image de sortie est identique à la taille de sortie du modèle. Si aucun visage n'est détecté sur l'image d'entrée, renvoie Optional.empty().
Paramètres
| Image | un objet MPImage MediaPipe à traiter. |
|---|
Génère
| IllegalArgumentException | si ImageProcessingOptions spécifie une région d'intérêt. |
|---|---|
en cas d'erreur interne. Ou si FaceStylizer n'est pas créé avec OutputHandler.ResultListener défini dans FaceStylizer.FaceStylizerOptions.
|
public void stylizeWithResultListener (image MPImage, ImageProcessingOptions imageProcessingOptions)
Effectue une stylisation du visage sur l'image unique fournie et fournit des résultats sans copie via OutputHandler.ResultListener dans FaceStylizer.FaceStylizerOptions. N'utilisez cette méthode que lorsque le FaceStylizer est créé avec RunningMode.IMAGE.
FaceStylizer accepte les types d'espaces colorimétriques suivants:
L'image d'entrée peut être de n'importe quelle taille. L'image de sortie est l'image stylisée avec le visage le plus visible. La taille stylisée de l'image de sortie est identique à la taille de sortie du modèle. Si aucun visage n'est détecté sur l'image d'entrée, renvoie Optional.empty().
Paramètres
| Image | un objet MPImage MediaPipe à traiter. |
|---|---|
| imageProcessingOptions | Le ImageProcessingOptions, qui indique comment traiter l'image d'entrée avant d'exécuter l'inférence. Notez que la valeur de la région d'intérêt n'est pas prise en charge par cette tâche. Si vous spécifiez ImageProcessingOptions.regionOfInterest(), cette méthode générera une exception IllegalArgumentException. |
Génère
| IllegalArgumentException | si ImageProcessingOptions spécifie une région d'intérêt. |
|---|---|
en cas d'erreur interne. Ou si FaceStylizer n'est pas créé avec OutputHandler.ResultListener défini dans FaceStylizer.FaceStylizerOptions.
|