Cara Memulai dengan Aspose.3D FOSS untuk TypeScript

@aspose/3d untuk TypeScript adalah paket gratis, lisensi MIT untuk muat, manipulasi, dan menyimpan file 3D di Node.js — tidak ada binari asli yang diperlukan, dapat dipasang dari npm.

Panduan Langkah-demi-Langkah

Langkah 1: Instal Paket

Instal dari npm (Node.js 18 atau lebih baru diperlukan):

npm install @aspose/3d@24.12.0

Periksa instalasi yang diisi dengan benar:

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

Langkah 2: Import Kelas yang Diperlukan

Impor kelas yang Anda butuhkan:

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

Bagaimana cara memuat file 3D?

Penggunaan scene.open() untuk mengunggah format yang didukung. perpustakaan mendeteksi format secara otomatis dari file extension:

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

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

Atau gunakan metode pabrik statik:

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

Bagaimana cara menelusuri scene graph?

Sebuah tempat yang penuh beban adalah sebuah pohon dari Node Objek yang berakar 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 Target

Penggunaan scene.save() untuk mengekspor ke format output yang didukung. perpustakaan mendeteksi Format output dari file extension:

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

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

Masalah dan Fixes Umum

Error: ENOENT Ketika memanggil scene.open() Jalan yang Anda lalui tidak ada. gunakan jalan mutlak atau path.resolve() Untuk memastikan jalur file yang benar.

Kesalahan Format yang Tidak Dikenal Pastikan file extension sesuai dengan format yang sebenarnya. perpustakaan mengidentifikasi format oleh Perpanjangan untuk open() dan fromFile().Menggunakan parameter format yang jelas untuk mengatasinya.

Tempat kosong setelah muat Beberapa format biner mungkin memerlukan opsi beban tertentu.Coba gunakan overload yang jelas dengan opsi spesifik format jika beban default menghasilkan adegan kosong.

Kesalahan Import TypeScript Definisi jenis terikat dengan paket. memastikan "moduleResolution": "bundler" atau "node16" telah ditetapkan dalam Anda tsconfig.json.

Pertanyaan yang Sering Diajukan

Apakah @aspose/3d memerlukan binari asli?

Paket ini adalah JavaScript/TypeScript murni dengan tidak ada ketergantungan asli. ia berjalan di platform mana pun yang mendukung Node.js 18 atau lebih lama.

Versi Node.js mana yang didukung?

Node.js 18 atau lebih lama. paket ini berjalan pada Windows, macOS, dan Linux.

Apakah perpustakaan ini gratis untuk penggunaan komersial?

Ya. ini dikeluarkan di bawah lisensi MIT. Anda dapat menggunakannya, mengubah dan meredistribusinya untuk tujuan apa pun, termasuk aplikasi komersial.

3D format apa yang bisa saya baca dan tulis?

Paket ini mendukung OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, dan PLY untuk kedua bacaan. dan menulis. gunakan ekspansi-base scene.save() untuk mengekspor ke format yang didukung.

Dapatkah saya membuat adegan 3D dari scratch?

Ya. membangun a Scene Dengan tidak ada alasan, tambahkan nodes anak ke scene.rootNode,dan disimpan dalam format yang diinginkan.