المقدمة

univis_ui هو إطار UI مبني فوق Bevy، ويعتمد على رندر SDF لإخراج عناصر واجهة حادة وواضحة في 2D و3D.

هذا الكتاب هو المرجع التشغيلي الكامل للمشروع، ويغطي:

بنية المشروع ووحداته الأساسية
كيفية تشغيل النظام عبر UnivisUiPlugin
مكونات التخطيط (UNode, ULayout, USelf) وكل الامتدادات المتقدمة
نظام الالتقاط والتفاعل (UInteraction)
الوحدات الجاهزة وسلوكها والأحداث التي تصدرها
الرندر والقص (UClip) والأداء وقياس الزمن
التاريخ العملي للأمثلة والمراجع الثابتة ومسارات التشغيل الحية الحالية

نطاق هذا الكتاب

هذا الكتاب يشرح الحالة الفعلية للكود داخل المستودع
تشير الفصول إلى المسارات المصدرية داخل crates/*/src/ وإلى حزمة عرض Android الحالية وإلى فهرس الأمثلة الثنائي اللغة
إذا اختلف الكود مستقبلًا، اعتبر المصدر (الكود) هو الحقيقة الأساسية

متطلبات أساسية

Rust (stable حديث)
Bevy 0.18.1 (مضمنة عبر Cargo.toml)
المعرفة الأساسية بـ ECS مفيدة لفهم التصميم

كيف تبني هذا الكتاب

cargo install mdbook
mdbook build docs

للمعاينة الحية:

mdbook serve docs -n 127.0.0.1 -p 3000

رابط الوثائق المنشورة:

https://univiseditor.github.io/univis_ui/

الشرح مقابل `API Docs`

استخدم هذا الكتاب للمفاهيم ومسارات الترحيل وإرشادات العمل
استخدم rustdoc المولد عندما تحتاج المسارات الدقيقة والحقول والتواقيع

ولّد وثائق API بالأمر:

cargo doc --no-deps -p univis_ui

إلى أين بعد ذلك؟

خريطة توفر الأمثلة: فهرس الأمثلة
العرض المنسق للحالة الحالية: معرض الأمثلة
فهرس API: مرجع الواجهة العامة
صفحة الترحيل: الترحيل والقيود