Hvordan man begynder med Aspose.3D FOSS for TypeScript

@aspose/3d for TypeScript er en gratis, MIT-licenspakke til indlæse, manipulation og gemme 3D-filer i Node.js ingen native binære filer kræves, installererbar fra npm.

Trin-for-trin vejledning

Trin 1: Installer pakken

Installer fra npm (Node.js 18 eller nyere kræves):

npm install @aspose/3d@24.12.0

Kontrollér, at installationen er korrekt indlæst:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

Trin 2: Import af krævede klasser

Import af de klasser, du har brug for fra pakken:

import { Scene, Node } from "@aspose/3d";

Trin 3: Lade en 3D-fil op

Anvendelse: scene.open() at indlæse ethvert understøttet format. Biblioteket registrerer det formate automatisk fra filudvidelsen:

import { Scene } from "@aspose/3d";

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

Eller brug den statiske fabrikmetode:

const scene = Scene.fromFile("model.glb");

Trin 4: Gå gennem scenegrafen

En fyldt scene er et træ af Node objekter med rod i 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);

Trin 5: Gem i et andet format

Anvendelse: scene.save() Biblioteket registrerer den pågældende data i et format, der er tilgængeligt for alle brugere. Udgangsformat fra filudvidelsen:

import { Scene } from "@aspose/3d";

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Almindelige problemer og løsninger

Error: ENOENT ved opkald scene.open() Den vej, du har kørt igennem eksisterer ikke. path.resolve() at sikre, at filvejen er korrekt.

Ukendt formatfejl Sørg for, at filudvidelsen svarer til det faktiske format. Biblioteket registrerer formatet ved: forlængelse af open() og: fromFile(). Passer et udtrykkeligt formatparameter til overskrive.

Løs scene efter indlæsning Nogle binære formater kan kræve specifikke indlæsesmuligheder. Prøv at bruge den eksplicitte overbelastning med format-specifikke indstillinger, hvis standardindlæsningen giver en tom scene.

TypeScript-importfejl Typedefinitioner er bundet med pakken. "moduleResolution": "bundler" eller en anden "node16" er indstillet i din tsconfig.json.

Ofte stillede spørgsmål

Er @aspose/3d kræver nogen indfødte binære?

Pakken er ren JavaScript/TypeScript uden indfødte afhængigheder. Den kører på enhver platform, der understøtter Node.js 18 eller nyere.

Hvilke Node.js-versioner understøttes?

Node.js 18 or later. The package runs on Windows, macOS, and Linux.

Er biblioteket gratis til kommerciel brug?

Ja. Den er udgivet under MIT-licensen. Du kan bruge, ændre og videregiv den til ethvert formål, herunder kommercielle applikationer.

Hvilke 3D-formater kan jeg læse og skrive?

Pakken understøtter OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA og PLY til begge læsninger. og skrivning. Brug den udvidelsesbaserede scene.save() at eksportere til ethvert understøttet format.

Kan jeg lave en 3D-scene fra bunden?

Ja, der er bygget en… Scene uden argumenter, tilføje barneknuder til scene.rootNode, og gemme til det ønskede format.