### مرور کلی

گره `Load3DAnimation` یک گره اصلی برای بارگذاری و پردازش فایل‌های مدل سه‌بعدی است. هنگام بارگذاری گره، به‌طور خودکار منابع سه‌بعدی موجود را از مسیر `ComfyUI/input/3d/` بازیابی می‌کند. همچنین می‌توانید با استفاده از قابلیت آپلود، فایل‌های سه‌بعدی پشتیبانی‌شده را برای پیش‌نمایش بارگذاری کنید.

> - بیشتر عملکردهای این گره مشابه گره Load 3D است، اما این گره از بارگذاری مدل‌های دارای انیمیشن پشتیبانی می‌کند و می‌توانید انیمیشن‌های مربوطه را در گره پیش‌نمایش کنید.
> - محتوای این مستندات با گره Load3D یکسان است، زیرا به جز پیش‌نمایش و پخش انیمیشن، قابلیت‌های آن‌ها کاملاً مشابه است.

**فرمت‌های پشتیبانی‌شده**
در حال حاضر، این گره از چندین فرمت فایل سه‌بعدی از جمله `.gltf`، `.glb`، `.obj`، `.fbx` و `.stl` پشتیبانی می‌کند.

**تنظیمات برگزیده گره‌های سه‌بعدی**
برخی تنظیمات برگزیده مرتبط با گره‌های سه‌بعدی را می‌توان در منوی تنظیمات ComfyUI پیکربندی کرد. لطفاً برای تنظیمات مربوطه به مستندات زیر مراجعه کنید:

[منوی تنظیمات](https://docs.comfy.org/interface/settings/3d)

علاوه بر خروجی‌های معمول گره، Load3D دارای تنظیمات زیادی مرتبط با نمای سه‌بعدی در منوی بوم (Canvas) است.

## ورودی‌ها

| نام پارامتر | توضیحات | نوع | پیش‌فرض | محدوده |
| --- | --- | --- | --- | --- |
| `model_file` | مسیر فایل مدل سه‌بعدی، از آپلود پشتیبانی می‌کند، به‌طور پیش‌فرض فایل‌های مدل را از `ComfyUI/input/3d/` می‌خواند | انتخاب فایل | - | فرمت‌های پشتیبانی‌شده |
| `width` | عرض رندر بوم | INT | 1024 | 1-4096 |
| `height` | ارتفاع رندر بوم | INT | 1024 | 1-4096 |

## خروجی‌ها

| نام پارامتر | توضیحات | نوع داده |
| --- | --- | --- |
| `image` | تصویر رندر شده بوم | IMAGE |
| `mask` | ماسک حاوی موقعیت فعلی مدل | MASK |
| `mesh_path` | مسیر فایل مدل | STRING |
| `normal` | نقشه نرمال | IMAGE |
| `lineart` | خروجی تصویر خطی، `edge_threshold` مربوطه را می‌توان در منوی مدل بوم تنظیم کرد | IMAGE |
| `camera_info` | اطلاعات دوربین | LOAD3D_CAMERA |
| `recording_video` | ویدیوی ضبط شده (فقط زمانی که ضبط وجود داشته باشد) | VIDEO |

پیش‌نمایش تمام خروجی‌ها:
![نمایش عملیات دمو](../Load3D/asset/load3d_outputs.webp)

## توضیحات ناحیه بوم

ناحیه بوم گره Load3D شامل عملیات‌های نمای متعددی است، از جمله:

- تنظیمات نمای پیش‌نمایش (شبکه، رنگ پس‌زمینه، نمای پیش‌نمایش)
- کنترل دوربین: کنترل FOV، نوع دوربین
- شدت نور سراسری: تنظیم شدت نور
- ضبط ویدیو: ضبط و خروجی ویدیو
- خروجی مدل: پشتیبانی از فرمت‌های `GLB`، `OBJ`، `STL`
- و موارد دیگر

![رابط کاربری گره Load 3D](../Load3D/asset/load3d_ui.jpg)

1. شامل چندین منو و منوهای پنهان گره Load 3D است
2. منوی `تغییر اندازه پنجره پیش‌نمایش` و `ضبط ویدیوی بوم`
3. محور عملیات نمای سه‌بعدی
4. تصویر کوچک پیش‌نمایش
5. تنظیمات اندازه پیش‌نمایش، مقیاس نمایش نمای پیش‌نمایش با تنظیم ابعاد و سپس تغییر اندازه پنجره

### 1. عملیات‌های نما

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/view_operations.mp4" type="video/mp4">
  مرورگر شما از پخش ویدیو پشتیبانی نمی‌کند.
</video>

عملیات‌های کنترل نما:

- کلیک چپ + کشیدن: چرخش نما
- کلیک راست + کشیدن: جابجایی نما
- چرخاندن چرخ وسط یا کلیک وسط + کشیدن: بزرگنمایی/کوچکنمایی
- محور مختصات: تغییر نماها

### 2. عملکردهای منوی چپ

![منو](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu.webp)

در بوم، برخی تنظیمات در منو پنهان شده‌اند. برای باز کردن منوهای مختلف، دکمه منو را کلیک کنید

- 1. صحنه (Scene): شامل شبکه پنجره پیش‌نمایش، رنگ پس‌زمینه، تنظیمات پیش‌نمایش
- 2. مدل (Model): حالت رندر مدل، مواد بافت، تنظیمات جهت بالا
- 3. دوربین (Camera):切换 بین نمای متعامد و پرسپکتیو و تنظیم اندازه زاویه پرسپکتیو
- 4. نور (Light): شدت نور سراسری صحنه
- 5. خروجی (Export): خروجی مدل به فرمت‌های دیگر (GLB, OBJ, STL)

#### صحنه (Scene)

![منوی صحنه](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp)

منوی صحنه برخی از عملکردهای اساسی تنظیم صحنه را فراهم می‌کند

1. نمایش/مخفی کردن شبکه
2. تنظیم رنگ پس‌زمینه
3. کلیک برای آپلود تصویر پس‌زمینه
4. مخفی کردن پیش‌نمایش

#### مدل (Model)

![منوی مدل](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp)

منوی مدل برخی از عملکردهای مرتبط با مدل را فراهم می‌کند

1. **جهت بالا (Up direction)**: تعیین می‌کند که کدام محور جهت بالای مدل باشد
2. **حالت مواد (Material mode)**: تغییر حالت‌های رندر مدل - اصلی (Original)، نرمال (Normal)، سیمی (Wireframe)، خطی (Lineart)

#### دوربین (Camera)

![منوی دوربین](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp)

این منو قابلیت切换 بین نمای متعامد و پرسپکتیو و تنظیم اندازه زاویه پرسپکتیو را فراهم می‌کند

1. **دوربین (Camera)**:切换 سریع بین نمای متعامد و نمای متعامد
2. **FOV**: تنظیم زاویه FOV

#### نور (Light)

![منوی نور](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp)

از طریق این منو، می‌توانید به سرعت شدت نور سراسری صحنه را تنظیم کنید

#### خروجی (Export)

![منوی خروجی](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp)

این منو قابلیت تبدیل سریع و خروجی فرمت‌های مدل را فراهم می‌کند

### 3. عملکردهای منوی راست

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/recording.mp4" type="video/mp4">
  مرورگر شما از پخش ویدیو پشتیبانی نمی‌کند.
</video>

منوی راست دو عملکرد اصلی دارد:

1. **تنظیم مجدد نسبت نما (Reset view ratio)**: پس از کلیک روی دکمه، نما نسبت ناحیه رندر بوم را با توجه به عرض و ارتفاع تنظیم‌شده تنظیم می‌کند
2. **ضبط ویدیو (Video recording)**: به شما امکان می‌دهد عملیات‌های نمای سه‌بعدی فعلی را به صورت ویدیو ضبط کنید، از واردات پشتیبانی می‌کند و می‌تواند به عنوان `recording_video` به گره‌های بعدی خروجی داده شود

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