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
+2 -2
View File
@@ -1,3 +1,3 @@
---
schemaVersion: 1
lastWork: 1
schemaVersion: 2
lastWork: "0002"
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "ART-0001"
workId: "WRK-0002"
origin: "zelda-center-evidence.zip"
purpose: "Programa recompilado e assets empacotados preservados;cinco capturas reais640x360\
\ centralizadas192,60;bordas/margens/semfault/RAMsave;limite do empacotamento isolado\
\ explicitado."
path: "artifacts/evidence/ART-0001/payload"
sha256: "56ba1c4beb8238a05404e4ca794f9fc14c8d27efe682c339a19bbcd54820130a"
size: 46066
author: "Codex"
createdAt: "2026-11-20T11:46:23.318379Z"
@@ -0,0 +1,31 @@
---
schemaVersion: 1
id: "DSC-0001"
workId: "WRK-0002"
discussionId: "main"
kind: "CONCLUSION"
author: "Codex"
createdAt: "2026-11-20T11:46:23.769974Z"
respondsTo: null
documentVersion: 2
---
# Centralização do Zelda 1 em 640×360
Pedido humano: ajustar somente a centralização do port. Modo DIRECT escolhido explicitamente nesta conversa. Registro exclusivo no AIE do Zelda, WRK-0002; o WRK-0001 de planejamento do próximo recorte permanece separado.
Alteração de código: apenas SCREEN_W=640 e SCREEN_H=360 em src/scene/main.pbs. A área NES continua 256×240, escala1:1. VIEW_X/VIEW_Y passam a192/60; câmera, sprites, HUD, inventário e moldura já usam essas mesmas constantes.
Validação executada:
- Compilação atual via API pública Shipper.prepare, em cópia temporária de src/manifesto/assets. Bytecode produzido com sucesso.
- Limite do harness: o caminho de empacotamento isolado produziu asset_table vazia, mesmo após abrir ProjectSession; isso gerou imagens internas pretas e não foi aceito como validação do jogo. A causa não foi investigada e não deve ser atribuída à UI.
- Para validar somente a apresentação sem migrar assets, o cartucho temporário combinou o bytecode recém-compilado com manifest, assets.pa, asset_table, metadata e preload já existentes no build do jogo. A identidade/capabilities/app_id/memcard_slots dos manifestos coincidem; os recursos foram copiados sem modificar bytes. São30preloads existentes.
- Runtime atual640×360: inicialização, abertura, seleção de New Game, overworld, abertura/fechamento do inventário, retorno ao overworld. Cinco capturas com conteúdo real, sem fault.
- Cada captura exige640×360/stride640/RGBA8888, áreaNES256×240 em192/60, todos os1052pixels da borda externa e160768pixels externos com as cores esperadas; conteúdo com mais de duas cores. Abertura, overworld e inventário também inspecionados visualmente.
- A moldura externa fica em184/52, tamanho272×256, com8pixels de margem interna. Margens da imagem:192px nos lados e60px acima/abaixo.
- Boot em memory_fresh, sem montar/ler/gravar .studio/memcard.pmc. Encerramento da sessão de teste concluído. Nenhum save do usuário foi usado.
Entrega incremental: atualizar apenas build/program.pbx com o bytecode validado; manter os recursos empacotados existentes. Fontes de gameplay, dados NES, assets, app_id e formato de save não foram alterados. Nenhuma fixture foi instalada em src/main.pbs. Sem commits ou push neste ajuste.
Notas de apresentação/feedback atualizadas nos documentos do port. Resultado pronto para revisão humana; não registrar aceite de entrega por inferência.
@@ -0,0 +1,13 @@
---
schemaVersion: 1
id: "DSC-0002"
workId: "WRK-0002"
discussionId: "main"
kind: "NOTE"
author: "Codex"
createdAt: "2026-11-20T11:59:54.458715Z"
respondsTo: null
documentVersion: 2
---
Autorização humana explícita após apresentação do resultado e das cinco capturas: "commit e push do zelda-1". Publicar o ajuste de centralização, as notas e as evidências no próprio repositório Zelda. Este registro atesta autorização de commit/push; não altera o planejamento do WRK-0001 nem inventa outro aceite.
@@ -0,0 +1,50 @@
---
schemaVersion: 1
id: "WRK-0002"
title: "Centralizar Zelda 1 no framebuffer 640x360"
description: "Ajuste pontual solicitado pelo humano: somente centralizar o port no\
\ novo target; atualizar SCREEN_W/SCREEN_H em src/scene/main.pbs, do qual câmera/sprites/HUD/moldura\
\ já derivam VIEW_X/VIEW_Y. Validar build e captura atual, preservando gameplay\
\ e cartão do usuário."
goal: "Manter a área NES 256x240 em escala1:1 centralizada em640x360, origem192,60."
motivation: ""
constraints:
- "Preservar256x240,escala1:1,assets,mecânicas,app_id e save; não retomar os recortes\
\ pendentes do WRK-0001 nem fazer commits/push sem pedido específico."
acceptanceCriteria:
- "Código de apresentação usa640x360 e calculaVIEW_X192/VIEW_Y60 para imagemNES256x240."
- "Build/captura atuais conferidos e resultado registrado; cartão do usuário não usado\
\ em escrita."
status: "OPEN"
createdAt: "2026-11-20T10:45:49.384818Z"
updatedAt: "2026-11-20T11:59:54.467987Z"
author: "Codex"
repositories: []
discussions:
- "DSC-0001"
- "DSC-0002"
decisions: []
artifacts:
- "ART-0001"
plans: []
completions: []
events: []
archived: false
topics: []
surveys: []
dispositions: []
agentRuns: []
epic: false
guidance:
mode: "DIRECT"
approvalPolicy: "REQUIRED"
history:
- mode: "DIRECT"
approvalPolicy: "REQUIRED"
by: "Codex"
reason: "Escolha explícita do humano nesta conversa: DIRECT — ajustar e validar\
\ a centralização (recomendado)."
at: "2026-11-20T10:45:49.376202Z"
humanApproved: true
decisionRequests: []
---
+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.**
+2 -2
View File
@@ -5,8 +5,8 @@ import { Gfx } from @sdk:gfx;
import { Stage } from @zelda1:stage;
// Presentation only: every NES pixel remains one Prometeu framebuffer pixel.
declare const SCREEN_W: int = 480;
declare const SCREEN_H: int = 270;
declare const SCREEN_W: int = 640;
declare const SCREEN_H: int = 360;
declare const VIEW_W: int = 256;
declare const VIEW_H: int = 240;
declare const VIEW_X: int = (SCREEN_W - VIEW_W) / 2;