Wie man mit Aspose.3D FOSS für TypeScript beginnt

@aspose/3d für TypeScript ist ein kostenloses, MIT-Lizenzpaket für Laden, Manipulation und 3D-Dateien in Node.js speichern – keine native binären erforderlich, installiert von npm.

Schritt für Schritt Guide

Schritt 1: Paket installieren

Installation von npm (Node.js 18 oder später erforderlich):

npm install @aspose/3d@24.12.0

Überprüfen Sie die installierte korrekt geladen:

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

Schritt 2: Import erforderlichen Klassen

Importieren Sie die Klassen, die Sie aus dem Paket benötigen:

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

Schritt 3: Laden Sie eine 3D-Datei herunter

Gebrauch scene.open() um alle unterstützten Formate zu laden. Die Bibliothek erkennt das Format automatisch aus der Dateierweiterung:

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

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

Oder verwenden Sie die statische Fabrik:

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

Schritt 4: Überqueren Sie den Scene Graph

Eine beladenen Szene ist ein Baum von Node Objekte, die in den 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);

Schritt 3: In das Zielformat speichern

Gebrauch scene.save() für den Export in jedes unterstützte Ausgangsformat. Die Bibliothek erkennt die Ausgangsformat aus der Dateierweiterung:

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

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

Häufige Probleme und Lösungen

Error: ENOENT Wenn Sie rufen scene.open() Der Weg, den du durchlaufen hast, existiert nicht. Verwenden Sie einen absoluten Weg oder path.resolve() um sicherzustellen Der Dateiweg ist richtig.

Unbekannte Formatfehler Sicherstellen, dass die Datei-Erweiterung dem tatsächlichen Format entspricht. Die Bibliothek erkennt das Format durch Erweiterung für open() und fromFile(). Pass eine ausdrückliche Formatparameter zu überriden.

Leere Szenen nach dem Laden Einige binäre Formate können spezifische Ladungsoptionen benötigen. versuchen Sie, die explicite Überlastung zu verwenden mit Format-spezifischen Optionen, wenn die Standardlast eine leere Szenen produziert.

TippScript Import Fehler Die Artdefinitionen sind mit dem Paket verbunden. "moduleResolution": "bundler" oder "node16" ist in deinem tsconfig.json.

Häufig gestellte Fragen

Braucht @aspose/3d irgendwelche native binären?

No. Das Paket ist sauber JavaScript/TypeScript mit keine native Abhängigkeiten. Es läuft auf jeder Plattform, die Node.js 18 oder später unterstützt.

Welche Node.js-Versionen werden unterstützt?

Node.js 18 oder später. Das Paket läuft auf Windows, macOS und Linux.

Ist die Bibliothek für kommerzielle Nutzung frei?

Sie können es für jeden Zweck verwenden, modifizieren und umverteilen, einschließlich kommerzieller Anwendungen.

Welche 3D-Formate kann ich lesen und schreiben?

Das Paket unterstützt OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA und PLY für beide Lesungen. und Schreiben. verwenden Sie die Erweiterung-basiert scene.save() für den Export in alle unterstützten Formate.

Kann ich eine 3D-Szenen aus Schrauben erstellen?

Konstruktion A Scene ohne Argumente, fügen Sie Kindernoten zu scene.rootNode,und auf das gewünschte Format.