Cara untuk mula menggunakan Aspose.3D FOSS untuk TypeScript

Cara untuk mula menggunakan Aspose.3D FOSS untuk TypeScript

@aspose/3d for TypeScript ialah paket percuma yang dilesenkan oleh MIT untuk muat turun, memanipulasi dan menyimpan fail 3D dalam Node.js — tiada binari asli diperlukan, boleh dipasang dari npm.

Panduan Langkah demi Langkah

Langkah 1: Pasang Pakej

Pastikan anda memasang Node.js 18 atau lebih baru:

npm install @aspose/3d@24.12.0

Pastikan instalasi telah diisi dengan betul:

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

Langkah 2: Import Kelas yang diperlukan

Import kelas yang anda perlukan:

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

Langkah 3: Muat naik fail 3D

digunakan scene.open() untuk muat naik sebarang format yang disokong. Perpustakaan mendeteksi format secara automatik daripada ekstensi fail:

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

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

Atau gunakan kilang statik:

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

Bagaimana saya menelusuri graf adegan?

Sebuah tempat yang tertutup ialah sebuah pokok Node Objek yang dihasilkan pada 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);

Langkah 3: Simpan ke Format Sasaran

digunakan scene.save() untuk mengeksport ke mana-mana format output yang disokong. Perpustakaan mendeteksi Format output daripada ekstensi fail:

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

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

Isu Umum dan Penyelesaian

Error: ENOENT Apabila memanggil scene.open() Jalan yang anda lalui tidak wujud. gunakan jalan mutlak atau path.resolve() untuk memastikan Jalan fail yang betul.

Kesilapan format yang tidak diketahui Pastikan ekstensi fail sepadan dengan format sebenar. pustaka mendeteksi format oleh Perpanjangan untuk open() dan fromFile().Menghantar parameter format eksplisit untuk dialih keluar.

Skenario kosong selepas muat turun Sesetengah format binari mungkin memerlukan pilihan muat tertentu. cuba menggunakan overload eksplisit dengan opsyen format tertentu jika muat lalai menghasilkan adegan kosong.

Kesilapan import TypeScript Definisi jenis dikemas dengan paket. memastikan "moduleResolution": "bundler" atau "node16" telah ditetapkan dalam anda tsconfig.json.

Soalan Lazim

Adakah @aspose/3d memerlukan sebarang binari asli?

Tidak. Paket ini adalah JavaScript murni / TypeScript tanpa ketergantungan asli. Ia berjalan pada mana-mana platform yang menyokong Node.js 18 atau lebih baru.

Versi Node.js apa yang disokong?

Node.js 18 or later. The package runs on Windows, macOS, and Linux.

Adakah perpustakaan ini percuma untuk kegunaan komersial?

Ia dikeluarkan di bawah lesen MIT. anda boleh menggunakan, mengubah dan mendistribusikannya untuk apa-apa tujuan, termasuk aplikasi komersial.

Format 3D apa yang boleh saya baca dan tulis?

Paket ini menyokong OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA dan PLY untuk kedua-dua membaca dan menulis. gunakan ekstensi berdasarkan scene.save() untuk mengeksport ke mana-mana format yang disokong.

Bolehkah saya mencipta adegan 3D daripada awal?

a. membina sebuah Scene tanpa argumen, tambahkan anak nodes kepada scene.rootNode,dan Simpan kepada format yang diingini.

juga

 Bahasa Melayu