# ایجاد فایل انیمیشن سه‌بعدی

این گره از داده‌های ژست، یک فایل انیمیشن سه‌بعدی آماده‌ی ذخیره‌سازی می‌سازد. می‌توانید یک GLB متحرک را در چند سبک بصری — مش کامل بدن، پیش‌نمایش فقط مفاصل، اسکلت OpenPose، یا ریگ کپسولی SCAIL — صادر کنید، یا به‌جای آن یک کلیپ ضبط حرکت BVH ذخیره کنید. خروجی به یک گره ذخیره‌سازی فایل مانند Save 3D Model وصل می‌شود تا فایل روی دیسک نوشته شود.

## ورودی‌ها

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

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `pose_data` | داده‌های ژست سه‌بعدی. داده‌های ژست MHR را می‌پذیرد (پارامترهای مدل/شکل/حالت چهره، نقاط کلیدی MHR70، رنگ‌های متعارف، ماسک رأس دست) یا داده‌های ژست Kimodo (ریگ خارجی با محور Y به بالا با رأس‌های پیش‌بینی‌شده هر فریم و دوربین). | MHR_POSE_DATA / KIMODO_POSE_DATA | بله | — |
| `قالب` | قالب خروجی، هر دو به Save 3D Model داده می‌شوند تا روی دیسک نوشته شوند. 'glb' = GLB متحرک (mesh / bones / openpose / scail). 'bvh' = کلیپ موشن‌کپچر BVH (یک اسکلت؛ به مدل نیاز دارد). (پیش‌فرض: glb) | DYNAMIC_COMBO | بله | "glb"<br>"bvh" |
| `sam3d_body_model` | مدل بدنه SAM3D اختیاری. برای قالب‌های 'bvh'، 'body_mesh' و 'bones_only' ضروری است، مگر اینکه داده‌های ژست دارای یک جایگزین اسکلت (skeleton override) باشد. | SAM3D_BODY_MODEL | خیر | — |
| `fps` | نرخ فریم انیمیشن. (پیش‌فرض: 24.0) | FLOAT | بله | 1.0-240.0 |
| `camera_translation` | اعمال pred_cam_t در ترجمه ریشه: 'off' = موقعیت بایند؛ 'centered' = اختلاف از فریم 0؛ 'absolute' = خام (Z عمق دوربین است — معمولاً فاصله بر حسب متر). (پیش‌فرض: off) | COMBO | بله | "off"<br>"centered"<br>"absolute" |
| `track_index` | انتخاب ترک: 1- = همه ترک‌ها؛ 0≤ = تک‌ترک. (پیش‌فرض: 1-) | INT | بله | -1 تا 15 |

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

این ورودی‌ها وقتی `format` روی "glb" تنظیم شود ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `mesh_style` | سبک بصری GLB: 'body_mesh' = آرمیچر واقعی (127 استخوان، اسکینینگ، فریم‌های کلیدی TRS، 72 مورف چهره؛ به مدل نیاز دارد). 'bones_only' = پریمییتیوهای استخوانی‌شکل در هر مفصل (پیش‌نمایش آرمیچر). 'openpose' = اسکلت سه‌بعدی OpenPose-18 از نقاط کلیدی. 'scail' = ریگ کپسولی سه‌بعدی SCAIL (استوانه‌های باز که با کره‌های مفصل هم‌سطح در انتها بسته می‌شوند). (پیش‌فرض: body_mesh) | DYNAMIC_COMBO | بله | "body_mesh"<br>"bones_only"<br>"openpose"<br>"scail" |
| `bone_smooth_window` | پنجره هموارسازی گاوسی روی فریم‌های کلیدی چرخش هر استخوان / ترک‌های نقاط کلیدی. 0 = غیرفعال. 7 تا 15 چرخش‌ها/لرزش‌ها را آرام می‌کند در جاهایی که گره Smooth بالادستی پیک‌ها را از دست می‌دهد. (پیش‌فرض: 0) | INT | بله | 0-51، گام 2 |

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

وقتی `mesh_style` روی "body_mesh" باشد ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `bone_vis` | شکل نمایش استخوان، که به‌صورت صلب به هر مفصل اسکین شده است. 'off' = بدون نمایش استخوان؛ 'octahedrons' = استخوان‌های جهت‌دار به سبک بلندر. (پیش‌فرض: off) | DYNAMIC_COMBO | بله | "off"<br>"octahedrons" |
| `bone_vis_radius_m` | وقتی `bone_vis` = "octahedrons" ظاهر می‌شود. شعاع بر حسب متر (شعاع کره / نصف عرض هشت‌وجهی). (پیش‌فرض: 0.02) | FLOAT | بله | 0.005-0.5 |
| `bone_vis_color` | وقتی `bone_vis` = "octahedrons" ظاهر می‌شود. رنگ‌های رأس برای هر استخوان (متریال بدون نور). 'white' = هیچ، 'rainbow_y' = طیف رنگ سر تا پا. (پیش‌فرض: rainbow_y) | COMBO | بله | "white"<br>"rainbow_y" |
| `shader` | رنگ‌های per-vertex را مطابق با سایه‌زن‌های گره Render اعمال می‌کند (COLOR_0 + KHR_materials_unlit). 'default' = بدون رنگ. (پیش‌فرض: default) | DYNAMIC_COMBO | بله | "default"<br>"rainbow"<br>"rainbow_face_normal"<br>"rainbow_face_semantic" |
| `rainbow_tilt_z` | وقتی `shader` یکی از انواع rainbow باشد ظاهر می‌شود. چرخش محور طیف رنگ حول Z (جلو). چپ/راست را متمایز می‌کند. (پیش‌فرض: 35.0-) | FLOAT | بله | -90.0 تا 90.0 |
| `rainbow_tilt_x` | وقتی `shader` یکی از انواع rainbow باشد ظاهر می‌شود. چرخش محور طیف رنگ حول X (راست). جلو/عقب را متمایز می‌کند. (پیش‌فرض: 0.0) | FLOAT | بله | -90.0 تا 90.0 |
| `person_palette_falloff` | وقتی `shader` یکی از انواع rainbow باشد ظاهر می‌شود. اشباع‌زدایی برای هر شخص: هر ترک ترکیب پاستلی ‎(1 - falloff^k)‎ دریافت می‌کند. (پیش‌فرض: 0.6) | FLOAT | بله | 0.1-1.0 |

#### ورودی‌های Bones Only

وقتی `mesh_style` روی "bones_only" باشد ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `bone_vis` | شکل نمایش استخوان، که به‌صورت صلب به هر مفصل اسکین شده است. 'octahedrons' = استخوان‌های جهت‌دار به سبک بلندر (مفصل ← فرزند اولیه). | DYNAMIC_COMBO | بله | "octahedrons" |
| `bone_vis_radius_m` | شعاع بر حسب متر (شعاع کره / نصف عرض هشت‌وجهی). (پیش‌فرض: 0.02) | FLOAT | بله | 0.005-0.5 |
| `bone_vis_color` | رنگ‌های رأس برای هر استخوان (متریال بدون نور). 'white' = هیچ، 'rainbow_y' = طیف رنگ سر تا پا. (پیش‌فرض: rainbow_y) | COMBO | بله | "white"<br>"rainbow_y" |

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

وقتی `mesh_style` روی "openpose" باشد ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `marker_radius_m` | شعاع کره بر حسب متر. (پیش‌فرض: 0.010) | FLOAT | بله | 0.005-0.1 |
| `stick_radius_m` | نصف‌عرض اندام بر حسب متر. به‌طور خودکار به bone_length × 0.1 محدود می‌شود. (پیش‌فرض: 0.008) | FLOAT | بله | 0.002-0.05 |
| `include_hands` | افزودن دست‌های 21+21 OpenPose (مچ + 5 انگشت × 4 مفصل، پایه←نوک) که از pred_keypoints_3d گرفته می‌شوند. (پیش‌فرض: False) | BOOLEAN | بله | True / False |
| `hand_marker_radius_m` | شعاع کره دست بر حسب متر. (پیش‌فرض: 0.005) | FLOAT | بله | 0.001-0.1 |
| `hand_stick_radius_m` | نصف‌عرض اندام دست بر حسب متر. (پیش‌فرض: 0.003) | FLOAT | بله | 0.001-0.05 |
| `face_style` | نشانه‌های کانتور چهره که از pred_vertices در شناسه‌های ثابت رأس سر نمونه‌برداری می‌شوند (به canonical_colors در pose_data نیاز دارد). 'full' = همه حدود 30 نقطه؛ 'eyes_mouth' = فقط چشم‌ها + لب‌های بیرونی. (پیش‌فرض: disabled) | COMBO | بله | "disabled"<br>"full"<br>"eyes_mouth" |
| `face_marker_radius_m` | شعاع نقطه چهره. 0 = خودکار = 0.3 × marker_radius_m. (پیش‌فرض: 0.0) | FLOAT | بله | 0.0-0.05 |

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

وقتی `mesh_style` روی "scail" باشد ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `stick_radius_m` | شعاع استوانه بر حسب متر. استخوان‌ها استوانه‌های بازی با شعاع ثابت هستند؛ کره‌های مفصل (با اندازه خودکار برای تطبیق) انتهای باز را می‌پوشانند. مرجع SCAIL = 0.0215 متر. (پیش‌فرض: 0.022) | FLOAT | بله | 0.002-0.1 |
| `marker_radius_m` | شعاع کره مفصل. 0 = خودکار = stick_radius_m (کلاهک هم‌سطح). (پیش‌فرض: 0.0) | FLOAT | بله | 0.0-0.1 |
| `material_roughness` | زبری PBR. مرجع SCAIL = 0.3. 1 = مات؛ 0 = کرومی. (پیش‌فرض: 0.3) | FLOAT | بله | 0.0-1.0 |
| `include_hands` | افزودن 21+21 نقطه کلیدی دست + میله‌های کپسولی برای هر ترک. (پیش‌فرض: False) | BOOLEAN | بله | True / False |
| `hand_marker_radius_m` | شعاع کره دست بر حسب متر. (پیش‌فرض: 0.005) | FLOAT | بله | 0.001-0.05 |
| `hand_stick_radius_m` | شعاع استوانه دست بر حسب متر. (پیش‌فرض: 0.003) | FLOAT | بله | 0.001-0.05 |
| `face_style` | نشانه‌های کانتور چهره که از pred_vertices نمونه‌برداری می‌شوند (به canonical_colors در pose_data نیاز دارد). 'full' = همه حدود 30 نقطه؛ 'eyes_mouth' = فقط چشم‌ها + لب‌های بیرونی. (پیش‌فرض: disabled) | COMBO | بله | "disabled"<br>"full"<br>"eyes_mouth" |

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

وقتی `format` روی "bvh" تنظیم شود ظاهر می‌شوند.

| پارامتر | توضیحات | نوع داده | الزامی | بازه |
|-----------|-------------|-----------|----------|-------|
| `units` | واحدهای OFFSET/موقعیت BVH. 'cm' استاندارد موشن‌کپچر است. (پیش‌فرض: cm) | COMBO | بله | "cm"<br>"m" |

**یادداشت‌ها:**

- قالب `bvh` و سبک‌های مش `body_mesh` و `bones_only` به ورودی `sam3d_body_model` نیاز دارند، مگر اینکه خود `pose_data` دارای یک جایگزین اسکلت (skeleton override) باشد (یک دیکشنری `_skeleton_override`، مثلاً از گره KimodoSample). اگر هیچ‌کدام در دسترس نباشد، گره خطا صادر می‌کند. سبک‌های `openpose` و `scail` مستقل از ریگ هستند و مستقیماً بدون مدل بدنه از نقاط کلیدی کار می‌کنند.
- در قالب `bvh`، خروجی شامل یک اسکلت واحد است. وقتی `track_index` برابر 1- باشد (همه ترک‌ها)، اولین ترک استفاده می‌شود.
- گزینه‌های `full` و `eyes_mouth` برای `face_style` به `canonical_colors` در داده‌های ژست نیاز دارند؛ این مورد وقتی موجود است که داده‌های ژست از خط لوله MHR همراه با مدل بدنه می‌آیند.
- `bone_smooth_window` بین 0 و 51 با گام‌های 2 جلو می‌رود.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-------------|-------------|-----------|
| `model_3d` | فایل انیمیشن تولیدشده: یک GLB متحرک یا کلیپ موشن‌کپچر BVH، آماده برای ذخیره‌سازی روی دیسک با گره‌ای مانند Save 3D Model. | 3D_FILE |

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

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