# إنشاء معلومات الكاميرا

تقوم عقدة إنشاء معلومات الكاميرا ببناء هيكل معلومات الكاميرا للعرض ثلاثي الأبعاد. تدعم ثلاثة أوضاع لتعريف الكاميرا: المدار (الانعراج/الانحدار/المسافة حول هدف)، النظر_إلى (موضع عالمي صريح)، والرباعي (موضع بالإضافة إلى الدوران). نظام الإحداثيات هو نظام أيمن مع محور Y كمحور علوي.

## المدخلات

| المعامل | الوصف | نوع البيانات | إلزامي | النطاق |
|---------|-------|---------------|--------|--------|
| `الوضع` | كيفية تعريف الكاميرا: زوايا مدارية، موضع صريح، أو موضع + رباعي. | 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/ar.md)

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