# رندر حالت بدن سه‌بعدی

Renders 3D body pose data into an image using a selectable style. The node accepts pose data from the SAM3D body tracker (MHR) or from an external Y-up rig such as Kimodo, and can composite the result over an optional background image (or a black canvas when none is provided). Available render styles include a shaded 3D mesh, a binary silhouette, 2D and 3D OpenPose-style skeletons, and SCAIL-style body capsules.

## ورودی‌ها

### ورودی‌های مشترک

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `render_style` | حالت رندر. 'mesh' = مش سه‌بعدی MHR که از طریق دوربین رستری می‌شود. 'silhouette' = ماسک دودویی مش. 'openpose_2d' = اسکلت تخت دوبعدی. 'openpose_3d' = اسکلت OpenPose به‌صورت مدل سه‌بعدی با سایه‌زنی تخت. 'scail' = کپسول‌های سه‌بعدی SCAIL. (پیش‌فرض: "mesh") | DYNAMIC_COMBO | بله | "mesh"<br>"silhouette"<br>"openpose_2d"<br>"openpose_3d"<br>"scail" |
| `pose_data` | داده‌های pose مربوط به MHR، یا داده‌های pose ریگ خارجی Y-up (KimodoSample). همه سبک‌های رندر برای ریگ‌های خارجی که نقشه‌های مفصل OpenPose را در `_skeleton_override` خود دارند کار می‌کنند (KimodoSample این‌گونه است). | MHR_POSE_DATA or KIMODO_POSE_DATA | بله | — |
| `پس‌زمینه` | پس‌زمینه هر فریم. در صورت حذف = بوم مشکی. | IMAGE | خیر | — |
| `عرض` | عرض خروجی بر حسب پیکسل. 0 = استفاده از image_size بومی داده‌های pose. اگر فقط یکی از width/height تنظیم شود، دیگری با حفظ نسبت ابعاد اصلی محاسبه می‌شود. (پیش‌فرض: 0) | INT | خیر | 0 تا 16384, step 8 |
| `ارتفاع` | ارتفاع خروجی بر حسب پیکسل. 0 = استفاده از image_size بومی داده‌های pose. اگر فقط یکی از width/height تنظیم شود، دیگری با حفظ نسبت ابعاد اصلی محاسبه می‌شود. (پیش‌فرض: 0) | INT | خیر | 0 تا 16384, step 8 |
| `camera_info` | بازنویسی دوربین آزاد 6DOF. وقتی متصل باشد، pose از طریق این دوربین (position/target/zoom/rotation/FoV) به‌جای دوربین پیش‌بینی‌شده دوباره تصویربرداری می‌شود. | LOAD_3D_CAMERA | خیر | — |

### ورودی‌های Mesh

این پارامترها زمانی ظاهر می‌شوند که `render_style` روی "mesh" باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `shader` | شیدر از پیش تعیین‌شده. 'normals' = نرمال سطح فعلی در فضای دوربین (قرارداد normal-map با Y+ در OpenGL: +X→R، +Y→G، +Z→B). 'rainbow' = جت body-Y به سبک RealisDance؛ گونه‌های 'rainbow_face_*' رئوس صورت را با رنگ‌های نرمال/برحسب ناحیه بازنویسی می‌کنند؛ 'depth' = خاکستری خطی. (پیش‌فرض: "default") | DYNAMIC_COMBO | خیر | "default"<br>"normals"<br>"rainbow"<br>"rainbow_face_normal"<br>"rainbow_face_semantic"<br>"depth" |
| `rainbow_tilt_z` | محور جت rainbow را حول Z (به سمت جلو) می‌چرخاند. چپ/راست را از هم متمایز می‌کند. فقط زمانی در دسترس است که `shader` روی "rainbow"، "rainbow_face_normal" یا "rainbow_face_semantic" باشد. (پیش‌فرض: -35.0) | FLOAT | خیر | -90.0 تا 90.0, step 0.5 |
| `rainbow_tilt_x` | محور جت rainbow را حول X (به سمت راست) می‌چرخاند. جلو/عقب را از هم متمایز می‌کند. فقط زمانی در دسترس است که `shader` روی "rainbow"، "rainbow_face_normal" یا "rainbow_face_semantic" باشد. (پیش‌فرض: 0.0) | FLOAT | خیر | -90.0 تا 90.0, step 0.5 |
| `opacity` | میزان آلفای مش روی تصویر پس‌زمینه، یا روی مشکی وقتی هیچ پس‌زمینه‌ای متصل نیست. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.0 تا 1.0, step 0.01 |
| `person_palette_falloff` | کاهش اشباع هر شخص به سمت سفید: ترک k ترکیب پاستلی (1 - falloff^k) می‌گیرد (پیکربندی 'softer second person' در SCAIL). 1.0 = خاموش. (پیش‌فرض: 0.6) | FLOAT | خیر | 0.1 تا 1.0, step 0.05 |
| `region` | 'hands_only' وجه‌ها را از طریق `hand_vert_mask` از پیش محاسبه‌شده فیلتر می‌کند (وزن‌های LBS در برابر KPs متعارف دست) — مش دست را برای اشکال‌زدایی جدا می‌کند. اگر ماسک موجود نباشد، به مش کامل برمی‌گردد. (پیش‌فرض: "full_body") | COMBO | خیر | "full_body"<br>"hands_only" |

### ورودی‌های Silhouette

زمانی که `render_style` روی "silhouette" باشد، گره یک ماسک دودویی از مش سه‌بعدی رندر می‌کند. این حالت پارامتر اضافی ندارد.

### ورودی‌های OpenPose 2D

این پارامترها زمانی ظاهر می‌شوند که `render_style` روی "openpose_2d" باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `marker_radius_px` | شعاع نقطه کلیدپوینت بدن (px). (پیش‌فرض: 4) | INT | خیر | 1 تا 32, step 1 |
| `stick_width_px` | نصف عرض بیضی اندام بدن (px). پیش‌فرض DWPose = 4. (پیش‌فرض: 4) | INT | خیر | 1 تا 32, step 1 |
| `limb_alpha` | آلفای هر اندام. پیش‌فرض DWPose = 0.6. (پیش‌فرض: 0.6) | FLOAT | خیر | 0.0 تا 1.0, step 0.05 |
| `face_style` | 'full' = همه نقاط شاخص صورت (در صورت وجود sapiens-238، در غیر این صورت rig-fallback حدود 30 نقطه). 'eyes_mouth' = زیرمجموعه rig-fallback (حدود 12 نقطه: فقط چشم‌ها + لب‌های بیرونی). 'disabled' = بدون نقاط صورت. (پیش‌فرض: "disabled") | COMBO | خیر | "disabled"<br>"full"<br>"eyes_mouth" |
| `hand_style` | رسم 21+21 کلیدپوینت دست + خطوط اتصال. 'disabled' = بدون دست. 'dwpose' = نقاط آبی توپر؛ 'openpose' = نقاط رنگین‌کمانی. (پیش‌فرض: "disabled") | COMBO | خیر | "disabled"<br>"dwpose"<br>"openpose" |
| `person_palette_falloff` | کاهش اشباع هر شخص: ترک k با مقدار 1 - falloff^k به سمت سفید ترکیب می‌شود. ترک 0 زنده و پررنگ می‌ماند؛ 1.0 falloff را غیرفعال می‌کند. (پیش‌فرض: 0.6) | FLOAT | خیر | 0.1 تا 1.0, step 0.05 |

### ورودی‌های OpenPose 3D

این پارامترها زمانی ظاهر می‌شوند که `render_style` روی "openpose_3d" باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | شعاع کپسول اندام بر حسب متر (نازک = شبیه میله). (پیش‌فرض: 0.015) | FLOAT | خیر | 0.004 تا 0.1, step 0.001 |
| `include_hands` | رسم 21+21 کلیدپوینت دست به‌صورت کپسول‌های سه‌بعدی. (پیش‌فرض: True) | BOOLEAN | خیر | True یا False |
| `person_palette_falloff` | کاهش اشباع هر شخص: ترک k با مقدار 1 - falloff^k به سمت سفید ترکیب می‌شود. ترک 0 زنده و پررنگ می‌ماند؛ 1.0 falloff را غیرفعال می‌کند. (پیش‌فرض: 0.6) | FLOAT | خیر | 0.1 تا 1.0, step 0.05 |

### ورودی‌های SCAIL

این پارامترها زمانی ظاهر می‌شوند که `render_style` روی "scail" باشد.

| پارامتر | توضیحات | نوع داده | الزامی | محدوده |
|-----------|-------------|-----------|----------|-------|
| `radius_m` | شعاع کپسول بر حسب متر (مرجع SCAIL: ~0.022 m). (پیش‌فرض: 0.022) | FLOAT | خیر | 0.005 تا 0.2, step 0.001 |
| `hand_style` | دست‌های OpenPose دوبعدی را روی بدنه کپسولی سه‌بعدی ترکیب می‌کند (مطابق SCAIL — بدون کپسول‌های دست سه‌بعدی). 'disabled' = بدون دست. 'dwpose' = نقاط دست آبی توپر؛ 'openpose' = نقاط رنگین‌کمانی. در هر حالت، خطوط اتصال برای هر انگشت رنگین‌کمانی می‌مانند. (پیش‌فرض: "dwpose") | COMBO | خیر | "disabled"<br>"dwpose"<br>"openpose" |
| `face_style` | 'full' = همه نقاط شاخص صورت (در صورت وجود sapiens-238، در غیر این صورت rig-fallback حدود 30 نقطه). 'eyes_mouth' = زیرمجموعه rig-fallback (حدود 12 نقطه: فقط چشم‌ها + لب‌های بیرونی). 'disabled' = بدون نقاط صورت. (پیش‌فرض: "disabled") | COMBO | خیر | "disabled"<br>"full"<br>"eyes_mouth" |
| `person_palette_falloff` | کاهش اشباع هر شخص: ترک k با مقدار 1 - falloff^k به سمت سفید ترکیب می‌شود. ترک 0 زنده و پررنگ می‌ماند؛ 1.0 falloff را غیرفعال می‌کند. (پیش‌فرض: 0.6) | FLOAT | خیر | 0.1 تا 1.0, step 0.05 |

### نکات

- اگر هر دو `width` و `height` صفر باشند، خروجی از اندازه تصویر بومی داده‌های pose استفاده می‌کند. اگر فقط یکی از آن‌ها تنظیم شود، دیگری با حفظ نسبت ابعاد اصلی محاسبه می‌شود. یک `background` متصل‌شده به اندازه رزولوشن رندر تغییر اندازه داده می‌شود.
- وقتی `camera_info` متصل باشد، pose از طریق همان دوربین به‌جای دوربین پیش‌بینی‌شده دوباره تصویربرداری می‌شود.
- در حالت mesh، `rainbow_tilt_z` و `rainbow_tilt_x` فقط زمانی در دسترس هستند که `shader` روی "rainbow"، "rainbow_face_normal" یا "rainbow_face_semantic" تنظیم شده باشد.
- در حالت mesh، وقتی `region` روی "hands_only" باشد، فیلتر ناحیه دست نیاز دارد که داده‌های pose شامل ماسک رأس دست باشد؛ اگر ماسک موجود نباشد، به‌جای آن مش کامل رندر می‌شود.
- در حالت scail، دست‌ها به‌صورت لایه‌های رویی OpenPose دوبعدی روی بدنه کپسولی سه‌بعدی رسم می‌شوند، نه به‌صورت کپسول‌های سه‌بعدی؛ تنظیم `hand_style` روی "disabled" آن‌ها را کاملاً حذف می‌کند.
- وقتی رزولوشن خروجی با رزولوشن بومی داده‌های pose متفاوت باشد، اندازه نشانگر و خطوط openpose_2d به‌صورت متناسب مقیاس می‌شود.
- اگر پس‌زمینه فریم‌های کمتری از داده‌های pose داشته باشد، آخرین فریم پس‌زمینه برای فریم‌های باقی‌مانده دوباره استفاده می‌شود.
- خروجی شامل یک فریم برای هر فریم pose ورودی است. اگر داده‌های pose هیچ فریمی نداشته باشد، یک تصویر مشکی واحد برگردانده می‌شود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `image` | فریم‌های رندر‌شده: داده‌های pose رسم‌شده با سبک رندر انتخاب‌شده، در صورت اتصال پس‌زمینه روی آن و در غیر این صورت روی مشکی ترکیب می‌شود. یک فریم برای هر فریم pose ورودی، که به‌صورت یک تصویر دسته‌ای واحد برگردانده می‌شود. | IMAGE |

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

---
**Source fingerprint (SHA-256):** `96556283cf07727e6b4bb3549537bf925ed771bab8607f65c93ab54a5f0e9ba5`
