À propos du projet

# HQCDD — Outil d'amélioration d'affichage pour Joseon-ui Ban-gyeok HQCDD est un plugin wrapper DirectDraw destiné à améliorer la compatibilité graphique et l'expérience utilisateur du jeu legacy « Joseon-ui Ban-gyeok » (SYW2Plus). Cet outil permet au jeu de s'exécuter de manière fluide en mode fenêtré ou plein écran sous Windows 10 et 11, et produit les graphiques existants en palette 8 bits via D3D11 afin d'offrir une compatibilité avec les configurations d'affichage modernes. ## Fonctionnalités principales ### 1. Amélioration des modes d'affichage et des résolutions - **Prise en charge du mode fenêtré et du plein écran** : le raccourci Alt+Entrée permet de basculer entre le mode fenêtré et le plein écran. La taille de la fenêtre peut être ajustée librement, et la correction des coordonnées de la souris est appliquée pour que les interactions avec l'interface fonctionnent normalement. - **Extension grand écran** : en plus du ratio 4:3 par défaut, le ratio 16:9 est pris en charge. La zone de champ de bataille est étendue à 1068×600 et le HUD est centré afin d'obtenir un large champ de vision. - **Choix du filtre d'agrandissement** : avec un rendu basé CPU (GDI) ou GPU, il est possible de choisir parmi plusieurs méthodes d'agrandissement telles que Nearest (netteté des contours de pixels), Bilinear (douceur), Sharp Bilinear (équilibré), Integer (mise à l'échelle entière), etc. ### 2. Résolution des bugs d'interface (HQNET) - **Restauration de l'interface de connexion et de chat** : correction des problèmes présents dans les versions précédentes, notamment la disparition des caractères dans le champ de saisie de connexion, les scintillements, et le champ de saisie du chat masqué par l'arrière-plan. - **Optimisation de l'interface du lobby** : les emplacements de participation, la liste des cartes et le menu de configuration du lobby de la salle de jeu conservent leur ratio et leur position d'origine même en mode fenêtré et s'affichent correctement. ### 3. Configuration en temps réel et superposition - **Écran de configuration Ctrl+Alt+D** : fournit un panneau de configuration pouvant être ouvert même pendant le jeu. Il permet de modifier ou d'enregistrer immédiatement le mode d'affichage, le moteur de rendu (GDI/GPU), la synchronisation verticale (VSync), la méthode d'agrandissement, etc. - **Superposition de performances (Ctrl+Alt+F)** : affiche des indicateurs de performance en temps réel tels que les FPS, le graphique d'intervalle entre images, l'utilisation CPU/RAM, le temps de rendu, etc. - **Mode benchmark (Ctrl+Alt+B)** : permet de démarrer et d'arrêter la mesure des performances dans les séquences de combat. ### 4. Gestion intégrée des couleurs SYW2X - En liaison avec le plugin SYW2X, il est possible de sélectionner et d'appliquer directement depuis la palette de 256 couleurs les couleurs d'identification des unités, la couleur du texte des panneaux, la couleur de la barre d'état, etc. ## Méthode d'installation Cet outil cible un jeu sur lequel ESL (ESL Loader) et le plugin SYW2X sont déjà installés. Au lieu de remplacer directement le fichier DLL, il utilise le format de plugin ASI. 1. **Sauvegarde** : sauvegardez le `ddraw.dll` et les fichiers de configuration du dossier de jeu existant. 2. **Copie du plugin** : copiez `plugins/hqcdd.asi` contenu dans le fichier ZIP dans le dossier `plugins` du dossier de jeu. - Le `ddraw.dll` existant (chargeur ASI) et `syw2x.asi` doivent être conservés tels quels. 3. **Ajout du fichier de configuration** : placez `hqcdd.ini` dans le dossier où se trouve l'EXE du jeu (`[ESL]Syw2plus 2606.exe`). 4. **Exécution** : lancez directement l'EXE du jeu ESL existant. N'utilisez pas de lanceur séparé ni d'EXE patché. **Attention** : la version DLL et la version ASI ne doivent pas être installées simultanément. Ne modifiez pas le dossier système Windows ni le fichier EXE d'origine. ## Dépannage - **L'écran de configuration ne s'affiche pas ou une erreur se produit** : vérifiez le fichier `hqcdd.log` pour contrôler l'état `ASI active` ou `ASI disabled`. Il peut y avoir un conflit avec un autre chargeur ASI ou une installation en double de `ddrawHooked.dll`. - **Échec du rendu GPU** : dans certains environnements, la sortie GPU peut échouer et basculer automatiquement vers GDI. Dans ce cas, forcez `Renderer=gdi` dans `hqcdd.ini` ou mettez à jour le pilote graphique. - **Initialisation** : si le problème persiste, vous pouvez réinitialiser la section `[Display]` de `hqcdd.ini` comme suit pour revenir aux valeurs par défaut : ```ini [Display] Fullscreen=0 Renderer=gdi VSync=0 Scaling=nearest ``` ## Périmètre de prise en charge et précautions - Actuellement validé sur la base de l'EXE d'origine ESL 2606 et du plugin SYW2X. - Le fonctionnement a été confirmé sous Windows 10 et Windows 11 ; la validation complète des configurations multi-écrans et DPI sera effectuée dans une future version. - Cet outil ne fournit pas les fichiers du jeu, et les droits d'auteur du jeu appartiennent à leurs détenteurs respectifs. - Il ne remplace pas toutes les fonctionnalités de logiciels externes tels que Lossless Scaling (par exemple, la génération d'images). La licence est MIT, et la documentation développeur ainsi que l'historique des modifications sont disponibles dans le dépôt GitHub.