Як почати з 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";Використовуйте 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().Проведіть параметр формату, який виражається.
Порожня сцена після завантаження Деякі бінарні формати можуть вимагати певних опцій навантаження. спробуйте використовувати експлицитну перевантажену систему. з форматно-специфічними опціями, якщо завантаження по умові створює порожню сцену.
Типовий імпорт помилок Визначення типу вбудовані з пакетом. забезпечити "moduleResolution": "bundler" або "node16" Він встановлений у вашій tsconfig.json.
Часті запитання
Чи потрібні @aspose/3d будь-які вроджені бінарні копії?
Пакет є чистим JavaScript/TypeScript без надійних залежностей. Він працює на будь-якій платформі, що підтримує Node.js 18 або пізніше.
Які версії Node.js підтримуються?
Node.js 18 or later. The package runs on Windows, macOS, and Linux.
Чи є бібліотека вільною для комерційного використання?
Він випускається під ліцензією MIT. Ви можете використовувати, змінювати і перерозповсюджувати його для будь-яких цілей, включаючи комерційні додатки.
Які 3D-формати можна читати і писати?
Пакет підтримує OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA і PLY для обох читань. Використовуйте розширення на основі scene.save() експортувати в будь-який підтримуваний формат.
Чи можна створити 3D-сцену з нуля?
Будівництво a Scene Без аргументів додайте дитячі вузли до scene.rootNode,І Зберегти до бажаного формату.