Repolode
Enviar
donmccurdy

donmccurdy/glTF-Transform

SDK e CLI em TypeScript/JavaScript para ler, editar, otimizar e gravar modelos 3D glTF 2.0 no Node.js e na Web.

Ver no GitHubSite
Estrelas
2,063
Forks
223
Issues abertas
82
Último commit
há 17 dias

O que é?

glTF Transform lê, edita e grava modelos 3D no formato glTF 2.0. O projeto é voltado a alterações de baixo nível e reproduzíveis em um modelo, como empacotar ou dividir arquivos, aplicar correções rápidas ou otimizar um asset existente. A API gerencia automaticamente índices de arrays e offsets em bytes, permitindo que desenvolvedores trabalhem com a estrutura do documento sem precisar cuidar manualmente do layout binário.

O projeto é dividido em um SDK core, um pacote de extensões para recursos opcionais do glTF, um pacote de funções com transformações prontas, como prune, dedup, resample, Draco e compressão de texturas, e uma CLI que aplica essas funções a arquivos individuais ou em lote. O core funciona tanto no Node.js quanto em navegadores, então o mesmo código pode ser usado em pipelines de build offline ou em aplicações Web.

A CLI oferece comandos para compressão de geometria com Draco e Meshoptimizer, compressão de texturas com WebP e KTX2/Basis Universal e redimensionamento de texturas via Sharp. Um playground baseado em navegador, em gltf.report, permite testar a API de scripting em um modelo carregado.

Recursos principais

  • 01Lê, edita e grava arquivos glTF 2.0 e GLB com gerenciamento automático de índices e offsets.
  • 02Funciona no Node.js e no navegador com a mesma API core.
  • 03Disponibiliza funções prontas, como prune, dedup, resample e compressão Draco.
  • 04Oferece uma CLI para otimizar arquivos individuais ou em lote, incluindo compressão com Meshopt e de texturas com WebP/KTX2.
  • 05Oferece suporte a transformações personalizadas desenvolvidas com base na API de documentos.

Casos de uso

  • Otimizar assets 3D para um visualizador Web, comprimindo geometria e texturas.
  • Processar em lote uma biblioteca de modelos glTF em um pipeline de build.
  • Empacotar ou dividir arquivos glTF existentes sem recriá-los em uma ferramenta de modelagem.
  • Criar modelos glTF proceduralmente ou desenvolver extensões glTF personalizadas.

Início rápido

  1. 1

    Instale a CLI globalmente pelo npm

    npm install --global @gltf-transform/cli
  2. 2

    Liste os comandos disponíveis da CLI

    gltf-transform --help
  3. 3

    Otimize um modelo em uma única etapa

    gltf-transform optimize input.glb output.glb --texture-compress webp

Antes de usar

  • A CLI requer uma versão LTS do Node.js.
  • Alguns recursos de compressão de texturas precisam do Node.js e da biblioteca Sharp, por isso não são executados no navegador.

Tópicos

#3d#gltf#glb#mesh-processing#optimization#compression#typescript#webgl#scene-graph

Perguntas frequentes

O que é glTF-Transform?
SDK e CLI em TypeScript/JavaScript para ler, editar, otimizar e gravar modelos 3D glTF 2.0 no Node.js e na Web. glTF Transform lê, edita e grava modelos 3D no formato glTF 2.0. O projeto é voltado a alterações de baixo nível e reproduzíveis em um modelo, como empacotar ou dividir arquivos, aplicar correções rápidas ou otimizar um asset existente. A API gerencia automaticamente índices de arrays e offsets em bytes, permitindo que desenvolvedores trabalhem com a estrutura do documento sem precisar cuidar manualmente do layout binário.
glTF-Transform é gratuito? Qual é a licença?
glTF-Transform é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
glTF-Transform ainda é mantido?
Manutenção ativa. O último commit de glTF-Transform foi em 20 de out. de 2026.
Para que posso usar glTF-Transform?
Otimizar assets 3D para um visualizador Web, comprimindo geometria e texturas. Processar em lote uma biblioteca de modelos glTF em um pipeline de build. Empacotar ou dividir arquivos glTF existentes sem recriá-los em uma ferramenta de modelagem. Criar modelos glTF proceduralmente ou desenvolver extensões glTF personalizadas.
Como instalar glTF-Transform?
Instale a CLI globalmente pelo npm: npm install --global @gltf-transform/cli Liste os comandos disponíveis da CLI: gltf-transform --help Otimize um modelo em uma única etapa: gltf-transform optimize input.glb output.glb --texture-compress webp
Onde consigo glTF-Transform?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/donmccurdy/glTF-Transform

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados