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

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

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

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

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

## ورودی‌ها

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

## خروجی‌ها

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

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

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

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

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

![رابط کاربری گره Load 3D](./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. عملکردهای منوی چپ

![منو](./asset/menu.webp)

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

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

#### صحنه

![منوی صحنه](./asset/menu_scene.webp)

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

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

#### مدل

![منوی مدل](./asset/menu_model.webp)

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

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

#### دوربین

![منوی دوربین](./asset/menu_camera.webp)

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

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

#### نور

![منوی نور](./asset/menu_light.webp)

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

#### خروجی

![منوی خروجی](./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/view_operations.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/Load3D/fa.md)