Kako započeti s Aspose.3D FOSS za TypeScript

@aspose/3d za TypeScript je besplatan, MIT-licentirani paket za punjenje, manipulaciju i spašavanje 3D datoteke u Node.js – nema native binarije potrebne, instaliran od npm.

Kratak korak vodič

Korak 1: Instalirajte paket

Instaliranje od npm (Node.js 18 ili kasnije zahtijeva):

npm install @aspose/3d@24.12.0

Provjerite instaliranje ispravno:

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

2. korak: Uvoz potrebnih razreda

Uvoz razreda koje trebate iz paketa:

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

Korak 3: Preuzmite 3D datoteku

korištenje scene.open() za preuzimanje bilo kojeg podržanog formata. knjižnica otkriva format automatski iz proširenja datoteke:

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

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

Ili koristite statsku metodu tvornice:

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

Korak 4: Pređite kroz grafikon scene

Uspješna scena je drvo od Node Objekt koji je usmjeren na 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);

Korak 5: Sačuvajte u različitim formatima

korištenje scene.save() u bilo kojem formatu podupiranog izlaska. knjižnica otkriva Izlazni format iz proširenja datoteke:

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

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

Zajednički problemi i korekcije

Error: ENOENT Kada se poziva scene.open() Puta koju ste prošli ne postoji. koristite apsolutni put ili path.resolve() kako bi se osiguralo Puta za dosje je ispravna.

Nepoznata pogreška u formatu U svakom slučaju, neka se dosje prilagođava stvarnom formatu.Knjižnica otkriva format po Proširenje za open() i fromFile().Preuzmite izričito parametar formata za prevrati.

Prolazna scena nakon punjenja Neki binarni formati mogu zahtijevati određene opcije tereta. pokušajte koristiti izričito preopterećenje sa opcijama specifičnim za format ako privremeni teret proizvodi praznu scenu.

Tipografske pogreške uvoza Definicije tipa povezane su s paketom. osigurati "moduleResolution": "bundler" ili "node16" Uvršten je u tvoju tsconfig.json.

Često postavljana pitanja

@aspose/3d zahtijeva bilo koji native binarije?

Paketi su čisti JavaScript/TypeScript bez domoljubnih ovisnosti. radi se na bilo kojoj platformi koja podržava Node.js 18 ili kasnije.

Koje su verzije Node.js podržane?

Node.js 18 ili kasnije. paket se radi na Windows, macOS i Linuxu.

Je li knjižnica slobodna za komercijalnu upotrebu?

Da, izdan je pod MIT licencom. možete ga koristiti, izmijeniti i redistribuirati za bilo koji svrhu, uključujući komercijalne aplikacije.

Koje 3D formate mogu čitati i pisati?

Paketi podržavaju OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i PLY za oba čitanja. i pisanje. koristite proširenje-na temelju scene.save() Izvoz u bilo koji podržani format.

Mogu li napraviti 3D scenu iz skraćenja?

I. Izgradnja A Scene bez argumenata, dodajte dječje čvorove na scene.rootNode,i Uključite u željeni format.