syw2-ddraw

# HQCDD — Ferramenta de melhoria de tela para Joseon-ui Ban-gyeok O HQCDD é um plugin wrapper DirectDraw destinado a melhorar a compatibilidade gráfica e a experiência do usuário do jogo legado 'Joseon-ui Ban-gyeok' (SYW2Plus). Esta ferramenta permite que o jogo seja executado suavemente em modo janela ou tela cheia nos ambientes Windows 10 e 11, e fornece compatibilidade com configurações de exibição modernas ao renderizar os gráficos de paleta de 8 bits existentes com base em D3D11. ## Principais recursos ### 1. Melhorias no modo de tela e resolução - **Suporte a modo janela e tela cheia**: é possível alternar entre modo janela e tela cheia com o atalho Alt+Enter. O tamanho da janela pode ser ajustado livremente, e a correção de coordenadas do mouse é aplicada, de modo que a interação com a UI funciona normalmente. - **Expansão widescreen**: além da proporção padrão 4:3, também há suporte à proporção 16:9. A área do campo de batalha é expandida para 1068×600 e o HUD é posicionado no centro, garantindo um campo de visão amplo. - **Seleção de filtro de upscale**: juntamente com a renderização baseada em CPU (GDI) ou GPU, é possível escolher diversos métodos de upscale, como Nearest (bordas de pixel nítidas), Bilinear (suavidade), Sharp Bilinear (equilíbrio) e Integer (multiplicação inteira). ### 2. Correção de bugs de UI (HQNET) - **Restauração da UI de login e chat**: foram corrigidos problemas que ocorriam em versões anteriores, como desaparecimento de caracteres no campo de entrada de login, cintilação e o campo de entrada de chat ficando oculto pelo fundo. - **Otimização da UI do lobby**: os slots de participação, a lista de mapas e o menu de configurações do lobby da sala de jogo são exibidos corretamente, mantendo a proporção e a posição originais mesmo em modo janela. ### 3. Configuração em tempo real e overlay - **Tela de configurações Ctrl+Alt+D**: oferece um painel de configurações que pode ser aberto mesmo durante o jogo. É possível alterar ou salvar imediatamente o modo de tela, o renderizador (GDI/GPU), a sincronização vertical (VSync), o método de upscale, etc. - **Overlay de desempenho (Ctrl+Alt+F)**: exibe métricas de desempenho em tempo real, como FPS, gráfico de intervalo entre quadros, uso de CPU/RAM e tempo de renderização. - **Modo de benchmark (Ctrl+Alt+B)**: permite iniciar e encerrar a medição de desempenho em trechos de combate. ### 4. Gerenciamento de cores integrado ao SYW2X - Em integração com o plugin SYW2X, é possível selecionar e aplicar diretamente, a partir da paleta de 256 cores, cores de identificação de unidades, cores de texto de painéis, cores de barra de status, etc. ## Método de instalação Esta ferramenta tem como alvo jogos nos quais o ESL (ESL Loader) e o plugin SYW2X já estão instalados. Em vez de substituir diretamente o arquivo DLL, utiliza o formato de plugin ASI. 1. **Backup**: faça backup do `ddraw.dll` e dos arquivos de configuração da pasta existente do jogo. 2. **Cópia do plugin**: copie `plugins/hqcdd.asi` do arquivo ZIP para a pasta `plugins` da pasta do jogo. - O `ddraw.dll` existente (carregador ASI) e o `syw2x.asi` devem ser mantidos como estão. 3. **Adição do arquivo de configuração**: coloque `hqcdd.ini` na pasta onde está o EXE do jogo (`[ESL]Syw2plus 2606.exe`). 4. **Execução**: execute diretamente o EXE existente do jogo ESL. Não use launcher separado nem EXE modificado. **Atenção**: as versões DLL e ASI não devem ser instaladas ao mesmo tempo. Não modifique a pasta do sistema do Windows nem o arquivo EXE original. ## Solução de problemas - **A tela de configurações não aparece ou ocorre erro**: verifique o arquivo `hqcdd.log` para checar o estado `ASI active` ou `ASI disabled`. Pode ter havido conflito com outro carregador ASI ou instalação duplicada do `ddrawHooked.dll`. - **Falha na renderização por GPU**: em alguns ambientes, a saída por GPU pode falhar e haver troca automática para GDI. Nesse caso, force `Renderer=gdi` no `hqcdd.ini` ou atualize o driver de vídeo. - **Inicialização**: se o problema persistir, é possível restaurar os valores padrão inicializando a seção `[Display]` do `hqcdd.ini` da seguinte forma: ```ini [Display] Fullscreen=0 Renderer=gdi VSync=0 Scaling=nearest ``` ## Escopo de suporte e observações - Atualmente, foi validado com base no EXE original do ESL 2606 e no plugin SYW2X. - O funcionamento foi confirmado no Windows 10 e Windows 11, e a validação completa para múltiplos monitores e configurações de DPI será realizada em versões futuras. - Esta ferramenta não fornece arquivos do jogo, e os direitos autorais do jogo pertencem a cada detentor de direitos. - Não substitui todas as funcionalidades de softwares externos como o Lossless Scaling (por exemplo, geração de quadros). A licença é MIT, e a documentação do desenvolvedor e o histórico de alterações podem ser consultados no repositório do GitHub.