Cum să începi cu Aspose.3D FOSS pentru TypeScript

@aspose/3d pentru TypeScript este un pachet gratuit, licențiat de MIT pentru încărcare, manipulare și salvare 3D fișiere în Node.js — nu sunt necesare binare native, instalabile de la npm.

Ghid pas cu pas

Pasul 1: Instalați pachetul

Instalarea de la npm (Node.js 18 sau mai târziu necesar):

npm install @aspose/3d@24.12.0

Verificați instalarea încărcată corect:

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

Pasul 2: Importarea claselor necesare

Importă clasele de care ai nevoie:

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

Pasul 3: Încărcați un fișier 3D

Utilizarea scene.open() pentru a încărca orice format susținut. bibliotecă detectează formatul automat din extinderea fișierului:

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

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

Folosește metoda statică de fabricație:

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

Pasul 4: Întoarceți graficul de scenă

Un scenă încărcată este un copac de Node Obiectele înrădăcinate de 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);

Pasul 3: Salvează în formatul țintă

Utilizarea scene.save() pentru a exporta la orice format de ieșire susținut. biblioteca detectează Formatul de ieșire din extinderea fișierului:

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

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

Probleme comune și soluții

Error: ENOENT Când sună scene.open() Calea pe care o ai trecută nu există. foloseste un drum absolut sau path.resolve() Pentru a asigura Calea de fișier este corectă.

Erori de format necunoscute Asigurați-vă că extinderea fișierului se potrivește cu formatul real. biblioteca detectează format prin extinderea pentru open() şi fromFile().• Pass un parametru explicit de format pentru a supraîncărca.

Scena goală după încărcare Unele formate binare pot necesita opțiuni specifice de încărcare. încercați să utilizați o supraîncărcătură explicită cu opțiuni specifice formatului dacă încărcătura predefinită produce o scenă goală.

Erori de tipare import Definițiile de tip sunt legate cu pachetul. asigură "moduleResolution": "bundler" sau "node16" Se pune în tine tsconfig.json.

Întrebări frecvente

@aspose/3d necesită binare native?

Nu. pachetul este pur JavaScript/TypeScript cu dependențe native. funcționează pe orice platformă care susține Node.js 18 sau mai târziu.

Ce versiuni Node.js sunt susținute?

Node.js 18 sau mai târziu. pachetul funcționează pe Windows, macOS și Linux.

Este biblioteca liberă pentru utilizare comercială?

Este eliberat în temeiul licenței MIT. Puteți să-l utilizați, să modificați și să o redistribuiți pentru orice scop, inclusiv aplicații comerciale.

Ce formate 3D pot citi și scrie?

Pachetul suportă OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA și PLY pentru ambele lecturi. - folosirea extinderii. utilizarea extinctiei pe baza scene.save() pentru a exporta în orice format susținut.

Pot crea o scenă 3D din scratch?

Construcţia a Scene fără argumente, adăugați noduri pentru copii la scene.rootNode, şi salvare în formatul dorit.