gohud

ثلاث طبقات

← السمات

النمط الجاهز يجمع الثلاث معًا. والحقول التي تتركها فارغة تعود إلى القيم الافتراضية.

الطبقةما الذي تقرّرهكيف تغيّرها
Theme الألوان والمقاسات ومقياس النص، وشكل كل ما يرسمه المحرك — لوحات الأزرار وحقول الإدخال والتبويبات ورسوم مفاتيح التبديل اكتب ملف .tres، أو ولّد واحدًا بـ tools/make_theme.py
GoSkin شكل كل ما يرسمه الكود — عصا التوجيه، ووجوه الخانات السريعة، وحلقة العلامة الإرشادية، والشرائح، والهياكل المؤقتة، والفواصل، وعناوين الأقسام اشتقّ منه صنفًا وتجاوز الدوال التي تهمّك فقط
GoIconSet أيقونات تُطلب بالاسم — 84 رسمة افتراضية، أو 16 رسمة محفورة من مجموعة العصور الوسطى فوقها. حزمة نقوش أو خط أيقونات؛ والكود المستدعي واحد في الحالتين زوّده بمجموعة، أو تجاوز بضعة أسماء فقط
لماذا لا تكفي السمة وحدها. المدوّرة هي الزاوية الوحيدة التي يملكها StyleBoxFlat — اضبط نصف القطر على صفر فتحصل على زاوية قائمة؛ ولا شيء بينهما. أما الزوايا المقطوعة قطريًا، وحافة واحدة أسمك، وتوهّج خارجي: فلا يرسم المحرك منها شيئًا. وعصا التوجيه والعلامة الإرشادية تُرسمان في _draw()، حيث لا تصل السمة أصلًا.

اختيار واحد منها

GoUi.use_preset(GoThemePresets.SCIFI_DARK)

هذا السطر وحده يبدّل السمة والمظهر والأيقونات. ومن المحرّر استعمل Project Settings → Gohud → Theme → Preset؛ ومن مورد إعدادات، GoConfig.preset.

إبقاء حقل واحد على اختيارك

GoUi.use_preset(GoThemePresets.SCIFI_DARK)
GoUi.config.icons = my_icons     # أيقوناتك أنت، وكل ما عداها من النمط الجاهز

ضبط theme أو skin أو icons صراحةً يغلب النمط الجاهز.

الأنماط الجاهزة الستة المدمجة

النمط الجاهزاللوحاتالمظهر · الأيقونات
default_dark · default_lightلوحات StyleBoxFlat مدوّرة على سلّم ظلال متدرّج؛ والأزرار الأساسية ترتفع ثم تغوص عند الضغطGoSkin · 84 أيقونة افتراضية
scifi_dark · scifi_lightلوحات GoStyleBoxCut مشطوفة بحافة نيون وتوهّج؛ وعلامات تركيز من GoStyleBoxBracketGoSkinSciFi — عصا توجيه سداسية · الأيقونات الافتراضية
medieval_dark · medieval_lightإطارات GoStyleBoxMedieval مطروقة — حديد وجلد، أو رقّ — بمسامير وزخارف أركان على القوائمGoSkinMedieval · 16 أيقونة محفورة فوق الافتراضية

العصور الوسطى: حديد وجلد ورقّ

medieval_dark يزاوج الحديد والجلد الداكنين بالذهب العتيق. وmedieval_light يستعمل الرقّ والحبر. وكلاهما يستعمل GoSkinMedieval والودجات القائمة و16 أيقونة أصلية بتفاصيل محفورة؛ أما أيقونات التنقّل فتعود إلى المجموعة الأصلية.

GoUi.use_preset(GoThemePresets.MEDIEVAL_DARK)
# أو: GoUi.use_preset(GoThemePresets.MEDIEVAL_LIGHT)

اختر النمط الجاهز قبل إنشاء واجهتك. وتبقى تجاوزات GoConfig.theme و skin وicons الصريحة هي الأولى. افتح res://addons/gohud/examples/medieval/medieval.tscn واضغط F6 لترى صفحة شخصية وحقيبة وسجل مهام تعمل فعلًا. وأزرارها تبدّل التنويعات وتفتح تفاصيل الأغراض.

واجهات الشخصية والحقيبة والمهام بطراز حديد العصور الوسطى
حديد وجلد
واجهات الشخصية والحقيبة والمهام بطراز رقّ العصور الوسطى
رقّ وحبر

إطارات القوائم فيها مسمار وزخرفة ركن صغيرة؛ أما HUD الدائم الظهور فيحتفظ بحافة هادئة. والصحة والمانا وقدرة التحمّل تستعمل تعبئة حمراء وزرقاء وزيتونية. وخط Cinzel مقصور على العناوين والعناوين الفرعية؛ ونص المتن يبقى على خط المضيف أو الخط الافتراضي. والخط المضمَّن يحمل رخصته في assets/fonts/cinzel/OFL.txt.

المجموعة المحفورة تعيد رسم bag وbook وbox وcoin وcrown وflag وheart وkey وmap وpotion وshield وstar وsword وuser، وتضيف scroll وseal. وكل اسم آخر يعود إلى المجموعة الافتراضية، فيحتفظ close وsettings برسمهما الافتراضي في كل نمط جاهز. وخط Cinzel يغطي الحروف اللاتينية؛ فامنح العناوين المترجمة خطًّا خاصًّا بها عبر shape.fonts.

ما الذي تفحصه حزمة الاختبارات في التنويعتين. أن مظهر العصور الوسطى هو المحدَّد؛ وأن لوحات القوائم وHUD إطارات مطروقة، والزخرفة على القوائم دون غيرها؛ وأن العناوين تستعمل Cinzel بينما يبقى نص المتن على الخط الموروث؛ وأن الأيقونات المحفورة تُستورد بصيغة DPITexture؛ وأن خانة سريعة حقيقية تستعمل المظهر؛ وأن تغيير مقابض نسخة من المظهر يصل إلى الخانة دون المساس بالنمط الجاهز؛ وأن الرجوع يعيد هندسة النمط الافتراضي والخيال العلمي.

اصنع مملكتك أنت

python3 addons/gohud/tools/new_theme.py kingdom --from medieval_dark
# عدّل themes/palettes/kingdom.json، ثم:
python3 addons/gohud/tools/make_theme.py kingdom
godot --headless --path . --import
# وفي GDScript، قبل إنشاء الودجات:
GoUi.use_preset(&"kingdom")

سمات JSON تستطيع أن ترث سمات JSON أخرى. والقيم المحذوفة تحتفظ بإعدادات أصلها؛ أما الوراثة الدائرية فمرفوضة. والنمط الجاهز المولَّد يحتفظ بمجموعة أيقونات أصله.

الإعدادالأثر
shape.material0: حديد · 1: جلد · 2: رقّ. يتحكم في علامات السطح.
shape.grain_alphaعتامة النقش. استعمل 0 للحصول على سطح نظيف.
shape.ornament_scale · shape.bevel_strengthحجم زخرفة ركن القائمة وشدّة إبراز الحافة المشطوفة.
shape.fontsيربط أدوار العنوان والعنوان الفرعي والتعليق والمتن والزر بملفات خطوط res:// داخل الإضافة. والأدوار المحذوفة تحتفظ بخطها الموروث.
skin.dialsنصف قطر الخانة السريعة، وظهور المسامير، والحبيبات، والإبراز. والجدول الكامل أدناه يسرد كل مقبض.