عن المشروع

# HQCDD — أداة تحسين شاشة 조선의반격 HQCDD هو إضافة غلاف DirectDraw تهدف إلى تحسين توافق الرسومات وتجربة المستخدم للعبة القديمة '조선의반격' (SYW2Plus). تتيح هذه الأداة تشغيل اللعبة بسلاسة في وضع النافذة أو ملء الشاشة على بيئتي Windows 10 و11، وتُخرج رسومات لوحة الألوان 8-بت القديمة عبر D3D11 لتوفير توافق مع إعدادات العرض الحديثة. ## الميزات الرئيسية ### 1. تحسين وضع الشاشة والدقة - **دعم وضع النافذة وملء الشاشة**: يمكن التبديل بين وضع النافذة وملء الشاشة عبر اختصار Alt+Enter. يمكن تغيير حجم النافذة بحرية مع تطبيق تصحيح إحداثيات الماوس لضمان تفاعل سليم مع واجهة المستخدم. - **توسيع الشاشة العريضة**: بالإضافة إلى نسبة 4:3 الافتراضية، يتم دعم نسبة 16:9. يتم توسيع منطقة ساحة المعركة إلى 1068×600 ووضع HUD في المنتصف للحصول على مجال رؤية أوسع. - **اختيار مرشح التكبير**: يمكن الاختيار بين العرض المعتمد على CPU (GDI) أو GPU مع طرق تكبير متنوعة مثل Nearest (حدود بكسل واضحة)، Bilinear (ناعم)، Sharp Bilinear (متوازن)، Integer (مضاعف صحيح). ### 2. حل أخطاء واجهة المستخدم (HQNET) - **استعادة واجهة تسجيل الدخول والدردشة**: تم حل مشكلات اختفاء النص في حقل إدخال تسجيل الدخول، والوميض، واختفاء حقل إدخال الدردشة خلف الخلفية التي كانت تحدث في الإصدارات السابقة. - **تحسين واجهة الردهة**: تظهر فتحات المشاركة في ردهة غرفة اللعب، وقائمة الخرائط، وقائمة الإعدادات بشكل صحيح مع الحفاظ على النسب والمواضع الأصلية حتى في وضع النافذة. ### 3. الإعدادات الفورية والتراكب - **شاشة إعدادات Ctrl+Alt+D**: توفر لوحة إعدادات يمكن فتحها أثناء تقدم اللعب. يمكن تغيير أو حفظ وضع الشاشة، والعرض (GDI/GPU)، والمزامنة العمودية (VSync)، وطريقة التكبير فوراً. - **تراكب الأداء (Ctrl+Alt+F)**: يعرض مؤشرات الأداء الفورية مثل FPS، ورسم بياني للفاصل بين الإطارات، واستخدام CPU/RAM، ووقت العرض. - **وضع القياس المرجعي (Ctrl+Alt+B)**: يمكن بدء وإنهاء قياس الأداء في مقاطع القتال. ### 4. إدارة الألوان المتكاملة مع SYW2X - بالتكامل مع إضافة SYW2X، يمكن اختيار وتطبيق ألوان تعريف الوحدات، وألوان نص اللوحات، وألوان شريط الحالة مباشرة من لوحة الألوان 256. ## طريقة التثبيت تستهدف هذه الأداة لعبة تم تثبيت ESL (ESL Loader) وإضافة SYW2X عليها بالفعل. بدلاً من استبدال ملف DLL مباشرة، يتم استخدام صيغة إضافة ASI. 1. **النسخ الاحتياطي**: خذ نسخة احتياطية من `ddraw.dll` وملفات الإعدادات في مجلد اللعبة الحالي. 2. **نسخ الإضافة**: انسخ `plugins/hqcdd.asi` من ملف ZIP إلى مجلد `plugins` في مجلد اللعبة. - يجب الحفاظ على `ddraw.dll` (محمل ASI) و`syw2x.asi` الحاليين كما هما. 3. **إضافة ملف الإعدادات**: ضع `hqcdd.ini` في المجلد الذي يحتوي على ملف اللعبة التنفيذي (`[ESL]Syw2plus 2606.exe`). 4. **التشغيل**: شغّل ملف اللعبة التنفيذي ESL مباشرة. لا تستخدم مشغلاً منفصلاً أو ملفاً تنفيذياً معدلاً. **تنبيه**: يجب عدم تثبيت نسخة DLL ونسخة ASI في نفس الوقت. لا يتم تعديل مجلد نظام Windows أو ملف EXE الأصلي. ## حل المشكلات - **عدم ظهور شاشة الإعدادات أو حدوث خطأ**: تحقق من ملف `hqcdd.log` لفحص حالة `ASI active` أو `ASI disabled`. قد يكون هناك تعارض مع محمل ASI آخر أو تثبيت مكرر لـ `ddrawHooked.dll`. - **فشل عرض GPU**: في بعض البيئات قد يفشل إخراج GPU ويتم التبديل تلقائياً إلى GDI. في هذه الحالة، اضبط `Renderer=gdi` قسرياً في `hqcdd.ini`، أو حدّث برنامج تشغيل الرسومات. - **إعادة التهيئة**: إذا استمرت المشكلة، يمكن إعادة قسم `[Display]` في `hqcdd.ini` إلى القيم الافتراضية كما يلي: ```ini [Display] Fullscreen=0 Renderer=gdi VSync=0 Scaling=nearest ``` ## نطاق الدعم والملاحظات - تم التحقق حالياً بناءً على ملف EXE الأصلي ESL 2606 وإضافة SYW2X. - تم تأكيد العمل على Windows 10 وWindows 11، وسيتم إجراء التحقق الكامل من إعدادات الشاشات المتعددة وDPI في إصدارات مستقبلية. - لا توفر هذه الأداة ملفات اللعبة، وحقوق نشر اللعبة تعود لكل مالك حقوق. - لا تحل محل جميع وظائف البرامج الخارجية مثل Lossless Scaling (مثل توليد الإطارات). الترخيص هو MIT، ويمكن الاطلاع على وثائق المطور وسجل التغييرات في مستودع GitHub.