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

Открито-изходна библиотека TypeScript за обработка на 3D файлове

Aspose.3D FOSS за TypeScript е библиотека с MIT-licensed лиценз за работа с 3D файлови формати в Node.js приложения. Инсталирайте я с една единствена команда npm install @aspose/3d и започнете веднага да четете, създавате и записвате 3D сцени в TypeScript, без да се налага да компилирате native addons, без външни SDKs за инсталиране и без нужда от renderer.

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

Aspose.3D FOSS цели Node.js 18, 20 и 22+ с TypeScript 5.0+ и се компилира до CommonJS. Библиотеката се доставя със стриктни настройки на TypeScript компилатора (noImplicitAny, strictNullChecks), така че вашата IDE предоставя пълно autocomplete и compile-time safety. Единствената ѝ 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 FOSS може да се използва

  • Пиплайни на Node.js активи: Импортиране на 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 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 в двоичен 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);

Frequently Asked Questions

Какво е 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.

  

Ресурси за поддръжка и обучение

 Български