1. Продукты
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Загружайте, создавайте, трансформируйте и экспортируйте 3D‑сцены из Node.js — полностью типизированный, открытый и готовый к продакшену с одной установкой npm.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Документация GitHub

Библиотека Open-Source TypeScript для обработки файлов 3D

Aspose.3D FOSS для TypeScript — это библиотека с лицензией MIT для работы с 3D форматами файлов в приложениях Node.js. Установите её одной командой npm install @aspose/3d и сразу начните читать, конструировать и записывать 3D‑сцены на TypeScript, без необходимости компилировать нативные аддоны, без установки внешних SDK и без требуемого рендерера.

Библиотека предоставляет полностью типизированный граф сцены API, построенный вокруг Scene, Node, Entity, Mesh, Camera, Light и Transform, той же концептуальной модели, которую используют профессиональные 3D‑инструменты. Поддерживаемые форматы включают OBJ (Wavefront, с загрузкой материалов .mtl), glTF 2.0 и бинарный GLB (материалы PBR), STL (бинарный и ASCII, полный раунд‑трип), COLLADA (DAE), 3MF и FBX. Классы параметров для каждого формата, такие как ObjLoadOptions и GltfSaveOptions, дают точный контроль над ориентацией системы координат, масштабом, нормализацией нормалей, бинарным против JSON выводом и загрузкой материалов.

Aspose.3D FOSS ориентирована на Node.js 18, 20 и 22+ с TypeScript 5.0+ и компилируется в CommonJS. Библиотека поставляется со строгими настройками компилятора TypeScript (noImplicitAny, strictNullChecks), поэтому ваша IDE предоставляет полное автодополнение и безопасность во время компиляции. Её единственная runtime‑зависимость, xmldom, устанавливается автоматически. Для семейства корпоративных продуктов см. Aspose.3D — Enterprise Product Family.

Поддержка 3D-формата и API для графика с печатными сценами

  • ** OBJ / MTL:** Загрузка файлов Wavefront OB J с сопровождающими их определениями материалов.
  • glTF 2.0 / GLB: Загрузка материалов PBR и вывод бинарного GDB через GltfSaveOptions.
  • STL: Читать и писать как двоичный, так и ASCII STL с полной проверкой обратного пути.
  • COLLADA, 3MF, FBX: Дополнительная поддержка формата с классами опций на формат.
  • Полные типы TypeScript: Каждый класс, метод и вариант строго напечатаны с noImplicitAny и strictNullChecks.

Где Aspose.3D ФОСС можно использовать

  • Node.js asset pipelines: Импорт файлов OBJ, проверка и переориентация геометрии, экспорт как GLB в CI.
  • ** Игровое оборудование:** 3D-машки с бачевой обработкой без собственного движка или рендеринга.
  • Рабочие процессы 3D-печати: Читать, проверять и повторно экспортировать файлы STL и 3MF.
  • Бакенды без сервера: Запустите конечные точки 3D-конверсии в Lambda или Cloud Functions.
  • Миграция контента: Конвертировать между семьями форматов в масштабах с одного сценария.

Опции формата и координационный контроль

  • Ориентация на систему координат: Перевернуть оси и скорректировать масштаб по формату с опционными классами.
  • ** Нормализация:** Автоматически нормализуйте нормы вершин при загрузке или сохранении.
  • Двойной вывод JSON: Выберите компактный GLB или читаемый glTF через GltfSaveOptions.
  • Контроль загрузки материала: Включить или отключать зарядку MTL/текстуры для более быстрого анализа.
  • Вертовой путь: Неизвестные узлы графики сцены сохраняются буквально при повторном сохранении.

Опыт разработчика

Aspose.3D FOSS для TypeScript устанавливается с помощью одной команды npm install @aspose/3d. Нет никаких исходных дополнений, которые можно компилировать. Библиотека является чистой Type Script / JavaScript с одной автоматически установленной зависимостью (xmldom).

Сильно прописанный API обеспечивает полное автокомплектование IDE для каждого класса и формата сценариев. Библиотека ориентирована на Node.js 1822+ и TypeScript 5.0+, работает идентично на Linux CI-бегунах и рабочей станции разработчиков, а также имеет лицензию MIT с открытым трекером проблем на GitHub .

Загрузить сцену OBJ и экспортировать в качестве glTF

Установите с помощью npm, затем используйте scene.open() с ObjLoadOptions для загрузки сетки вместе с её MTL‑файлом материала. Оба open() и save() являются синхронными — не требуется await или цепочка Promise. Вызов scene.save() с расширением .gltf записывает стандартный glTF 2.0 JSON — формат определяется автоматически по расширению файла.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Преобразовать STL в GLB на двоичный код

Для получения компактного двоичного GLB вместо JSON glTF по умолчанию, передайте GltfSaveOptions с binaryMode = true. И open() и save() синхронны не требуется await .

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Часто задаваемые вопросы

Что такое Aspose.3D FOSS для TypeScript?

Это бесплатная библиотека TypeScript/Node.js с лицензией MIT для загрузки, манипуляции и сохранения 3D-сцен без установки какого-либо собственного дополнения или внешнего SDK.

Какие 3D-форматы поддерживаются?

OBJ (с .mtl), glTF 2.0 и GLB, STL (бинарный и ASCII), COLLADA (DAE), 3MF и FBX. Каждый формат имеет специальный класс типовых опций.

Необходимы ли для этого новые дополнения Node.js?

Нет. Aspose.3D FOSS для TypeScript является чистым JavaScript/TypeScript. Он не требует шага компиляции и имеет одну зависимость времени выполнения (xmldom), автоматически установленную npm.

Как я его устанавливаю?

Запустить npm install @aspose/3d. Не требуются дополнительные пакеты системы или нативные дополнения.

Какие версии Node.js и TypeScript поддерживаются?

Node.js 18, 20 и 22+. TypeScript 5.0+. Библиотека компилирует на CommonJS и работает с строгими настройками Type Script.

Содержит ли он определения типов TypeScript?

Да. Все классы, методы, enums и типы опций полностью напечатаны с noImplicitAny и strictNullChecks включенными.

Я могу управлять ориентацией системы координат?

Да. Классы опций на формат, такие как ObjLoadOptions и GltfSaveOptions позволяют переворачивать оси, регулировать масштаб и нормализовать нормы без пользовательского кода анализа.

Где я могу найти исходный код?

Библиотека лицензирована MIT и размещена на GitHub. Отчеты о ошибках и запросы с выводом приветствуются.

  

Ресурсы поддержки и обучения

 Русский