FaceLandmarker

کلاس نهایی عمومی FaceLandmarker

تشخیص نشانه‌های چهره روی تصاویر را انجام می‌دهد.

این API انتظار دارد یک بسته دارایی مدل نشانه های چهره از قبل آموزش دیده باشد. دیدن .

  • تصویر ورودی MPImage
    • تصویری که تشخیص نشانه‌های چهره روی آن اجرا می‌شود.
  • خروجی FaceLandmarkerResult
    • یک نتیجه FaceLandmarker حاوی نشانه‌های چهره.

کلاس های تو در تو

کلاس FaceLandmarker.FaceLandmarkerOptions گزینه هایی برای راه اندازی FaceLandmarker .

زمینه های

عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_CONNECTORS
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_FACE_OVAL
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_LEFT_EYE
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_LEFT_EYE_BROW
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_LEFT_IRIS
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_LIPS
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_RIGHT_EYE
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_RIGHT_EYE_BROW
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_RIGHT_IRIS
عمومی استاتیک نهایی مجموعه < اتصال > FACE_LANDMARKS_TESSELATION

روش های عمومی

FaceLandmarker ثابت
createFromBuffer (متن زمینه، ByteBuffer modelAssetBuffer)
یک نمونه FaceLandmarker را از بافر بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.
FaceLandmarker ثابت
createFromFile (زمینه زمینه، رشته modelAssetPath)
یک نمونه FaceLandmarker را از مسیر بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.
FaceLandmarker ثابت
createFromFile (زمینه زمینه، فایل modelAssetFile)
یک نمونه FaceLandmarker را از یک فایل بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.
FaceLandmarker ثابت
createFromOptions (متن زمینه، FaceLandmarker.FaceLandmarkerOptions landmarkerOptions)
یک نمونه FaceLandmarker از یک FaceLandmarker.FaceLandmarkerOptions ایجاد می کند.
FaceLandmarker Result
تشخیص (تصویر MPI )
با گزینه‌های پیش‌فرض پردازش تصویر، تشخیص نشانه‌های چهره را روی تصویر واحد ارائه شده انجام می‌دهد
FaceLandmarker Result
تشخیص (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions)
تشخیص نقاط عطف چهره را روی تک تصویر ارائه شده انجام می دهد.
خالی
detectAsync (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، timestampMهای طولانی)
داده های تصویر زنده را برای انجام تشخیص نشانه های چهره ارسال می کند و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceLandmarker.FaceLandmarkerOptions در دسترس خواهد بود.
خالی
detectAsync (تصویر MPImage ، برچسب زمانی طولانی)
داده‌های تصویر زنده را برای انجام تشخیص نشانه‌های چهره با گزینه‌های پیش‌فرض پردازش تصویر ارسال می‌کند
FaceLandmarker Result
detectForVideo (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، برچسب های زمانی طولانی)
تشخیص نشانه های چهره را در قاب ویدیوی ارائه شده انجام می دهد.
FaceLandmarker Result
detectForVideo (تصویر MPI ، مُهر زمانی طولانی)
با گزینه‌های پردازش تصویر پیش‌فرض، تشخیص نشانه‌های چهره را روی قاب ویدیوی ارائه شده انجام می‌دهد

روش های ارثی

زمینه های

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_CONNECTORS

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_FACE_OVAL

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_LEFT_EYE

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_LEFT_EYE_BROW

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_LEFT_IRIS

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_LIPS

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_RIGHT_EYE

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_RIGHT_EYE_BROW

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_RIGHT_IRIS

مجموعه نهایی ثابت عمومی < اتصال > FACE_LANDMARKS_TESSELATION

روش های عمومی

FaceLandmarker عمومی ایجاد از بافر (زمینه زمینه، مدل ByteBufferAssetBuffer )

یک نمونه FaceLandmarker را از بافر بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
modelAssetBuffer
پرتاب می کند
اگر در حین ایجاد FaceLandmarker خطایی وجود داشته باشد.

FaceLandmarker استاتیک عمومی createFromFile (زمینه زمینه، String modelAssetPath)

یک نمونه FaceLandmarker را از مسیر بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
modelAssetPath مسیر به مدل نشانه های چهره با ابرداده در دارایی ها.
پرتاب می کند
اگر در حین ایجاد FaceLandmarker خطایی وجود داشته باشد.

FaceLandmarker عمومی ایجاد از فایل (متن زمینه، فایل modelAssetFile)

یک نمونه FaceLandmarker را از یک فایل بسته دارایی مدل و FaceLandmarker.FaceLandmarkerOptions پیش‌فرض ایجاد می‌کند.

مولفه های
متن نوشته یک ERROR(/Context) .
modelAssetFile مدل نشانه های چهره نمونه File .
پرتاب می کند
IOException اگر هنگام باز کردن فایل مدل tflite خطای I/O رخ دهد.
اگر در حین ایجاد FaceLandmarker خطایی وجود داشته باشد.

FaceLandmarker استاتیک عمومی createFromOptions (زمینه زمینه، FaceLandmarker.FaceLandmarkerOptions landmarkerOptions)

یک نمونه FaceLandmarker از یک FaceLandmarker.FaceLandmarkerOptions ایجاد می کند.

مولفه های
متن نوشته یک ERROR(/Context) .
landmarkerOptions یک نمونه FaceLandmarker.FaceLandmarkerOptions .
پرتاب می کند
اگر در حین ایجاد FaceLandmarker خطایی وجود داشته باشد.

تشخیص عمومی FaceLandmarkerResult (تصویر MPImage )

با گزینه‌های پردازش تصویر پیش‌فرض، یعنی بدون اعمال چرخش، تشخیص نشانه‌های چهره را روی تصویر واحد ارائه شده انجام می‌دهد. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.IMAGE) ایجاد شده باشد. TODO جاوا doc را برای فرمت تصویر ورودی به روز رسانی کنید.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.

تشخیص عمومی FaceLandmarkerResult (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions)

تشخیص نقاط عطف چهره را روی تک تصویر ارائه شده انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.IMAGE) ایجاد شده باشد. TODO جاوا doc را برای فرمت تصویر ورودی به روز رسانی کنید.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

public void detectAsync (تصویر MPImage ، ImageProcessingOptions imageProcessingOptions، timestampM های طولانی)

داده های تصویر زنده را برای انجام تشخیص نشانه های چهره ارسال می کند و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceLandmarker.FaceLandmarkerOptions در دسترس خواهد بود. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.LIVE_STREAM) ایجاد شده باشد.

برای نشان دادن زمان ارسال تصویر ورودی به نشانگر چهره، باید یک مهر زمانی (بر حسب میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

public void detectAsync (تصویر MPImage ، timestampMs طولانی)

داده‌های تصویر زنده را برای انجام تشخیص نشانه‌های چهره با گزینه‌های پردازش تصویر پیش‌فرض، یعنی بدون هیچ چرخشی ارسال می‌کند، و نتایج از طریق OutputHandler.ResultListener ارائه شده در FaceLandmarker.FaceLandmarkerOptions در دسترس خواهند بود. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.LIVE_STREAM) ایجاد شده باشد.

برای نشان دادن زمان ارسال تصویر ورودی به نشانگر چهره، باید یک مهر زمانی (بر حسب میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.

عمومی FaceLandmarkerResult detectForVideo (تصویر MPI ، ImageProcessingOptions imageProcessingOptions، مُهر زمانی طولانی)

تشخیص نشانه های چهره را در قاب ویدیوی ارائه شده انجام می دهد. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.VIDEO) ایجاد شده باشد.

لازم است مهر زمانی فریم ویدیو (در میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
imageProcessingOptions ImageProcessingOptions نحوه پردازش تصویر ورودی را قبل از اجرای استنتاج مشخص می کند. توجه داشته باشید که منطقه مورد علاقه توسط این کار پشتیبانی نمی شود: مشخص کردن ImageProcessingOptions.regionOfInterest() منجر به پرتاب IllegalArgumentException توسط این روش می شود.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
IllegalArgumentException اگر ImageProcessingOptions منطقه مورد علاقه را مشخص کند.
اگر یک خطای داخلی وجود داشته باشد.

عمومی FaceLandmarkerResult detectForVideo (تصویر MPI ، مهرهای زمانی طولانی)

با گزینه‌های پیش‌فرض پردازش تصویر، یعنی بدون اعمال چرخش، تشخیص نشانه‌های چهره را روی قاب ویدیوی ارائه شده انجام می‌دهد. فقط زمانی از این روش استفاده کنید که FaceLandmarker با ERROR(/RunningMode.VIDEO) ایجاد شده باشد.

لازم است مهر زمانی فریم ویدیو (در میلی ثانیه) ارائه شود. مُهرهای زمانی ورودی باید بطور یکنواخت در حال افزایش باشند.

FaceLandmarker از انواع فضای رنگی زیر پشتیبانی می کند:

مولفه های
تصویر یک شی MediaPipe MPImage برای پردازش.
timestampMs مهر زمانی ورودی (بر حسب میلی ثانیه).
پرتاب می کند
اگر یک خطای داخلی وجود داشته باشد.