PixiJS adiciona 3D à cena 2D e abre beta sob licença MIT
A equipa do PixiJS abriu a beta pública do PixiJS 3D, a extensão tridimensional oficial do seu motor 2D para o navegador. Aqui, a cena 3D é ligada como um elemento comum da cena 2D: é adicionada à mesma tela que os sprites, o texto e a interface, e é desenhada com eles na ordem comum de camadas. Para os estúdios que fazem com PixiJS jogos de navegador, promos e interfaces interativas, isto significa que um modelo 3D pode ser inserido num projeto já concluído. Não é preciso reescrevê-lo nem correr um segundo motor ao lado.
A extensão é gratuita e distribuída sob licença MIT. Os desenvolvedores projetaram-na antes de tudo para WebGPU; o mesmo código da cena funciona também em WebGL2. A API ainda não está fixada, e prometem lançar a versão 1.0 depois de analisarem as opiniões dos participantes da beta aberta.
«É gratuito. Licença MIT, e assim será sempre».
— a equipa do PixiJS no anúncio da beta aberta
A vista 3D é colocada na cena como um sprite
Toda a cena tridimensional vive dentro de uma vista 3D separada, e essa vista, na cena 2D, comporta-se como um sprite. É possível colocar várias dessas vistas e em quaisquer pontos da composição, cada uma com a sua cena e câmara, como mostra o exemplo com várias vistas. A ordem de sobreposição é simples: os elementos 2D que vêm depois na lista são desenhados por cima do 3D, e os anteriores vêem-se através dele, se a vista não tiver fundo definido. Na sandbox há uma cena em que um logótipo 3D de vidro refrata um poster 2D desenhado atrás dele.
Ainda assim, 2D e 3D continuam a ser mundos separados. Um sprite não pode ser colocado dentro da árvore 3D, e um nó 3D não pode ser posto diretamente na cena 2D. Para mostrar uma interface 2D na superfície de um objeto 3D, ela é renderizada numa textura que pode atualizar-se a cada fotograma. No exemplo do site, é assim que nas faces de um cubo se mostra um contentor 2D ao vivo, e no anúncio uma cena 2D com um relógio aparece no ecrã de um monitor 3D. Para as legendas que seguem um objeto 3D, existe a conversão de coordenadas do espaço da cena para as do ecrã. Por predefinição, a vista 3D interceta os cliques e o hover em toda a sua área retangular, pelo que os botões 2D que ficam por baixo não são premidos enquanto este comportamento não for configurado. O ponteiro reage também aos próprios objetos 3D.
O que o motor sabe fazer
- Modelos. Carrega-se glTF 2.0 na forma de .gltf ou .glb, com compressão de geometria Draco e meshopt, texturas comprimidas, skinning, morph targets e animação. Os clipes de animação são lançados por nome, como no modelo da raposa da demo do site.
- Materiais. Estão disponíveis PBR, Phong, flat e toon; é possível escrever materiais próprios, incluindo de várias passagens.
- Luz e imagem. Há sombras, incluindo em cascata, HDR, compressão tonal, grafo de renderização e pós-processamento, incluindo bloom e ambient occlusion.
- Restante. Vêm incluídas partículas e uma câmara com órbita em volta do objeto.
As cópias de um mesmo prop quase não custam nada. Cada modelo constrói os seus nós, mas usa geometria, materiais e texturas comuns, tal como os sprites usam uma mesma textura. Se se espalharem pelo nível várias caixas do mesmo ficheiro, o ficheiro é carregado uma só vez. Para milhares de cópias está previsto um modo de lote separado.
Velocidade sem otimização manual
A promessa principal do lançamento: uma cena montada da maneira mais evidente já deve funcionar rápido. Os desenvolvedores compararam diferentes formas de renderização, e o motor escolhe sozinho a adequada ao dispositivo, ao navegador e à cena concreta. Os objetos com geometria e material comuns são automaticamente reunidos numa única chamada de desenho instanciada. Cinco cubos com geometria e material comuns são desenhados numa chamada, e doze personagens animadas do mesmo ficheiro de modelo também numa.
O descarte de objetos invisíveis é executado, na maioria dos navegadores com WebGPU, na placa gráfica, num shader de computação. No Safari e em quaisquer iPhone e iPad, para uma cena típica é o processador que o calcula, e passa para a placa gráfica quando o lote de objetos se torna suficientemente grande. O motor recalcula apenas as malhas que mudaram, por isso uma cena estática quase não carrega o processador. Provavelmente, isto é especialmente útil para interfaces em que o objeto 3D está imóvel a maior parte do tempo. Cada navegador descarrega apenas o backend de que precisa, WebGPU ou WebGL2.
Na demonstração em lote há no ecrã 100 000 objetos com sombras a 60 fotogramas por segundo. Em que hardware foram obtidos estes números não é indicado no anúncio. Para mostrar o funcionamento do motor fora dos benchmarks, a equipa publicou dois jogos na sua vitrina de experiências Good Stuff. O Nightward gera todos os gráficos e a música por código e não carrega um único ficheiro de imagem ou som. O Mach 2 funciona em WebGPU e WebGL2, e pode ser jogado com teclado ou no telemóvel. A equipa promete publicar no mesmo lugar as novas experiências 3D.
O que será preciso ter em conta ao montar a cena
A parte 3D tem o seu próprio sistema de coordenadas, e terão de se habituar a ele aqueles que trabalham em píxeis 2D. O eixo Y aponta para cima, e a unidade é o metro. A câmara, por predefinição, não desenha nada mais longe do que 1000 unidades, por isso uma cena montada em tamanhos de píxel ficará cortada. Pode ser necessário escalar os modelos: na demo da raposa, o modelo está reduzido a 0,01 do tamanho original.
A segunda nuance diz respeito à compatibilidade. Se o navegador escolheu WebGPU mas falta à placa gráfica uma função necessária, a aplicação não passará automaticamente para WebGL2 e dará um erro ao arrancar. Na documentação está descrito como verificar o suporte com antecedência. Para telemóveis, o guia aconselha limitar a densidade de píxeis ao valor 2: num ecrã de densidade tripla, isso reduz o número de píxeis desenhados a mais de metade.
A beta fechada já revelou problemas característicos. A exportação do Blender derrubava o carregador de glTF, e em alguns telemóveis Android os shaders pediam mais parâmetros do que o WebGL2 permite. No total, os testadores enviaram mais de 30 relatórios de erros e pedidos de funcionalidades, e a maior parte deles entrou no lançamento.
Onde obter e como começar
O pacote @pixi/3d instala-se juntamente com o pixi.js via npm ou a partir de CDN e requer pixi.js versão 8.23.0 ou mais recente. As fontes estão no repositório do PixiJS 3D no GitHub, e a documentação e os exemplos estão reunidos na página do PixiJS 3D. Ali há 35 guias, mais de 100 exemplos interativos e três tutoriais que funcionam diretamente no editor do navegador. A lição introdutória monta passo a passo um cubo rotativo sobre um chão, coloca a câmara e uma luz direcional e depois carrega um modelo glTF.
Juntamente com a extensão saiu uma skill para agentes de IA, que pode ser ligada no Claude Code, Cursor, Codex e Copilot, e que vem incluída no pacote npm. A documentação foi publicada no formato llms.txt, cómodo para os modelos de linguagem. Os próprios desenvolvedores chamam ao PixiJS 3D a maior adição ao PixiJS desde a oitava versão do motor.
A quem isto servirá e onde estão os riscos
O PixiJS tinha há muito uma extensão 3D de terceiros, a Pixi3D, de um desenvolvedor independente. Suporta PBR e iluminação por mapas de ambiente, e o seu autor informa de uso em produção em centenas de milhares de dispositivos, mas é compatível com o PixiJS das versões 5, 6 e 7. O pacote oficial está pensado para o oitavo ramo, a partir de 8.23.0. Os estúdios com projetos antigos em Pixi3D provavelmente terão primeiro de os passar para o PixiJS atual, e só depois mudar para a nova extensão. Nos materiais não está descrito nenhum caminho de migração pronto.
Quem mais ganha, pelo que se vê, são as equipas cuja base do projeto é bidimensional: jogos casuais de navegador, publicidade playable, landings interativas e interfaces com elementos 3D isolados. Já não precisam de manter no projeto um segundo renderizador e sincronizá-lo com a camada 2D. Para os projetos em que é necessária uma cena 3D completa com um mínimo de 2D, as vantagens são menos evidentes: os desenvolvedores não apresentam comparações com os grandes motores 3D para a web.
O risco principal decorre do próprio estado: a API ainda pode mudar antes da 1.0, e o código escrito agora talvez tenha de ser corrigido. Separadamente, vale a pena verificar a exportação de modelos do Blender e o comportamento em dispositivos Android: foi precisamente aí que a beta fechada encontrou falhas, incluindo o choque com os limites do WebGL2 em alguns telemóveis.
Onde é que integraria uma vista 3D do PixiJS 3D?
- Jogo casual de navegador
- Publicidade playable