# ایجاد اطلاعات دوربین

گره Create Camera Info یک ساختار اطلاعات دوربین برای رندرینگ سه‌بعدی می‌سازد. این گره از سه حالت برای تعریف دوربین پشتیبانی می‌کند: مداری (چرخش افقی/عمودی/فاصله حول یک هدف)، نگاه به (موقعیت صریح در جهان)، و چهارتایی (موقعیت به‌اضافه چرخش). سیستم مختصات راست‌دست با محور Y به‌عنوان محور بالا است.

## ورودی‌ها

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
|---------|---------|----------|--------|--------|
| `mode` | نحوه تعریف دوربین: زوایای مداری، موقعیت صریح، یا موقعیت + چهارتایی. | COMBO | بله | `"orbit"`<br>`"look_at"`<br>`"quaternion"` |
| `target_x` | نقطه نگاه (محور چرخش مداری / هدف). در حالت مداری، با جابجایی آن می‌توان کل دوربین را پن/ترجمه کرد. در حالت چهارتایی نادیده گرفته می‌شود. پیش‌فرض مبدأ مختصات. (پیش‌فرض: 0.0) | FLOAT | خیر | 1000.0- تا 1000.0 |
| `target_y` | مؤلفه Y نقطه هدف. (پیش‌فرض: 0.0) | FLOAT | خیر | 1000.0- تا 1000.0 |
| `target_z` | مؤلفه Z نقطه هدف. (پیش‌فرض: 0.0) | FLOAT | خیر | 1000.0- تا 1000.0 |
| `roll` | چرخش دوربین حول محور دید، برحسب درجه. (پیش‌فرض: 0.0) | FLOAT | خیر | 180.0- تا 180.0 |
| `fov` | میدان دید عمودی برحسب درجه. (پیش‌فرض: 35.0) | FLOAT | خیر | 1.0 تا 120.0 |
| `zoom` | زوم دیجیتال (ضریب فاصله کانونی). مقادیر بزرگ‌تر از 1 بدون جابجایی دوربین، بزرگنمایی می‌کنند. (پیش‌فرض: 1.0) | FLOAT | خیر | 0.01 تا 100.0 |
| `camera_type` | پروجکشن مورد استفاده در Render Splat: پرسپکتیو (کوچک‌نمایی) یا ارتوگرافیک (موازی). (پیش‌فرض: "perspective") | COMBO | خیر | `"perspective"`<br>`"orthographic"` |

### پارامترهای مختص حالت

زمانی که `mode` روی `"orbit"` تنظیم شود، پارامترهای زیر قابل دسترس می‌شوند:

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
|---------|---------|----------|--------|--------|
| `yaw` | زاویه چرخش افقی حول هدف. (پیش‌فرض: 35.0) | FLOAT | بله | 360.0- تا 360.0 |
| `pitch` | زاویه چرخش عمودی حول هدف. (پیش‌فرض: 30.0) | FLOAT | بله | 89.0- تا 89.0 |
| `distance` | فاصله دوربین از هدف. (پیش‌فرض: 4.0) | FLOAT | بله | 0.01 تا 1000.0 |

زمانی که `mode` روی `"look_at"` تنظیم شود، پارامترهای زیر قابل دسترس می‌شوند:

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
|---------|---------|----------|--------|--------|
| `position_x` | موقعیت دوربین در فضای جهان (راست‌دست، Y-بالا). (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |
| `position_y` | مؤلفه Y موقعیت دوربین. (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |
| `position_z` | مؤلفه Z موقعیت دوربین. (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |

زمانی که `mode` روی `"quaternion"` تنظیم شود، پارامترهای زیر قابل دسترس می‌شوند:

| پارامتر | توضیحات | نوع داده | اجباری | محدوده |
|---------|---------|----------|--------|--------|
| `position_x` | موقعیت دوربین در فضای جهان (راست‌دست، Y-بالا). (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |
| `position_y` | مؤلفه Y موقعیت دوربین. (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |
| `position_z` | مؤلفه Z موقعیت دوربین. (پیش‌فرض: 4.0) | FLOAT | بله | 1000.0- تا 1000.0 |
| `quat_x` | مؤلفه X چهارتایی چرخش جهان دوربین. (پیش‌فرض: 0.0) | FLOAT | بله | 1.0- تا 1.0 |
| `quat_y` | مؤلفه Y چهارتایی چرخش جهان دوربین. (پیش‌فرض: 0.0) | FLOAT | بله | 1.0- تا 1.0 |
| `quat_z` | مؤلفه Z چهارتایی چرخش جهان دوربین. (پیش‌فرض: 0.0) | FLOAT | بله | 1.0- تا 1.0 |
| `quat_w` | چهارتایی چرخش جهان دوربین (three.js: به سمت محلی -Z نگاه می‌کند). به‌طور خودکار نرمال می‌شود. (پیش‌فرض: 1.0) | FLOAT | بله | 1.0- تا 1.0 |

**نکته:** پارامترهای `target_x`، `target_y` و `target_z` زمانی که `mode` روی `"quaternion"` تنظیم شود، نادیده گرفته می‌شوند. در حالت `"orbit"`، این پارامترهای هدف، نقطه محوری را تعریف می‌کنند که دوربین حول آن می‌چرخد.

## خروجی‌ها

| نام خروجی | توضیحات | نوع داده |
|-----------|---------|----------|
| `camera_info` | ساختار اطلاعات دوربین شامل موقعیت، چرخش، میدان دید، زوم و نوع پروجکشن برای رندرینگ سه‌بعدی. | LOAD3DCAMERA |

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

---
**Source fingerprint (SHA-256):** `577c114130f72b753d5f15775fe05b3e1e734f5865cca32c576d042583f8e873`