Bagaimana untuk memulakan dengan Aspose.3D FOSS untuk Java

Aspose.3D FOSS untuk Java adalah perpustakaan percuma, MIT-lesen untuk memuat naik, memanipulasi, dan menyimpan fail 3D - tiada binari asli diperlukan, bersih Java dari Maven Central.

Panduan Langkah-Langkah

Langkah 1: Tambah ketagihan Maven

Tambah ketergantungan berikut kepada anda pom.xml (Java 21 atau lebih baru diperlukan):

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

Semak pemasangan yang diisi dengan betul:

import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");

Langkah 2: Import Kelas yang diperlukan

Import kelas teras untuk pemecahan dan manipulasi adegan:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

Langkah 3: Muat turun fail 3D

Penggunaan Scene.fromFile() untuk memuat naik mana-mana format yang disokong. perpustakaan mengesan format secara automatik daripada fail perpanjangan:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
System.out.println("Loaded scene with root node: " + scene.getRootNode().getName());

atau gunakan yang open() Kaedah kes :

Scene scene = new Scene();
scene.open("model.glb");

Langkah 4: Melintasi Grafik Pemandangan

Sebuah tempat yang penuh beban ialah sebuah pokok Node objek yang berakar pada scene.getRootNode():

import com.aspose.threed.Node;
import com.aspose.threed.Scene;

void walk(Node node, int depth) {
    String indent = " ".repeat(depth * 2);
    System.out.println(indent + "Node: " + node.getName());
    for (Node child : node.getChildNodes()) {
        walk(child, depth + 1);
    }
}

Scene scene = Scene.fromFile("model.obj");
walk(scene.getRootNode(), 0);

Langkah 5: Simpan kepada format yang berbeza

Penggunaan Scene.save() untuk mengeksport ke mana-mana format output yang disokong. perpustakaan mendeteksi Format output daripada fail lanjutan:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Saved as GLB.");

Masalah dan Fixes yang Umum

FileNotFoundException Apabila memanggil Scene.fromFile() Jalan yang anda lalui tidak wujud atau menggunakan pemisah yang salah. gunakan laluan mutlak atau java.nio.file.Paths.get() untuk memastikan laluan fail yang betul.

Kesilapan format yang tidak diketahui memastikan fail ekstensi sepadan dengan format sebenar. perpustakaan mengesan format oleh Perpanjangan untuk open() dan fromFile().Menggunakan parameter format yang jelas untuk melebihi.

Gambar kosong selepas muat turun Sesetengah format binari mungkin memerlukan pilihan beban tertentu. cuba gunakan overload yang jelas dengan pilihan beban jika lalai menghasilkan adegan kosong.

UnsupportedOperationException untuk kaedah tertentu Sesetengah kaedah (penyambahan adegan, watermarking) tidak tersedia dalam edisi FOSS. Semak dokumen batasan sebelum menggunakan ciri-ciri canggih.

Soalan-soalan yang kerap ditanya

Adakah Aspose.3D FOSS memerlukan sebarang DLL asli?

No. Perpustakaan ini ialah Java tulen dengan tiada ketergantungan asli atau binari luaran yang diperlukan.

Apakah versi Java yang disokong?

Perpustakaan ini berfungsi pada Windows, macOS, Linux dan Docker.

Adakah perpustakaan ini boleh digunakan secara komersial?

Ya. Ia dikeluarkan di bawah lesen MIT. Anda boleh menggunakannya, mengubah suai dan membagikannya untuk apa-apa tujuan, termasuk aplikasi komersial.

3D format apa yang boleh saya baca dan tulis?

Perpustakaan ini menyokong OBJ, STL, glTF 2.0 / GLB, dan FBX untuk kedua-dua membaca dan menulis. Gunakan yang Scene.save() API berasaskan lanjutan untuk mengeksport ke mana-mana format yang disokong.

Bolehkah saya mencipta adegan 3D daripada scratch?

• Membina A Scene tanpa sebarang argumen, tambahkan nodes kanak-kanak kepada scene.getRootNode(),dan disimpan dalam format yang dikehendaki.