fix(scene): center the NES viewport in the 640x360 framebuffer

Keep the 256x240 game image at 1:1 scale and move its shared presentation
origin to (192,60). Camera, HUD, sprites, masks and frame already derive
their coordinates from the scene's screen dimensions.

Update port presentation notes and preserve local WRK-0002 validation.
Fresh bytecode was checked with unchanged packed assets in five captures
using the current runtime and an in-memory save session.

The user explicitly requested publication: "commit e push do zelda-1".
This commit is contained in:
2026-11-20 11:59:54 +00:00
parent c9e68ed0a4
commit 02876f1b86
9 changed files with 124 additions and 6 deletions
+1 -1
View File
@@ -54,7 +54,7 @@ Não reutilizar taskId da sessão encerrada nem reativar bombas de teste no iní
| Área | Estado e comportamento disponível | Fontes principais |
|---|---|---|
| Assets NES | Extração de patterns, paletas, mapas e descritores utilizados no recorte; PNGs e dados rastreáveis à ROM local verificada. Não é certificação de extração de todo o conteúdo do jogo. | `tools/extract_graphics.py`, `tools/extract_start_room.py`, `tools/nes_object_graphics.py`, `assets/`, `extracted/` |
| Apresentação | Área NES de 256×240, escala 1:1, centralizada numa caixa; terreno, atores e HUD compostos separadamente. HUD na camada 2, atores na 1. | `src/scene`, `src/hud` |
| Apresentação | Área NES de 256×240, escala 1:1, centralizada em (192,60) no framebuffer 640×360; terreno, atores e HUD compostos separadamente. HUD na camada 2, atores na 1. | `src/scene`, `src/hud` |
| Link: movimento | Quatro direções, animação, alinhamento à grade e movimento fracionário orientados pela ROM; escolha de direção conforme posição na grade, não uma prioridade vertical global inventada. | `src/link/movement.pbs`, `src/link/controller.pbs` |
| Link: espada | Ataque direcional, animação e alcance; começa sem espada; coleta da primeira espada com pose de erguer o item. Graus de espada tratados nos dados/dano, sem todos os locais de aquisição. | `src/link/sword.pbs`, `src/link/render.pbs`, `src/inventory` |
| Projétil de espada | Disparo condicionado à vida cheia, slot único e dispersão; colisão com os inimigos existentes. | `src/link/beam.pbs` |
+12 -1
View File
@@ -257,7 +257,7 @@ com localização no fonte e manter o LSP funcional mesmo quando o lowering falh
**P2 · Lacuna na superfície de autoria consultada; solução local validada.**
O port mantém a área NES de 256×240 dentro do framebuffer 480×270. A referência
Na validação original, o port mantinha a área NES de 256×240 dentro do framebuffer 480×270. A referência
`@sdk:composer` consultada expõe câmera, vínculo de cena e emissão de sprites,
sem parâmetros de retângulo de viewport, clipping ou escala de apresentação.
A especificação GFX documenta resolução base fixa e escala pelo host.
@@ -276,6 +276,17 @@ Melhoria: oferecer uma configuração documentada para área lógica, encaixe 1:
clipping e, futuramente, escala inteira no host. Preservar a imagem canônica
do runtime e tornar explícita a diferença entre área de jogo e apresentação.
Atualização de 20/11/2026: a área NES está centralizada no framebuffer
640×360 em (192,60), preservando 256×240 e escala 1:1. Bastou atualizar as
duas constantes de tela em `src/scene/main.pbs`; câmera, HUD, sprites e moldura
já compartilhavam a origem. Cinco capturas atuais (abertura, menu inicial,
overworld, inventário e retorno) conferiram moldura e margens; três também
foram inspecionadas visualmente. O programa foi recompilado e validado com
os assets empacotados existentes, preservados byte a byte, e save em RAM.
O harness de build isolado gerou uma tabela de assets vazia: a causa não foi
investigada, e esse resultado não foi aceito como captura válida do jogo.
Isso delimita o caminho de validação; não é diagnóstico visual da UI.
### ATR-13 Reset headless retornou sucesso, mas a sessão ficou terminada
**P2 · Uma ocorrência observada; causa pendente.**