Cara Memulai dengan Aspose.3D FOSS untuk Java

Aspose.3D FOSS untuk Java adalah perpustakaan gratis, lisensi MIT untuk muat naik, memanipulasi, dan menyimpan file 3D - tidak ada binari asli yang diperlukan, Java murni dari Maven Central.

Panduan Langkah-Langkah

Langkah 1: Tambah ketergantungan Maven

Tambahkan ketergantungan berikut ke 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>

Periksa instalasi yang diisi dengan benar:

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

Langkah 2: Import Kelas yang Diperlukan

Import kelas inti untuk pemecahan dan manipulasi adegan:

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

Langkah 3: Mengisi file 3D

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

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() Metode yang berlaku :

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

Langkah 4: Melintasi Grafik Pemandangan

Sebuah tempat yang penuh beban adalah sebuah pohon dari 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 ke format yang berbeda

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

import com.aspose.threed.Scene;

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

Masalah dan Fixes Umum

FileNotFoundException Ketika memanggil Scene.fromFile() Jalan yang Anda lalui tidak ada atau menggunakan pemisah yang salah. gunakan jalan mutlak atau java.nio.file.Paths.get() 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 beban jika default menghasilkan adegan kosong.

UnsupportedOperationException Untuk beberapa metode Beberapa metode (penyataan adegan, watermarking) tidak tersedia dalam edisi FOSS. Periksa dokumentasi pembatasan sebelum menggunakan fitur lanjutan.

Pertanyaan yang sering ditanya

Apakah Aspose.3D FOSS memerlukan DLL asli?

No. Perpustakaan adalah Java murni dengan tidak ada ketergantungan asli atau binari eksternal yang diperlukan.

Versi Java apa yang disokong?

Perpustakaan berjalan pada Windows, macOS, Linux dan Docker.

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?

Perpustakaan ini mendukung OBJ, STL, glTF 2.0 / GLB, dan FBX untuk membaca dan menulis. Gunakan The Scene.save() API berbasis extension 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.getRootNode(),dan disimpan dalam format yang diinginkan.