# זיהוי נקודות פנים (MediaPipe)

## סקירה כללית

מזהה פנים בתמונה ומזהה 468 נקודות ציון (נקודות מפתח) על כל פנים באמצעות המודלים BlazeFace ו-FaceMesh של MediaPipe. כמו כן מחשב מקדמי בלנדשייפ ARKit-52 לניתוח הבעות פנים. הצומת יכול לעבד מספר תמונות באצווה ולפלוט גם את נתוני נקודות הציון וגם תיבות תוחמות עבור כל פנים שזוהו.

## קלטים

| פרמטר | תיאור | סוג נתונים | נדרש | טווח |
| --- | --- | --- | --- | --- |
| `face_detection_model` | מודל זיהוי הפנים של MediaPipe שיש להשתמש בו לזיהוי נקודות ציון. | FACE_DETECTION_MODEL | כן |  |
| `image` | תמונת הקלט או אצוות תמונות שבהן יש לזהות פנים. | IMAGE | כן |  |
| `detector_variant` | טווח גלאי הפנים. `"short"` מכוון לפנים בקרבה (עד ~2 מטר מהמצלמה); `"full"` מכסה פנים רחוקות/קטנות יותר (עד ~5 מטר) אך איטי יותר. `"both"` מריץ את שני הגלאים ושומר את זה שמצא יותר פנים בכל פריים (עלות זיהוי ~כפולה). ברירת מחדל: `"short"`. | COMBO | כן | `"short"`<br>`"full"`<br>`"both"` |
| `num_faces` | מספר הפנים המקסימלי להחזרה בכל פריים. 0 פירושו ללא הגבלה (החזר את כל הפנים שזוהו). ברירת מחדל: 1. | INT | כן | 0 עד 16 |
| `min_confidence` | סף ניקוד BlazeFace. ערכים נמוכים יותר עוזרים לזהות פנים קטנות או מוסתרות. ברירת מחדל: 0.5. | FLOAT | לא | 0.00 עד 1.00 |
| `missing_frame_fallback` | התנהגות לכל פריים כאשר הזיהוי נכשל באצווה. `"empty"` משאיר את הפריים ללא פנים. `"previous"` מעתיק את הזיהוי המוצלח האחרון. `"interpolate"` מבצע אינטרפולציה לינארית של נקודות ציון/תיבות תוחמות/בלנדשייפ בין פריימים מוצלחים תוחמים. ריבוי פנים: מתאים פנים בין פריימים באמצעות NN חמדני של מרכז תיבה תוחמת. ברירת מחדל: `"empty"`. | COMBO | לא | `"empty"`<br>`"previous"`<br>`"interpolate"` |

## פלטים

| שם פלט | תיאור | סוג נתונים |
| --- | --- | --- |
| `face_landmarks` | פלט מובנה המכיל תוצאות זיהוי פנים לכל פריים, כולל 468 נקודות ציון בפנים, מקדמי בלנדשייפ 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/he.md)

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