Come iniziare con Aspose.3D FOSS per TypeScript

@aspose/3d per TypeScript è un pacchetto gratuito, con licenza MIT per il caricamento, la manipolazione e salvare i file 3D in Node.js - nessuna binaria nativa richiesto, installabile da npm.

Guida passo passo

Passo 1: Installa il pacchetto

Installare da npm (Node.js 18 o successivo richiesto):

npm install @aspose/3d@24.12.0

Verificare l’installazione caricata correttamente:

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

Passo 2: Importazioni di classi richieste

Importa le classi di cui hai bisogno:

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

Passo 3: Caricare un file 3D

Utilizzo scene.open() per caricare qualsiasi formato supportato. la biblioteca rileva il formato automaticamente dalla estensione del file:

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

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

Utilizzare il metodo statico di fabbrica:

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

Passo 4: attraversare il grafico della scena

Una scena caricata è un albero di Node oggetti radicati in 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);

Passo 3: Salva nel formato di destinazione

Utilizzo scene.save() per esportare in qualsiasi formato di uscita supportato. la biblioteca rileva il Il formato di uscita dalla estensione del file:

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

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

Problemi e fissazioni comuni

Error: ENOENT Quando chiamare scene.open() Il percorso che hai attraversato non esiste. usare un percorso assoluto o path.resolve() per garantire Il percorso del file è corretto.

errore di formato sconosciuto Assicurarsi che l’estensione del file corrisponda al formato reale. la biblioteca rileva il formato da estensione per open() e fromFile().Passare un parametro esplicito di formato per superare.

Scena vuota dopo il carico Alcuni formati binari potrebbero richiedere opzioni di carico specifiche. provare a utilizzare il sovraccarico esplicito con opzioni specifiche per il formato se la carica predefinita produce una scena vuota.

errori di importare TypeScript Le definizioni di tipo sono collegate al pacchetto. assicura "moduleResolution": "bundler" o "node16" è stato messo nel tuo tsconfig.json.

Domande frequenti

@aspose/3d richiede qualsiasi binario nativo?

No. Il pacchetto è puro JavaScript/TypeScript senza dipendenze native. esce su qualsiasi piattaforma che supporta Node.js 18 o più tardi.

Quali versioni di Node.js sono supportate?

Node.js 18 o più tardi Il pacchetto funziona su Windows, macOS e Linux.

La biblioteca è gratuita per uso commerciale?

È rilasciato sotto la licenza MIT. Puoi utilizzarla, modificarla e redistribuirla per qualsiasi scopo, comprese le applicazioni commerciali.

Quali formati 3D posso leggere e scrivere?

Il pacchetto supporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA e PLY per entrambi i lettori. e scrivere. usare l’estensione basata scene.save() per l’esportazione in qualsiasi formato supportato.

Posso creare una scena 3D da scratch?

Sì, costruire una Scene senza argomenti, aggiungere i nodi per bambini a scene.rootNode,e salvo nel formato desiderato.