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

Aspose.3D FOSS for 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 add‑ons, без външни 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 формати и типизиран Scene-Graph 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 файлове.
  • Безсървърни бекендове: Изпълнявайте 3D конверсионни крайни точки в Lambda или Cloud Functions.
  • Миграция на съдържание: Конвертирайте между семейства формати в мащаб от един скрипт.

Опции за всеки формат и контрол на координатите

  • Ориентация на координатната система: Обръщане на осите и коригиране на мащаба според формата с помощта на класове за опции.
  • Нормализиране на нормалите: Автоматично нормализиране на върховите нормали при зареждане или запазване.
  • Бинарен vs. JSON изход: Изберете компактен GLB или четим glTF чрез GltfSaveOptions.
  • Контрол на зареждането на материали: Включете или изключете зареждането на MTL/текстури за по-бързо парсиране.
  • Точност при обратен процес: Неизвестните възли в графа на сцената се запазват буквално при повторно запазване.

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

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

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

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. Не са необходими допълнителни системни пакети или нативни адони.

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

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

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

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

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

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

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

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

  

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

 Български