Kaip pradėti su Aspose.3D FOSS TypeScript

@aspose/3d „TypeScript“ yra nemokamas, MIT licencijaujamas paketas įkrovimui, manipuliavimui ir 3D failų išsaugojimas Node.js - nereikia gimtoji binarinė, įdiegta nuo npm.

Žingsnis po žingsnio vadovėlis

1 žingsnis: įdiegti pakuotę

Įdiegti nuo npm (Node.js 18 arba vėliau reikalingas):

npm install @aspose/3d@24.12.0

Įsitikinkite, kad įrenginys yra teisingai įkrautas:

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

2 žingsnis: Reikalingos klasės importo

Įvesti klases, kurių jums reikia iš pakuotės:

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

3 žingsnis: įkeliate 3D failą

Naudojimas scene.open() bet kokio palaikomo formato įkrovimas. biblioteka atpažįsta formatą Automatinis iš failų plėtinės:

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

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

Naudokite statinį gamyklos metodą:

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

4 žingsnis: peržengti sceną grafikas

Sklypas yra medžio Node Objektas, įsikūręs 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);

5 žingsnis: išsaugoti į kitą formatą

Naudojimas scene.save() eksportuoti į bet kurį remiamą išleidimo formatą. biblioteka atpažįsta, kad Išleidimo formatas iš failų plėtinės:

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

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

Bendros problemos ir fiksacijos

Error: ENOENT Kai skambina scene.open() Kelias, kurį praeinate, neegzistuoja. naudokite absoliutų kelią arba path.resolve() Kad užtikrintų Failo maršrutas yra teisingas.

Nežinomas formato klaidas Įsitikinkite, kad failų plėtinė atitinka tikrąjį formatą. biblioteka atpažįsta formatus pagal Išplėstinė už open() ir fromFile().Pasidalinti aiškią formato parametrą perviršyti.

Laisva scena po įkrovimo Kai kuriems binariniams formatams gali prireikti konkrečių apkrovos variantų. pabandykite naudoti aiškią perkaitą su formatu konkrečiomis galimybėmis, jei numatyto įkrovimo metu atsiranda tuščias scenos.

Tipografijos klaidos Tipo apibrėžimai yra sujungti su paketu. užtikrinti "moduleResolution": "bundler" arba "node16" Jis įsikūręs jūsų tsconfig.json.

Dažnai užduodami klausimai

Ar @aspose/3d reikalauja bet kokių gimtojo binarinių?

Nėra. paketas yra grynas JavaScript / TypeScript su jokių gimtoji priklausomybės. Jis veikia bet kurioje platformoje, palaikančio Node.js 18 ar vėliau.

Kokios Node.js versijos yra palaikomos?

Node.js 18 arba vėliau. paketas veikia Windows, macOS ir Linux.

Ar biblioteka yra nemokama komercinio naudojimo tikslais?

Taip. Jis išleistas pagal MIT licenciją. galite jį naudoti, modifikuoti ir perparduoti bet kokiu tikslu, įskaitant komercinę programą.

Kokius 3D formatus galiu skaityti ir rašyti?

Paketas palaiko OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA ir PLY tiek skaityti ir rašyti. naudokite išplėtimo pagrindą scene.save() eksportuoti į bet kurį remiamą formatą.

Ar galiu sukurti 3D scenos iš skraidančio?

Konstrukcija A Scene be jokių argumentų, pridėkite vaiko mazgai į scene.rootNode,ir Išsaugokite pageidaujamą formą.