GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/godot4-psvita / platform / vita

README.md

3670 bytes · Original / download

Godot 4.8-dev — PlayStation Vita

Port experimental com VitaGL e loader de libgodot.so. O objetivo imediato é um template 2D funcional. O plano vigente, as evidências e os critérios de aceite estão em ROADMAP.md, revisado em 2026-10-10.

Estado atual

O README principal registra boot, inicialização dos servidores, loop e logo no Vita. Esses são resultados históricos, não uma certificação do checkout atual. Há alterações locais de shaders, heap, patch VitaGL e um probe de UBO.

O probe corrigido ubo-20261010T223545Z registra PASS no Vita para base e range, com os dois payloads corretos e identidade conferida com o manifesto. A ponte de CanvasData foi implementada com uploads explícitos após o bind do shader e compilou para Vita. Os três casos do Canvas State Probe passaram no aparelho, com pixels exatamente nas cores esperadas e sem erros GL. Outros blocos flattened ainda exigem tratamento. O canvas 2D completo não está aprovado.

Em 2026-10-10 foi compilado um novo probe identificado, com conferência dos bytes gravados, e o loader passou na compilação/link usando a mesma biblioteca. Veja as instruções de build e teste. O PASS de hardware cobre o probe UBO, não o canvas nem um novo build completo do engine.

Em 2026-10-11, o runtime atualizado foi linkado, validado e empacotado com a cena ColorRect (colorrect-20261011T135110Z, aplicativo GDCT40001). Os 650 imports e o conteúdo do VPK passaram nas verificações locais. O teste de boot e renderização dessa versão no Vita está pendente; veja o ROADMAP.

Arquitetura e arquivos

Área Local Responsabilidade
Plataforma os_vita.*, display_server_vita.*, gl_manager_vita.* OS, janela fixa, contexto e loop
Dispositivos audio_driver_vita.*, joypad_vita.* Áudio e controle; validar no teste integrado
Build detect.py, SCsub Toolchain e geração PIC de bin/libgodot.so
Executável loader/ Carrega .so, resolve imports e empacota projeto de teste
Renderer ../../drivers/gles3/ Compatibility adaptado; tradução ES3 para VitaGL/Cg
Compatibilidade GL platform_gl.h Shims; inclui funções vazias ainda não equivalentes a ES3
VitaGL vitagl/ Patch e notas de dependências
Diagnóstico tools/ Probes e análise de dumps

Build e validação

Consultar a receita atual do runtime e as notas VitaGL. SCons agora gera bin/libgodot.so com vita_shared=yes e vita_gl_root explícito. O empacotador tools/package_runtime.py verifica o ELF e os imports e exige o runtime e a dependência identificados antes de gerar o VPK com a cena ColorRect. O log antigo de ausência de pkg-config não descreve o ambiente atual.

Sequência mínima: biblioteca VitaGL identificada → probe UBO PASS no Vita → transporte de uniforms validado → ColorRect/textura/Label → runtime interativo. Para o binding, o teste em tools/tests/test_vitagl_ubo_binding.py é apenas uma guarda de presença da atribuição no código-fonte; não substitui o probe.

Limites

O port não implementa um driver GLES3 completo. A compilação de shaders e os probes simples não aprovam todos os recursos do renderer. Atributos inteiros, bitcasts, interpolação e funções GL vazias exigem validação específica. 3D e GPU particles estão fora do primeiro marco de aceite.

Os relatos históricos de probes e bring-up permanecem no histórico Git. Para decisões atuais, usar a matriz de evidências e prioridades do ROADMAP.