گره SDPoseKeypointExtractor نقاط کلیدی حالت بدن انسان را از تصاویر ورودی با استفاده از مدل SDPose تشخیص می‌دهد. این گره می‌تواند تصاویر کامل یا نواحی مشخص‌شده توسط جعبه‌های مرزی را پردازش کند و نقاط کلیدی تشخیص‌داده‌شده را در قالب OpenPose خروجی می‌دهد که شامل مختصات هر فرد و نمره اطمینان برای هر نقطه کلیدی است.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
| --- | --- | --- | --- | --- |
| `مدل` | مدل SDPose مورد استفاده برای تشخیص نقاط کلیدی. باید مدلی با ویژگی `heatmap_head` باشد، به‌طور خاص از مخزن SDPose. | MODEL | بله | - |
| `vae` | مدل VAE مورد استفاده برای رمزگذاری تصاویر ورودی به فضای نهفته برای پردازش. | VAE | بله | - |
| `تصویر` | تصویر ورودی یا دسته‌ای از تصاویر که نقاط کلیدی حالت از آن استخراج می‌شود. | IMAGE | بله | - |
| `اندازه دسته` | تعداد تصاویری که در حالت تصویر کامل (یعنی زمانی که `جعبه‌های مرزی` ارائه نشده است) به‌طور همزمان پردازش می‌شوند. این کار می‌تواند سرعت پردازش را افزایش دهد. (پیش‌فرض: 16) | INT | خیر | 1 تا 10000 |
| `جعبه‌های مرزی` | جعبه‌های مرزی اختیاری برای تشخیص‌های دقیق‌تر. برای تشخیص چند نفر الزامی است. در صورت ارائه، گره نقاط کلیدی را از هر ناحیه مشخص‌شده استخراج می‌کند. | BOUNDINGBOX | خیر | - |

**محدودیت‌های پارامتر:**
*   ورودی `model` باید یک مدل SDPose خاص باشد. اگر مدل ارائه‌شده دارای ویژگی `heatmap_head` نباشد، گره خطا ایجاد می‌کند.
*   گره بر اساس ورودی `bboxes` در دو حالت مجزا عمل می‌کند:
    1.  **حالت جعبه مرزی:** هنگامی که `bboxes` ارائه می‌شود، هر ناحیه مشخص‌شده را به‌طور جداگانه پردازش می‌کند. این حالت برای تشخیص چند نفر در یک تصویر الزامی است.
    2.  **حالت تصویر کامل:** هنگامی که `bboxes` ارائه نمی‌شود، کل تصویر را به‌صورت دسته‌ای پردازش می‌کند. پارامتر `batch_size` فقط در این حالت اعمال می‌شود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
| --- | --- | --- |
| `keypoints` | نقاط کلیدی در قالب فریم OpenPose (عرض بوم، ارتفاع بوم، افراد). خروجی شامل افراد تشخیص‌داده‌شده است که هر کدام دارای آرایه‌ای از مختصات نقاط کلیدی (x, y) و نمرات اطمینان متناظر آن‌ها هستند. | POSE_KEYPOINT |

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

---
**Source fingerprint (SHA-256):** `7903b51c9137aa08bb8843362740fcf93cea9c09d142bd1db3b5eee945c853e4`