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

NATIVE_GXM_EVALUATION.md

4253 bytes · Original / download

Avaliação do experimento DeltaruneVita/native-gxm

Fonte examinada, somente leitura: C:/Users/wolff/Documents/SDKVita/DeltaruneVita/experiments/native-gxm Hashes dos arquivos consultados: _build/native-gxm-reference-review.json no workspace.

Conclusão

Útil como referência de engenharia e de testes, não como backend intercambiável com o Godot. O CMake usa nanovg-gxm com USE_VITA_SHARK=OFF e programas GXP embutidos. bs_renderer_impl.inc integra a interface do Butterscotch/GameMaker; nossos pontos de integração são RendererCanvasRender e RendererTextureStorage. Não copiamos a VM, estruturas TPAG, assets nem o backend NanoVG para Godot. Não alteramos o projeto DeltaruneVita. Esta avaliação de código não certifica o comportamento desse experimento no aparelho.

Referência Aplicação no Godot
atlas_probe.c: arte assimétrica e transparência Nova cena sintética para revelar UV invertida, região errada, filtragem e alpha
tpag_sprite.c: recorte, origem, escala e rotação CommandRect/AtlasTexture do próprio Godot; GameMaker e Godot têm convenções diferentes
bs_renderer_impl.inc: cache e orçamento de texturas Cache por RID, upload sob demanda e teto inicial de 48 MiB para alocações de textura
bs_renderer_impl.inc: superfícies e mudança de alvo Referência para etapa futura de SubViewport; não portada neste marco
nanovg_gxm_native.h: shaders GXP embutidos Mantemos os programas da libvita2d já aprovada no teste ColorRect
Diagnósticos explícitos de operação sem suporte Mantemos avisos para materiais, MSDF/LCD, repetição e comandos ainda ausentes

Implementado nesta etapa

A ponte é testada no host com API simulada: copia linhas de largura não alinhada corretamente, preserva UV/tint e não libera textura antes da espera pela GPU. A cena foi importada e executada com Godot 4.8-dev7 oficial, completando fases 0–3 sem erro. Nada disso substitui o teste visual no Vita.

Limites importantes

O teto de 48 MiB refere-se às alocações de textura aproximadas em páginas de 256 KiB. Não é o consumo total: imagens CPU, display buffers, runtime e pools também ocupam memória. Não implementamos LRU: uma alocação acima do limite é recusada com diagnóstico. Compressão de imagens suportada pelo Godot é expandida para RGBA8; não equivale a suporte a formatos comprimidos na GPU.

A libvita2d resolve a composição RGB com alpha no framebuffer opaco usado neste teste. Não declaramos correta a composição de alpha em render targets transparentes: precisará ser tratada antes de SubViewport.

Sequência necessária para o port

  1. Validar no aparelho atlas, alpha, recorte, filtros, atualização e Label; preservar ColorRect como regressão já aprovada.
  2. Completar canvas comum: primitivas/polígonos, NinePatch, repetição, tamanho lógico de viewport e política de memória medida em cenas reais.
  3. Implementar SubViewport, texturas de render target, troca de alvo e clear; verificar dependências entre viewports e gerenciamento de recursos.
  4. Definir materiais 2D suportados e tratamento explícito de MSDF, luzes, efeitos de tela e shaders personalizados na exportação.
  5. Consolidar integração do backend (driver próprio, sem nome opengl3), exportação/importação de assets, input, áudio, saves e diagnósticos.
  6. Avaliar um subconjunto 3D depois do 2D, com testes próprios e orçamento de CPU/GPU/memória. O hardware não permite prometer paridade com todos os renderizadores e recursos do Godot 4.8.