FaceStylizer

המחלקה הסופית הציבורית FaceStylizer

עיצוב פנים של תמונות.

שימו לב שבנוסף ל-API לסטיילזציה הרגיל, stylize(MPImage) ו-ERROR(/#stylizeForVideo), שסורקים את נתוני הקלט ומחזירים את הפלטים, אבל כוללים העתקה עמוקה של ההחזרות, FaceStylizer תומך גם בממשק ה-API של הקריאה החוזרת (callback) , stylizeWithResultListener(MPImage) ו-ERROR(/#stylizeForVideoWithResultListener), שמאפשרים גישה לפלט דרך אפס עותק למשך הזמן של מאזין התוצאות.

ה-API לקריאה חוזרת זמין לכל RunningMode ב-FaceStylizer. צריך להגדיר את OutputHandler.ResultListener ב-FaceStylizer.FaceStylizerOptions בצורה תקינה כדי להשתמש ב-API לקריאה חוזרת.

ה-API מצפה למודל TFLite עם המטא-נתונים של המודל TFLite.

  • הזנת תמונה MPImage
    • התמונה שעליה מוצג סטילטור הפנים.
  • פלט MPImage MPImage
    • תמונה MPImage עם פנים מסוגננות.

מחלקות מקננות

מחלקה FaceStylizer.FaceStylizerOptions אפשרויות להגדרת FaceStylizer. 

שיטות ציבוריות

FaceStylizer
createFromOptions(הקשר הקשר, FaceStylizer.FaceStylizerOptions stylizerOptions)
יצירת מכונה של FaceStylizer מ-FaceStylizer.FaceStylizerOptions.
FaceStylizerResult
סטיילינג(MPImage image, ImageProcessingOptions image ProcessingOptions)
עיצוב פנים של התמונה הבודדת.
FaceStylizerResult
סטיילוס(תמונת MPImage)
הפעולה הזו מבצעת עיצוב פנים בתמונה הבודדת, עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
void
stylizeWithResultListener(תמונת MPImage)
הפעולה הזו מבצעת עיצוב פנים בתמונה הבודדת, עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר
void
stylizeWithResultListener(MPImage image, ImageProcessingOptionsאפשרויות עיבוד תמונה
בוצע עיצוב פנים בתמונה הבודדת, ללא עותק של התוצאות דרך OutputHandler.ResultListener בFaceStylizer.FaceStylizerOptions.

שיטות שעברו בירושה

שיטות ציבוריות

ציבורי סטטי FaceStylizer createFromOptions (הקשר הקשר, FaceStylizer.FaceStylizerOptions stylizerOptions)

יצירת מכונה של FaceStylizer מ-FaceStylizer.FaceStylizerOptions.

פרמטרים
context ERROR(/Context) של Android.
stylizerOptions מופע של FaceStylizer.FaceStylizerOptions.
קליעות
אם יש שגיאה במהלך היצירה של FaceStylizer.

Public FaceStylizerResult סגנון (MPImage image, ImageProcessingOptions image ProcessingOptions)

עיצוב פנים של התמונה הבודדת. יש להשתמש בשיטה הזו רק אם ה-FaceStylizer נוצר באמצעות RunningMode.IMAGE.

ב-FaceStylizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

תמונת הקלט יכולה להיות בכל גודל. תמונת הפלט היא התמונה המעוצבת עם הפנים הגלויות ביותר. גודל תמונת הפלט המעוצב זהה לגודל הפלט של המודל. כשלא זוהו פנים בתמונת הקלט, הפונקציה מחזירה את הערך Optional.empty().

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם FaceStylizer נוצר באמצעות OutputHandler.ResultListener.

Public FaceStylizerResult סגנון (MPImage)

עיצוב פנים של תמונה יחידה שסופקה עם אפשרויות עיבוד תמונה שמוגדרות כברירת מחדל, כלומר ללא סיבוב. יש להשתמש בשיטה הזו רק אם השדה FaceStylizer נוצר באמצעות RunningMode.IMAGE.

ב-FaceStylizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

תמונת הקלט יכולה להיות בכל גודל. תמונת הפלט היא התמונה המעוצבת עם הפנים הגלויות ביותר. גודל תמונת הפלט המעוצב זהה לגודל הפלט של המודל. כשלא זוהו פנים בתמונת הקלט, הפונקציה מחזירה את הערך Optional.empty().

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
קליעות
אם אירעה שגיאה פנימית. לחלופין, אם FaceStylizer נוצר באמצעות OutputHandler.ResultListener.

Public void stylizeWithResultListener (תמונת MPImage)

מתבצע עיצוב פנים של התמונה הבודדת, עם אפשרויות ברירת מחדל לעיבוד התמונה, כלומר ללא סיבוב, ומספק תוצאות ללא עותק דרך OutputHandler.ResultListener ב-FaceStylizer.FaceStylizerOptions. יש להשתמש בשיטה הזו רק אם השדה FaceStylizer נוצר באמצעות RunningMode.IMAGE.

ב-FaceStylizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

תמונת הקלט יכולה להיות בכל גודל. תמונת הפלט היא התמונה המעוצבת עם הפנים הגלויות ביותר. גודל תמונת הפלט המעוצב זהה לגודל הפלט של המודל. כשלא זוהו פנים בתמונת הקלט, הפונקציה מחזירה את הערך Optional.empty().

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם FaceStylizer לא נוצר עם OutputHandler.ResultListener שמוגדר ב-FaceStylizer.FaceStylizerOptions.

Public void stylizeWithResultListener (MPImage image, ImageProcessingOptions imageprocessingOptions)

בוצע עיצוב פנים בתמונה הבודדת, ללא עותק של התוצאות דרך OutputHandler.ResultListener בFaceStylizer.FaceStylizerOptions. יש להשתמש בשיטה הזו רק אם ה-FaceStylizer נוצר באמצעות RunningMode.IMAGE.

ב-FaceStylizer יש תמיכה מהסוגים הבאים של מרחבי צבעים:

תמונת הקלט יכולה להיות בכל גודל. תמונת הפלט היא התמונה המעוצבת עם הפנים הגלויות ביותר. גודל תמונת הפלט המעוצב זהה לגודל הפלט של המודל. כשלא זוהו פנים בתמונת הקלט, הפונקציה מחזירה את הערך Optional.empty().

פרמטרים
תמונה אובייקט MPImage MediaPipe לעיבוד.
imageProcessingOptions ImageProcessingOptions שמציין איך לעבד את תמונת הקלט לפני הרצת ההסקה. שימו לב שאזור עניין (region) לא נתמך במשימה הזו: ציון הערך ImageProcessingOptions.regionOfInterest() יגרום ל-method הזה לגרום לחריגת invalidArgument.
קליעות
IllegalArgumentException אם השדה ImageProcessingOptions מציין אזור עניין.
אם אירעה שגיאה פנימית. לחלופין, אם FaceStylizer לא נוצר עם OutputHandler.ResultListener שמוגדר ב-FaceStylizer.FaceStylizerOptions.