تنفيذ أنماط الوجه في الصور
بالإضافة إلى واجهة برمجة التطبيقات للنمط العادي، stylize(MPImage) وERROR(/#stylizeForVideo)، والتي تلتقط صورة إدخال وتعرض المخرجات ولكنها تتضمن نسخة كبيرة من النتائج المعروضة، يتيح FaceStylizer أيضًا استخدام واجهة برمجة التطبيقات معاودة الاتصال stylizeWithResultListener(MPImage) وERROR(/#stylizeForVideoWithResultListener) التي تتيح لك الوصول إلى المخرجات بدون أي نسخ خلال مدة أداة معالجة النتيجة.
تتوفّر واجهة برمجة تطبيقات معاودة الاتصال لجميع "RunningMode" في FaceStylizer. عليك ضبط OutputHandler.ResultListener في FaceStylizer.FaceStylizerOptions بشكل صحيح لاستخدام واجهة برمجة تطبيقات معاودة الاتصال.
نتوقّع في واجهة برمجة التطبيقات استخدام نموذج TFLite مع البيانات الوصفية لنموذج TFLite.
الصفوف المتداخلة
| صنف | FaceStylizer.FaceStylizerOptions | خيارات إعداد "FaceStylizer" |
|
الطرق العامة
| ثابت FaceStylizer |
createFromOptions(سياق السياق، FaceStylizer.FaceStylizerOptions stylizerOptions)
تنشئ هذه الدالة
FaceStylizer مثيلاً من FaceStylizer.FaceStylizerOptions. |
| FaceStylizerResult |
stylize(صورة MPImage، ImageProcessingOptions imageProcessingOptions)
يتم تطبيق أسلوب على الوجه في الصورة الواحدة المقدّمة.
|
| FaceStylizerResult | |
| void |
stylizeWithResultListener(صورة MPImage)
يتم تصميم صورة الوجه على صورة واحدة مقدَّمة باستخدام خيارات معالجة الصور التلقائية،
أي
|
| void |
stylizeWithResultListener(صورة MPImage، وImageProcessingOptions imageProcessingOptions)
يتم تصميم الوجه على الصورة المفردة وتقديم نتائج منسوخة بدون أي نسخ من خلال
OutputHandler.ResultListener في FaceStylizer.FaceStylizerOptions. |
الطرق المكتسَبة
الطرق العامة
public static FaceStylizer createFromOptions (سياق السياق، FaceStylizer.FaceStylizerOptions stylizerOptions)
تنشئ هذه الدالة FaceStylizer مثيلاً من FaceStylizer.FaceStylizerOptions.
المَعلمات
| سياق | جهاز Android ERROR(/Context) |
|---|---|
| stylizerOptions | مثيل FaceStylizer.FaceStylizerOptions. |
الرميات
في حال حدوث خطأ أثناء إنشاء "FaceStylizer".
|
public FaceStylizerResult تحديد نمط (MPImage image, ImageProcessingOptions imageProcessingOptions)
يتم تطبيق أسلوب على الوجه في الصورة الواحدة المقدّمة. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceStylizer من خلال RunningMode.IMAGE.
يتيح FaceStylizer استخدام أنواع مساحات الألوان التالية:
يمكن أن تكون الصورة المدخلة بأي حجم. الصورة النهائية هي الصورة ذات النمط الأكثر
ظهورًا. حجم صورة الإخراج ذو النمط نفسه يتطابق مع حجم إخراج النموذج. في حال عدم التعرّف على أي وجه في الصورة التي تم إدخالها، سيتم عرض Optional.empty().
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions التي تحدِّد كيفية معالجة
الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية. |
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
في حال حدوث خطأ داخلي. أو إذا تم إنشاء FaceStylizer باستخدام OutputHandler.ResultListener.
|
public FaceStylizerResult ضبط الأسلوب (صورة MPImage)
يتم تصميم شكل الوجه على صورة واحدة مقدَّمة باستخدام خيارات معالجة الصور التلقائية،
أي بدون تطبيق أي تدوير. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceStylizer باستخدام RunningMode.IMAGE.
يتيح FaceStylizer استخدام أنواع مساحات الألوان التالية:
يمكن أن تكون الصورة المدخلة بأي حجم. الصورة النهائية هي الصورة ذات النمط الأكثر
ظهورًا. حجم صورة الإخراج ذو النمط نفسه يتطابق مع حجم إخراج النموذج. في حال عدم التعرّف على أي وجه في الصورة التي تم إدخالها، سيتم عرض Optional.empty().
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|
الرميات
في حال حدوث خطأ داخلي. أو إذا تم إنشاء FaceStylizer باستخدام OutputHandler.ResultListener.
|
متاح للجميع إلغاء stylizeWithResultListener (صورة MPImage)
تُجري أنماطًا للوجه على صورة واحدة مقدَّمة باستخدام خيارات معالجة الصور التلقائية،
أي بدون تطبيق أي تدوير، وتوفر نتائج بدون نسخ من خلال OutputHandler.ResultListener
في FaceStylizer.FaceStylizerOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceStylizer من خلال RunningMode.IMAGE.
يتيح FaceStylizer استخدام أنواع مساحات الألوان التالية:
يمكن أن تكون الصورة المدخلة بأي حجم. الصورة النهائية هي الصورة ذات النمط الأكثر
ظهورًا. حجم صورة الإخراج ذو النمط نفسه يتطابق مع حجم إخراج النموذج. في حال عدم التعرّف على أي وجه في الصورة التي تم إدخالها، سيتم عرض Optional.empty().
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
في حال حدوث خطأ داخلي. أو إذا لم يتم إنشاء FaceStylizer باستخدام السمة OutputHandler.ResultListener التي تم ضبطها على FaceStylizer.FaceStylizerOptions.
|
عامة باطلة stylizeWithResultListener (صورة MPImage، ImageProcessingOptions imageProcessingOptions)
يتم تصميم الوجه على الصورة المفردة وتقديم نتائج منسوخة بدون أي نسخ من خلال OutputHandler.ResultListener في FaceStylizer.FaceStylizerOptions. لا تستخدِم هذه الطريقة إلا عند إنشاء FaceStylizer من خلال RunningMode.IMAGE.
يتيح FaceStylizer استخدام أنواع مساحات الألوان التالية:
يمكن أن تكون الصورة المدخلة بأي حجم. الصورة النهائية هي الصورة ذات النمط الأكثر
ظهورًا. حجم صورة الإخراج ذو النمط نفسه يتطابق مع حجم إخراج النموذج. في حال عدم التعرّف على أي وجه في الصورة التي تم إدخالها، سيتم عرض Optional.empty().
المَعلمات
| صورة | كائن MediaPipe MPImage للمعالجة. |
|---|---|
| imageProcessingOptions | ImageProcessingOptions التي تحدِّد كيفية معالجة
الصورة التي تم إدخالها قبل تنفيذ الاستنتاج يُرجى العلم أنّ هذه المهمة غير تتوافق مع "المنطقة" حيث إنّ تحديد ImageProcessingOptions.regionOfInterest() سيؤدي إلى طرح هذا النوع من قواعد "الاستثناءات" غير القانونية. |
الرميات
| IllegalArgumentException | إذا كانت السمة ImageProcessingOptions تحدّد
منطقة الاهتمام. |
|---|---|
في حال حدوث خطأ داخلي. أو إذا لم يتم إنشاء FaceStylizer باستخدام السمة OutputHandler.ResultListener التي تم ضبطها على FaceStylizer.FaceStylizerOptions.
|