Відкрито‑джерельна бібліотека 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 забезпечує повне автодоповнення та безпеку під час компіляції. Єдина runtime‑залежність, xmldom, встановлюється автоматично.

Підтримка 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: Імпортуйте OBJ‑файли, перевіряйте та переорієнтуйте геометрію, а потім експортуйте як GLB у CI.
Інструменти для ігор: Пакетна обробка 3D‑мешів без використання рідного движка або рендерера.
Робочі процеси 3D‑друку: Читати, перевіряти та повторно експортувати STL та 3MF файли.
Serverless backends: Запускайте 3D конвертаційні кінцеві точки в Lambda або Cloud Functions.
Content migration: Конвертуйте між сімействами форматів у масштабі за допомогою одного скрипту.

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

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

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

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

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

Завантажити сцену OBJ та експортувати у glTF

Встановіть за допомогою npm, потім використайте синхронний метод scene.open() з ObjLoadOptions, щоб завантажити сітку разом з її MTL‑файлом матеріалу. Виклик 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());

// Експортувати як glTF 2.0 JSON
scene.save("model.gltf");

Конвертувати STL у бінарний GLB

Щоб створити компактний бінарний GLB замість типового JSON glTF, передайте GltfSaveOptions з binaryMode = true.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Зберегти як компактний бінарний 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