Hur man börjar med Aspose.3D FOSS för TypeScript
@aspose/3d för TypeScript är ett gratis, MIT-licensierat paket för laddning, manipulering och spara 3D-filer i Node.js – inga inhemska binärer krävs, kan installeras från npm.
Steg för steg guide
Steg 1: Installera paketet
Installera från npm (Node.js 18 eller senare krävs):
npm install @aspose/3d@24.12.0Kontrollera installationen laddas korrekt:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");Steg 2: Import nödvändiga klasser
Import av de klasser du behöver från paketet:
import { Scene, Node } from "@aspose/3d";Steg 3: Ladda upp en 3D-fil
Användning scene.open() ladda alla stödda format. biblioteket upptäcker formatet automatiskt från filändelsen:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);Använd statisk fabrik metod:
const scene = Scene.fromFile("model.glb");Steg 4: Överträda scenen grafen
En laddad scen är ett träd av Node föremål som är rötta 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);Steg 5: Spara till ett annat format
Användning scene.save() för export till alla stödda utgångsformat. biblioteket upptäcker Utgångsformat från filändelsen:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");Vanliga problem och fixar
Error: ENOENT När ringer scene.open() Vägen du passerade finns inte. Använd en absolut väg eller path.resolve() För att säkerställa Filvägen är korrekt.
Okänd formatfel Se till att filändelsen matchar det faktiska formatet. biblioteket upptäcker format genom förlängning för open() och fromFile().Passera en explicit format parameter för att överrida.
tom scen efter laddning Vissa binära format kan kräva specifika laddningsalternativ. försök att använda den uttryckliga överbelastningen med formatspecifika alternativ om standardbelastningen producerar en tom scen.
TypScript Importfel Typdefinitioner är bundna med paketet. säkerställ "moduleResolution": "bundler" eller "node16" är satt i din tsconfig.json.
Ofta ställda frågor
Behöver @aspose/3d någon inhemska binära?
Paketet är ren JavaScript/TypeScript med inga inhemska beroende. Det körs på någon plattform som stöder Node.js 18 eller senare.
Vilka Node.js-versioner stöds?
Node.js 18 eller senare. paketet körs på Windows, macOS och Linux.
Är biblioteket gratis för kommersiellt bruk?
Det släpps under MIT-licensen. Du kan använda, modifiera och omfördelar det för alla ändamål, inklusive kommersiella applikationer.
Vilka 3D-format kan jag läsa och skriva?
Paketet stöder OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA och PLY för både läsning. och skriva. Använd förlängningsbaserad scene.save() Exporteras till alla stödda format.
Kan jag skapa en 3D-scena från scratch?
Ja, bygg A Scene utan argument, lägg till barn noder för att scene.rootNode,och Spara i önskad format.