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

Aspose.3D FOSS за TypeScript

Зареждайте, създавайте, трансформирайте и експортирайте 3D сцени от Node.js — напълно типизирано, с отворен код и готово за продукция с една единствена npm инсталация.

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

Уча GitHub

Библиотека с отворен код за TypeScript за обработка на 3D файлове

Aspose.3D FOSS за TypeScript е библиотека с лиценз MIT за работа с 3D файлови формати в Node.js приложения. Инсталирайте я с една единствена команда npm install @aspose/3d и започнете да четете, конструирате и записвате 3D сцени в TypeScript веднага, без нужда от компилиране на native addons, без външни 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 формати и типизиран Scene-Graph API

  • OBJ / MTL: Зарежда Wavefront OBJ файлове с придружаващи дефиниции на материали.
  • glTF 2.0 / GLB: Зареждане на PBR материали и бинарен GLB изход чрез 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/texture за по-бързо парсиране.
  • Точност при обратно преминаване: Неизвестните възли на графа на сцената се запазват дословно при повторно запазване.

Опит на разработчиците

Aspose.3D FOSS за TypeScript се инсталира с една единствена команда npm install @aspose/3d. Няма native addons за компилиране. Библиотеката е чисто TypeScript/JavaScript с една автоматично инсталирана зависимост (xmldom).

Силно типизираният API предоставя пълно автодовършване в IDE за всеки клас от графа на сцената и опция за формат. Библиотеката е насочена към Node.js 18–22+ и 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);

Frequently Asked Questions

Какво е Aspose.3D FOSS за TypeScript?

Това е безплатна библиотека за TypeScript/Node.js с лиценз MIT, предназначена за зареждане, манипулиране и запазване на 3D сцени без инсталиране на нативен адон или външен SDK.

Кои 3D формати се поддържат?

OBJ (с .mtl), glTF 2.0 и GLB, STL (бинарен и ASCII), COLLADA (DAE), 3MF и FBX. Всеки формат има специален типизиран клас за опции.

Изисква ли native Node.js addons?

Не. Aspose.3D FOSS за TypeScript е чист JavaScript/TypeScript. Не изисква стъпка на компилация и има единствена runtime зависимост (xmldom), инсталирана автоматично от npm.

Как да го инсталирам?

Изпълнете npm install @aspose/3d. Не са необходими допълнителни системни пакети или native добавки.

Кои версии на Node.js и TypeScript се поддържат?

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

Доставя ли се с TypeScript типови дефиниции?

Да. Всички класове, методи, enums и типове опции са напълно типизирани с noImplicitAny и strictNullChecks активирани.

Мога ли да контролирам ориентацията на координатната система?

Да. Класовете за опции по формат, като ObjLoadOptions и GltfSaveOptions, ви позволяват да обръщате оси, регулирате мащаба и нормализирате нормалите без персонализиран код за парсинг.

Къде мога да намеря изходния код?

Библиотеката е лицензирана под MIT и е хоствана в GitHub. Съобщения за грешки и pull request‑ове са добре дошли.

  

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

 Български