## مرور کلی

چهره‌ها را در یک تصویر تشخیص می‌دهد و ۴۶۸ نقطه کلیدی (نقاط نشانه‌گذار) صورت را روی هر چهره با استفاده از مدل‌های BlazeFace و FaceMesh شرکت MediaPipe شناسایی می‌کند. همچنین ضرایب ترکیب‌شکل ARKit-52 را برای تحلیل حالات چهره محاسبه می‌کند. این گره می‌تواند چندین تصویر را در یک دسته پردازش کند و هم داده‌های نقاط نشانه‌گذار و هم کادرهای محدودکننده را برای هر چهره تشخیص‌داده‌شده خروجی می‌دهد.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | ضروری | محدوده |
| --- | --- | --- | --- | --- |
| `face_detection_model` | مدل تشخیص چهره MediaPipe که برای تشخیص نقاط نشانه‌گذار استفاده می‌شود. | FACE_DETECTION_MODEL | بله |  |
| `image` | تصویر ورودی یا دسته‌ای از تصاویر برای تشخیص چهره در آن‌ها. | IMAGE | بله |  |
| `detector_variant` | محدوده تشخیص چهره. `"short"` برای چهره‌های نزدیک (در فاصله حدود ۲ متری دوربین) تنظیم شده است؛ `"full"` چهره‌های دورتر/کوچک‌تر (تا حدود ۵ متر) را پوشش می‌دهد اما کندتر است. `"both"` هر دو تشخیص‌دهنده را اجرا کرده و تشخیصی را نگه می‌دارد که تعداد چهره‌های بیشتری در هر فریم یافته است (هزینه تشخیص حدود ۲ برابر). پیش‌فرض: `"short"`. | COMBO | بله | `"short"`<br>`"full"`<br>`"both"` |
| `num_faces` | حداکثر تعداد چهره‌هایی که در هر فریم بازگردانده می‌شود. مقدار ۰ به معنای بدون محدودیت (بازگرداندن همه تشخیص‌ها) است. پیش‌فرض: ۱. | INT | بله | ۰ تا ۱۶ |
| `min_confidence` | آستانه امتیاز BlazeFace. مقادیر پایین‌تر به تشخیص چهره‌های کوچک یا پنهان کمک می‌کند. پیش‌فرض: ۰٫۵. | FLOAT | خیر | ۰٫۰۰ تا ۱٫۰۰ |
| `missing_frame_fallback` | رفتار در هر فریم زمانی که تشخیص در یک دسته شکست می‌خورد. `"empty"` فریم را بدون چهره رها می‌کند. `"previous"` آخرین تشخیص موفق را کپی می‌کند. `"interpolate"` نقاط نشانه‌گذار/کادر محدودکننده/ترکیب‌شکل را بین فریم‌های موفق اطراف درون‌یابی می‌کند. برای چند چهره: چهره‌ها را در فریم‌ها با استفاده از نزدیک‌ترین همسایه مرکز کادر محدودکننده جفت می‌کند. پیش‌فرض: `"empty"`. | COMBO | خیر | `"empty"`<br>`"previous"`<br>`"interpolate"` |

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `face_landmarks` | یک خروجی ساختاریافته شامل نتایج تشخیص چهره در هر فریم، شامل ۴۶۸ نقطه نشانه‌گذار صورت، ضرایب ترکیب‌شکل ARKit-52، ماتریس‌های تبدیل و مجموعه‌های اتصال برای نمایش مش. | FACE_LANDMARKS |
| `bboxes` | فهرستی از کادرهای محدودکننده برای هر چهره تشخیص‌داده‌شده، با مختصات (x، y، عرض، ارتفاع)، برچسب "face" و امتیاز اطمینان. یک فهرست برای هر فریم ورودی. | BOUNDING_BOX |

> این مستند با هوش مصنوعی تهیه شده است. اگر خطایی دیدید یا پیشنهادی برای بهبود دارید، خوشحال می‌شویم مشارکت کنید! [ویرایش در GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MediaPipeFaceLandmarker/fa.md)

---
**Source fingerprint (SHA-256):** `f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba`