Как да започнете с Aspose.3D FOSS за TypeScript
@aspose/3d за TypeScript е безплатен, лицензиран пакет от MIT за зареждане, манипулиране и 3D файлове в Node.js – няма нужни бинарни, инсталирани от npm.
Стъпка по стъпка ръководство
Стъпка 1: Инсталирайте пакета
Инсталиране от npm (Node.js 18 или по-късно се изисква):
npm install @aspose/3d@24.12.0Проверете инсталацията, която е заредена правилно:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");Стъпка 2: Внос на необходимите класове
Внос на класовете, които се нуждаете от пакета:
import { Scene, Node } from "@aspose/3d";Стъпка 3: Изтегляне на 3D файл
Използване scene.open() за зареждане на всеки поддържан формат. библиотеката открива формата автоматично от разширяването на файла:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);Използвайте метода на статичната фабрика:
const scene = Scene.fromFile("model.glb");Стъпка 4: Преминаване през сцената график
Сцената е дърво на Node Предмети, които са вкоренени в scene.rootNode:
import { Scene, Node } from "@aspose/3d";
function walk(node: Node, depth: number = 0): void {
const indent = " ".repeat(depth * 2);
console.log(`${indent}Node: ${node.name}`);
for (const child of node.childNodes) {
walk(child, depth + 1);
}
}
const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);Стъпка 5: Съхранявайте в различен формат
Използване scene.save() да се изнася до всеки поддържан формат на излизане. библиотеката открива Формат на изхода от разширяването на файла:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");Общи проблеми и фиксиране
Error: ENOENT Когато се обажда scene.open() Пътят, който преминавате не съществува. използвайте абсолютен път или path.resolve() За да се гарантира Пътят на файла е правилен.
Неизвестна грешка във формат Уверете се, че разширяването на файла съответства на действителния формат. библиотеката открива формати от Разширяване на open() и fromFile().Прехвърлете експлицитен параметър на формата, за да преоблачите.
Празна сцена след зареждане Някои бинарни формати могат да изискват конкретни опции за зареждане. опитайте се да използвате експлицитния излишък на зареждането с формат-специфични опции, ако стандартното натоварване произвежда празна сцена.
Видове грешки в Import Типове определения са свързани с пакета. осигуряване "moduleResolution": "bundler" или "node16" се поставя в твоето tsconfig.json.
Често задавани въпроси
@aspose/3d изисква ли някакви бинарни?
Пакетът е чист JavaScript/TypeScript без коренни зависимост. той работи на всяка платформа, която поддържа Node.js 18 или по-късно.
Какви версии на Node.js се поддържат?
Node.js 18 или по-късно Пакетът работи на Windows, macOS и Linux.
Библиотеката е свободна за търговско ползване.?
Да. Тя е издадена под лиценза на MIT. Можете да я използвате, модифицирате и преразпределите за всякакви цели, включително търговски приложения.
Какви 3D формати мога да чета и пиша?
Пакетът поддържа OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA и PLY за четене и двете. Използвайте разширенията, базирани на scene.save() Износът на всички поддържани формати.
Мога ли да създам 3D сцена от скратено?
Да. Създаване на A Scene без аргументи, добавете детски възли към scene.rootNode,и Използвайте желания формат.