Как да започнете с Aspose.3D FOSS за TypeScript

Как да започнете с 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,и Използвайте желания формат.

Виж също

 Български