Files
zelda-1-prometeu-port/extracted/graphics/README.md
T

60 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Gráficos extraídos de Zelda 1
Extração dos **15 blocos de padrões gráficos documentados** da ROM local,
sem alterar a ROM e sem incluir áudio. São 1.196 tiles 8×8, dos quais
1.055 possuem padrões distintos. Repetições são mantidas porque os índices
e endereços fazem parte da organização original.
## Arquivos
- `overview.png`: catálogo dos 15 blocos com nomes e ampliação de 3×.
- `tiles/<bloco>/<índice>.png`: cada tile em resolução original, 8×8.
- `sheets/<bloco>.png`: folhas com 16 tiles por linha.
- `sheets/<bloco>@4x.png`: ampliação sem suavização para inspeção.
- `ppu/`: tabelas de padrões 128×128 reconstruídas para abertura, mundo
externo e nove dungeons. Áreas não carregadas começam zeradas; não são
capturas de uma PPU em execução. Células são indexadas da esquerda para
a direita, de cima para baixo, de 0 a 255.
- `manifest.json`: hash da ROM, offsets, endereços PPU, hashes dos padrões,
arquivos de saída e ordem de carregamento dos conjuntos.
São **1.249 PNGs** no total: 1.196 tiles, 30 folhas, 22 tabelas PPU e um catálogo.
## Cor e composição
Os PNGs usam modo indexado `P`. Os valores 0, 1, 2 e 3 correspondem exatamente
aos índices de cor dos padrões NES. A paleta de visualização é cinza neutro
(0, 85, 170, 255), não as cores finais do jogo. Não foi adicionada transparência.
Em sprites NES, o índice zero é transparente; em fundos ele tem outra função.
A ROM não armazena personagens inteiros e cenários como PNGs. Eles são montados
com tiles e tabelas de composição, paletas, atributos e espelhamento. Portanto,
esta entrega cobre os padrões gráficos brutos, **não** todas as imagens compostas,
animações, mapas ou variantes de paleta. Esses dados exigem uma etapa separada
de reconstrução. As tabelas PPU também são catálogos, não telas do jogo.
## Reproduzir
Na raiz do projeto, com Python 3 e Pillow instalados:
```sh
python3 tools/extract_graphics.py
```
Opções: `--rom caminho` e `--output diretório`. O script rejeita ROMs com outro
SHA-256 para impedir extrações incorretas com offsets de uma revisão diferente.
Cada PNG individual é reaberto e convertido de volta para NES 2bpp; seus 16 bytes
devem ser idênticos aos da ROM.
## Proveniência
Mapa de offsets: [bins.xml da desmontagem de Aldo Núñez](https://github.com/aldonunez/zelda1-disassembly/blob/master/src/bins.xml).
Os offsets dessa referência excluem o cabeçalho iNES de 16 bytes.
As tabelas de carregamento em `src/Z_01.asm`, `src/Z_02.asm` e `src/Z_03.asm`
da mesma referência determinam destinos e tamanhos PPU. As tabelas comuns
do banco 2 e de seleção do banco 3 também foram conferidas na ROM local.
O extrator funciona sem acesso à rede e contém o mapa necessário.
Entrada verificada:
`89232edf4f9b52e3cb872094bc78973de080befca2ddea893b6e936066514d4e`.