GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/DeltaruneVita / docs

ch5-town-shadows-v07711.md

2085 bytes · Original / download

Chapter 5 — sombras da cidade no Experimental-GL (v0.77-11)

Evidência

O log butterscotch-probe.log de 2026-10-11 confirma Experimental-GL com Shaders ON. shd_shadowblend, shd_shadowblend_evening, shd_forcecolour e shd_forcefullalpha compilaram; os shaders 25 e 41 também ficaram ativos em room_town_south. Cinco superfícies de sombra foram criadas. A captura, porém, não contém as sombras estáticas nem as projetadas pelos personagens.

A regressão local usa o shader 25 e o data.win real do Chapter 5. A máscara de teste tinha alfa 0 fora e 255 dentro, mas a composição permanecia branca. Assim, a geração da máscara e o uniforme shadowCol não eram a causa.

Causa e correção

O bridge 2D do Vita enviava posição, UV e cor através de glVertexPointer, glTexCoordPointer e glColorPointer. Essas são entradas do programa interno fixed-function do VitaGL. Os programas compilados do Experimental-GL usam atributos genéricos ligados aos índices 0, 1 e 2; portanto podiam aparecer no log como compilados/ativos sem receber nenhum vértice.

O bridge agora usa glVertexAttribPointer enquanto um programa experimental está ativo e restaura as client arrays originais no fallback ou shader_reset. Isso cobre quads diretos, a conversão de glBegin/glEnd, superfícies, sprites, tilemaps e primitivas que passam pelos shaders compactos. Legacy-GL sem shader continua no caminho anterior.

Validação e limites

scripts/test-ch5-shadow.py desenha uma máscara em uma superfície, aplica o shader real e verifica pixels internos/externos. Falhava antes e passou depois. Também passaram test-experimental-gl-contract.py e test-finale-render.py nos renderizadores Legacy e Modern. O build Vita valida a disponibilidade das APIs e o link do novo caminho; a aparência final ainda precisa ser confirmada no aparelho em room_town_south, Experimental-GL + Shaders ON.

Pacote: Deltarune-v0.77-11.vpk, 5.645.275 bytes, 171 entradas e CRC íntegro. SHA-256: f4cec87108da1e182c1ca2af2243bd3a5d287649a44e715d5fa3a92d1a4fd222.