Repolode
donmccurdy

donmccurdy/glTF-Transform

TypeScript/JavaScript SDK и CLI для чтения, редактирования, оптимизации и записи 3D-моделей glTF 2.0 в Node.js и веб-браузерах.

Звёзды
2,063
Форки
223
Открытые issues
82
Последний коммит
18 дней назад

Что это?

glTF Transform читает, редактирует и записывает 3D-модели в формате glTF 2.0. Он предназначен для низкоуровневого воспроизводимого преобразования моделей: например, объединения или разделения файлов, применения быстрых исправлений и оптимизации существующих ресурсов. API автоматически обрабатывает индексы массивов и смещения в байтах, поэтому разработчики могут работать со структурой документа, не управляя вручную размещением бинарных данных.

Проект состоит из основного SDK, пакета расширений для дополнительных возможностей glTF, пакета функций с готовыми преобразованиями — например, prune, dedup, resample, Draco и сжатием текстур — и CLI, который применяет эти функции к отдельным файлам или пакетами. Ядро работает и в Node.js, и в браузерах, поэтому один и тот же код подходит как для офлайн-конвейеров сборки, так и для веб-приложений.

CLI предоставляет команды для сжатия геометрии с помощью Draco и Meshoptimizer, сжатия текстур в WebP и KTX2/Basis Universal, а также изменения размера текстур через Sharp. В браузерной песочнице на gltf.report можно опробовать API для скриптов на загруженной модели.

Ключевые возможности

  • 01Читает, редактирует и записывает файлы glTF 2.0 и GLB, автоматически управляя индексами и смещениями.
  • 02Работает в Node.js и браузере с одним и тем же основным API.
  • 03Предоставляет готовые функции, например prune, dedup, resample и сжатие Draco.
  • 04Предлагает CLI для оптимизации отдельных файлов и пакетов файлов, включая сжатие геометрии с помощью Meshopt и текстур в WebP/KTX2.
  • 05Поддерживает пользовательские преобразования, написанные с использованием API документов.

Сценарии использования

  • Оптимизация 3D-ресурсов для веб-просмотрщика за счёт сжатия геометрии и текстур.
  • Пакетная обработка библиотеки моделей glTF в конвейере сборки.
  • Объединение или разделение существующих файлов glTF без повторного создания моделей в редакторе.
  • Процедурное создание моделей glTF или разработка пользовательских расширений glTF.

Быстрый старт

  1. 1

    Установите CLI глобально через npm

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

    Просмотрите список доступных команд CLI

    gltf-transform --help
  3. 3

    Оптимизируйте модель за один проход

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

Что важно знать

  • Для работы CLI требуется версия Node.js с долгосрочной поддержкой (LTS).
  • Для некоторых функций сжатия текстур нужны Node.js и библиотека Sharp, поэтому они не работают в браузере.

Темы

Частые вопросы

Что такое glTF-Transform?
TypeScript/JavaScript SDK и CLI для чтения, редактирования, оптимизации и записи 3D-моделей glTF 2.0 в Node.js и веб-браузерах. glTF Transform читает, редактирует и записывает 3D-модели в формате glTF 2.0. Он предназначен для низкоуровневого воспроизводимого преобразования моделей: например, объединения или разделения файлов, применения быстрых исправлений и оптимизации существующих ресурсов. API автоматически обрабатывает индексы массивов и смещения в байтах, поэтому разработчики могут работать со структурой документа, не управляя вручную размещением бинарных данных.
glTF-Transform можно использовать бесплатно? Какая у него лицензия?
glTF-Transform распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
glTF-Transform всё ещё поддерживается?
Активно поддерживается. Последний коммит в glTF-Transform — 20 окт. 2026 г..
Для чего можно использовать glTF-Transform?
Оптимизация 3D-ресурсов для веб-просмотрщика за счёт сжатия геометрии и текстур. Пакетная обработка библиотеки моделей glTF в конвейере сборки. Объединение или разделение существующих файлов glTF без повторного создания моделей в редакторе. Процедурное создание моделей glTF или разработка пользовательских расширений glTF.
Как установить glTF-Transform?
Установите CLI глобально через npm: npm install --global @gltf-transform/cli Просмотрите список доступных команд CLI: gltf-transform --help Оптимизируйте модель за один проход: gltf-transform optimize input.glb output.glb --texture-compress webp
Где скачать glTF-Transform?
Исходный код и инструкции по установке — на GitHub: https://github.com/donmccurdy/glTF-Transform

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Библиотека C/C++ для оптимизации треугольных сеток: ускоряет их рендеринг на GPU и уменьшает размер хранения и передачи.

Инструменты разработчика#computer-graphics#gpu#mesh-processing
8,8 тыс.+75 за неделю751C++MITАктивно поддерживаетсяОбновлён 24 дня назад

Браузерный инструмент для проверки 3D- и планшетных сканов по CAD: подбор геометрических элементов, измерения, анализ отклонений и реверс-инжиниринг в STEP.

956+147 за неделю174TypeScriptAGPL-3.0Активно поддерживаетсяОбновлён 3 дня назад

Движок физически корректного рендеринга в реальном времени для Android, iOS, Linux, macOS, Windows и WebGL2, рассчитанный на компактность и эффективность на Android.

20,7 тыс.+30 за неделю2,3 тыс.C++Apache-2.0Активно поддерживаетсяОбновлён вчера