Repolode
Enviar
donmccurdy

donmccurdy/glTF-Transform

SDK y CLI de TypeScript/JavaScript para leer, editar, optimizar y escribir modelos 3D glTF 2.0 en Node.js y la Web.

Ver en GitHubSitio web
Estrellas
2,063
Forks
223
Issues abiertos
82
Último commit
hace 18 días

¿Qué es?

glTF Transform lee, edita y escribe modelos 3D en formato glTF 2.0. Está pensado para realizar cambios reproducibles y de bajo nivel en un modelo, como agrupar o dividir archivos, aplicar correcciones rápidas u optimizar un recurso existente. La API gestiona automáticamente los índices de los arreglos y los desplazamientos en bytes, para que los desarrolladores puedan trabajar con la estructura del documento sin tener que administrar manualmente la disposición binaria.

El proyecto se divide en un SDK principal, un paquete de extensiones para funciones opcionales de glTF, un paquete de funciones con transformaciones listas para usar, como prune, dedup, resample, Draco y la compresión de texturas, y un CLI que aplica estas funciones a archivos individuales o en lote. El núcleo funciona tanto en Node.js como en navegadores, por lo que el mismo código puede usarse en pipelines de compilación sin conexión o en aplicaciones web.

El CLI ofrece comandos para la compresión de geometría con Draco y Meshoptimizer, la compresión de texturas con WebP y KTX2/Basis Universal, y el cambio de tamaño de texturas mediante Sharp. El entorno de pruebas en el navegador, disponible en gltf.report, permite probar la API de scripting con un modelo cargado.

Funciones clave

  • 01Lee, edita y escribe archivos glTF 2.0 y GLB, y gestiona automáticamente los índices y desplazamientos.
  • 02Funciona en Node.js y en el navegador con la misma API principal.
  • 03Incluye funciones listas para usar, como prune, dedup, resample y la compresión Draco.
  • 04Ofrece un CLI para optimizar archivos individuales o en lote, incluida la compresión de geometría con Meshopt y de texturas con WebP/KTX2.
  • 05Admite transformaciones personalizadas escritas con la API de documentos.

Casos de uso

  • Optimizar recursos 3D para un visor web mediante la compresión de geometría y texturas.
  • Procesar en lote una biblioteca de modelos glTF en un pipeline de compilación.
  • Agrupar o dividir archivos glTF existentes sin tener que volver a crearlos en una herramienta de modelado.
  • Crear modelos glTF de forma procedimental o desarrollar extensiones glTF personalizadas.

Inicio rápido

  1. 1

    Instala la CLI globalmente desde npm

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

    Lista los comandos disponibles de la CLI

    gltf-transform --help
  3. 3

    Optimiza un modelo en una sola pasada

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

Antes de usarlo

  • La CLI requiere una versión LTS de Node.js.
  • Algunas funciones de compresión de texturas necesitan Node.js y la biblioteca Sharp, por lo que no se ejecutan en el navegador.

Temas

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

Preguntas frecuentes

¿Qué es glTF-Transform?
SDK y CLI de TypeScript/JavaScript para leer, editar, optimizar y escribir modelos 3D glTF 2.0 en Node.js y la Web. glTF Transform lee, edita y escribe modelos 3D en formato glTF 2.0. Está pensado para realizar cambios reproducibles y de bajo nivel en un modelo, como agrupar o dividir archivos, aplicar correcciones rápidas u optimizar un recurso existente. La API gestiona automáticamente los índices de los arreglos y los desplazamientos en bytes, para que los desarrolladores puedan trabajar con la estructura del documento sin tener que administrar manualmente la disposición binaria.
¿glTF-Transform es gratuito? ¿Qué licencia tiene?
glTF-Transform es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿glTF-Transform sigue mantenido?
Mantenimiento activo. El último commit de glTF-Transform fue el 20 oct 2026.
¿Para qué puedo usar glTF-Transform?
Optimizar recursos 3D para un visor web mediante la compresión de geometría y texturas. Procesar en lote una biblioteca de modelos glTF en un pipeline de compilación. Agrupar o dividir archivos glTF existentes sin tener que volver a crearlos en una herramienta de modelado. Crear modelos glTF de forma procedimental o desarrollar extensiones glTF personalizadas.
¿Cómo se instala glTF-Transform?
Instala la CLI globalmente desde npm: npm install --global @gltf-transform/cli Lista los comandos disponibles de la CLI: gltf-transform --help Optimiza un modelo en una sola pasada: gltf-transform optimize input.glb output.glb --texture-compress webp
¿Dónde consigo glTF-Transform?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/donmccurdy/glTF-Transform

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados