Hogyan kell elkezdeni az Aspose.3D FOSS a TypeScript-hez

@aspose/3d a TypeScript egy ingyenes, MIT-licencelt csomag az üzemeltetéshez, manipuláláshoz és 3D fájlok mentése a Node.js-ben - nincs szükség semmilyen anyanyelvű bináris, telepíthető npm.

Lépésről‑lépésre útmutató

1. lépés: telepítse a csomagot

Telepítés npm (Node.js 18 vagy újabb szükséges):

npm install @aspose/3d@24.12.0

Ellenőrizze a helyesen feltöltött telepítést:

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

2. lépés: A szükséges osztályok bevezetésére

Importáld a szükséges osztályokat:

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

Hogyan töltsek be egy 3D fájlt?

Használat scene.open() a támogatott formátum feltöltéséhez.A könyvtár felismeri a formátumot automatikusan a fájl kiterjesztéséből:

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

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

Vagy használja a statikus gyár módszert:

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

Hogyan járhatom be a jelenet gráfot?

A terhelés a fa, az Node A gyökerekhez kötött tárgyak 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);

3. lépés: Mentse el a célformátumba

Használat scene.save() a támogatott kimeneti formátumra exportál.A könyvtár felismerheti az A fájl kiterjesztésből származó kimeneti formátum:

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

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

Közös problémák és megoldások

Error: ENOENT Amikor hívnak scene.open() Az út, amelyet átmentél nem létezik. használjon egy abszolút utat vagy path.resolve() hogy biztosítsuk A fájl útvonal helyes.

Ismeretlen formátum hibák Biztosítsa, hogy a fájl kiterjesztése megfelel az aktuális formátumnak.A könyvtár azonosítja a formátust: kiterjesztése a open() és fromFile(). Helyezzen egy kifejezett formátum paraméter, hogy túlszárnyaljon.

üres jelenet a feltöltés után Bizonyos bináris formátumok igényelhetnek specifikus terhelési lehetőségeket. Próbáld ki a kifejezett túlterhelést formátum-specifikus opciókkal, ha a szabványos terhelés üres jelenetet eredményez.

Tipus import hibák A típus definíciók a csomaghoz kötődnek. biztosítja "moduleResolution": "bundler" vagy "node16" A te sajátodban áll tsconfig.json.

Gyakran ismételt kérdések

A @aspose/3d bármilyen hazai bináris követelményt igényel?

A csomag tiszta JavaScript/TypeScript, nem származó függőségekkel. bármilyen Node.js 18 vagy újabb támogatású platformon fut.

Milyen Node.js verziók támogathatók?

Node.js 18 vagy újabb. A csomag fut Windows, macOS és Linux rendszereken.

A könyvtár szabad a kereskedelmi célra?

Igen. A MIT Licenc alatt áll, és bármilyen célra használhatja, módosíthatja és újrafeldolgozhat, beleértve a kereskedelmi alkalmazásokat is.

Milyen 3D formátumokat olvashatok és írhatom?

A csomag támogatja az OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA és PLY mindkét olvasáshoz A kiterjesztésen alapuló használata. scene.save() bármilyen támogatott formátumra exportálható.

Lehet-e létrehozni egy 3D jelenetet a scratchból?

A. építkezés a Scene Nincs ok, a gyermekek csomópontjait hozzáadjuk scene.rootNode,és a kívánt formátumban.