Com començar amb Aspose.3D FOSS per a TypeScript
@aspose/3d per a TypeScript és un paquet gratuït, amb llicència MIT per carregar, manipular i -Save 3D files in Node.js — no requereixen binaris nadius, instal·lables des de l’npm.
Guia de pas a pas
Pas 1: Instal·la el paquet
Instal·lació des de npm (Node.js 18 o posterior requerit):
npm install @aspose/3d@24.12.0Verifica la instal·lació carregada correctament:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");Pas 2: Import de les classes necessàries
Importar les classes que necessites del paquet:
import { Scene, Node } from "@aspose/3d";Pas 3: Carregar un fitxer 3D
Utilitzar scene.open() per carregar qualsevol format recolzat. la biblioteca detecta el format automàticament de l’extenssió del fitxer:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);Utilitza el mètode d’estació:
const scene = Scene.fromFile("model.glb");Pas 4: Travessar el gràfic de l’escena
Una escena carregada és un arbre de Node Els objectes que es corren a 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);Pas 5: Salvar a un format diferent
Utilitzar scene.save() per exportar a qualsevol format de sortida suportat. la biblioteca detecta el Format de sortida de l’extenssió del fitxer:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");Problemes comuns i fixos
Error: ENOENT Quan crida scene.open() El camí que has passat no existeix. utilitzar un camí absolut o path.resolve() Per assegurar-se El camí de fitxer és correcte.
Error de format desconegut Assegureu-vos que l’extenssió de fitxer coincideix amb el format real. La biblioteca detecta el format per Extensions per open() i fromFile().Passar un paràmetre de format explícit per sobreridejar.
Escena buit després de la càrrega Alguns formats binaris poden requerir opcions de càrrega específiques. tractar utilitzant la sobrecarga explícita amb opcions específiques de format si la càrrega estàndard produeix una escena buida.
Tipus d’error importador Les definicions de tipus estan vinculades amb el paquet. assegura "moduleResolution": "bundler" o "node16" Està establert en el teu tsconfig.json.
Preguntes freqüents
@aspose/3d requereix qualsevol binari natiu?
No. El paquet és pur JavaScript/TypeScript amb cap dependència nativa. es fa en qualsevol plataforma que suporti Node.js 18 o més tard.
Quines versions de Node.js estan supportades?
Node.js 18 o més tard. El paquet s’executa en Windows, macOS i Linux.
La biblioteca és lliure per a ús comercial?
Sí. Es publica sota la Llicència MIT. Pot utilitzar, modificar i redistribuir-la per a qualsevol propòsit, incloses les aplicacions comercials.
Quins formats 3D puc llegir i escriure?
El paquet suporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i PLY per a la lectura de tots dos. i escriure. utilitzar l’extensions basades en scene.save() Exportar a qualsevol format suportat.
Puc crear una escena 3D de la fusta?
Són: Construïm un Scene sense cap argument, afegir nodes infantils a scene.rootNode,i Es pot guardar al format desitjat.