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

Aspose.3D FOSS for TypeScript

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

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

  • 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. Немає наційних додатків, які можна компілювати. Бібліотека є чистим Typescript / 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?

Це безкоштовна, ліцензована MIT бібліотека TypeScript / Node.js для завантаження, маніпуляції та збереження 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?

Всі класи, методи, енуми та типи опцій повністю вписані з noImplicitAny і strictNullChecks включеним.

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

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

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

Бібліотека має ліцензію MIT і розміщена на GitHub. Доповіді про помилки та запити за витягом вітаються.

  

Ресурси Підтримки та Навчання

 Українська