Відкрита бібліотека TypeScript для обробки 3D‑файлів

Aspose.3D FOSS for 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 забезпечує повне автодоповнення та безпеку під час компіляції. Єдина залежність під час виконання, xmldom, встановлюється автоматично. Для корпоративного сімейства продуктів дивіться Aspose.3D — Enterprise Product Family.

Підтримка 3D‑форматів та типізований API графа сцени

OBJ / MTL: Завантажуйте файли Wavefront OBJ з відповідними визначеннями матеріалів.
glTF 2.0 / GLB: Завантаження PBR‑матеріалів та бінарний вивід GLB через GltfSaveOptions.
STL: Читати та записувати як бінарні, так і ASCII STL з повною перевіркою кругового проходу.
COLLADA, 3MF, FBX: Додаткова підтримка форматів з класами параметрів для кожного формату.
Full TypeScript types: Кожен клас, метод і параметр мають строгі типи за допомогою noImplicitAny та strictNullChecks.

Де Aspose.3D FOSS можна використовувати

Node.js asset pipelines: Імпорт OBJ‑файлів, валідація та переорієнтація геометрії, і експорт у GLB у CI.
Інструменти для ігор: Пакетно обробляйте 3D сітки без нативного движка чи рендерера.
Робочі процеси 3D друку: Читати, перевіряти та повторно експортувати файли STL і 3MF.
Безсерверні бекенди: Запускайте 3D конвертаційні кінцеві точки в Lambda або Cloud Functions.
Міграція вмісту: Конвертуйте між сімействами форматів у масштабі з одного скрипту.

Опції для кожного формату та контроль координат

Орієнтація системи координат: Перевернути осі та налаштувати масштаб для кожного формату за допомогою класів параметрів.
Нормалізація нормалей: Автоматично нормалізувати нормалі вершин під час завантаження або збереження.
Бінарний vs. JSON вивід: Виберіть компактний GLB або читабельний glTF через GltfSaveOptions.
Керування завантаженням матеріалів: Увімкнути або вимкнути завантаження MTL/текстур для швидшого розбору.
Round-trip fidelity: Невідомі вузли графа сцени зберігаються дослівно при повторному збереженні.

Досвід розробника

Aspose.3D FOSS for TypeScript встановлюється однією командою npm install @aspose/3d. Немає нативних аддонів для компіляції. Бібліотека є чистим TypeScript/JavaScript з однією автоматично встановленою залежністю (xmldom).

Сильно типізований API забезпечує повне автодоповнення IDE для кожного класу графу сцени та параметра формату. Бібліотека орієнтована на Node.js 18–22+ і TypeScript 5.0+, працює ідентично на Linux CI runners і робочих станціях розробників, і має ліцензію 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 у Binary 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. Він не потребує кроку компіляції і має одну runtime-залежність (xmldom), встановлену автоматично через npm.

Як його встановити?

Запустіть npm install @aspose/3d. Додаткові системні пакети чи нативні аддони не потрібні.

Які версії Node.js та TypeScript підтримуються?

Node.js 18, 20 та 22+. TypeScript 5.0+. Бібліотека компілюється у CommonJS і працює зі строгими налаштуваннями TypeScript.

Чи включає воно визначення типів TypeScript?

Так. Усі класи, методи, перелічення та типи параметрів повністю типізовані за допомогою noImplicitAny та strictNullChecks, які ввімкнено.

Чи можу я керувати орієнтацією системи координат?

Так. Класи параметрів для кожного формату, такі як ObjLoadOptions та GltfSaveOptions, дозволяють змінювати осі, регулювати масштаб і нормалізувати нормалі без власного коду парсингу.

Де я можу знайти вихідний код?

Бібліотека має ліцензію MIT і розміщена на GitHub. Звіти про помилки та pull‑request’и вітаються.

Aspose.3D FOSS для TypeScript

Aspose.3D FOSSfor TypeScript