Mula

Memulakan dengan Aspose.3D FOSS untuk Java

Selamat datang ke aspose-3d-foss, sebuah perpustakaan Java percuma, sumber terbuka untuk memuatkan, membina, dan mengeksport adegan 3D. Panduan ini membawa anda dari projek baru ke adegan yang berfungsi dalam beberapa minit.


Prasyarat

KeperluanButiran
JavaJDK 21 atau lebih baru
Alat binaMaven atau Gradle
OSWindows, macOS, atau Linux

Pemasangan

Tambah kebergantungan Maven ke dalam pom.xml anda:

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

Sahkan:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Lihat Panduan Pemasangan untuk penyediaan Gradle dan langkah‑langkah pengesahan.


Apa Yang Anda Boleh Lakukan

Setelah dipasang, anda boleh segera:

  • Muat OBJ, STL, glTF 2.0 / GLB, dan fail FBX melalui scene.open()
  • Periksa hierarki adegan: menelusuri pokok Node, membaca geometri Mesh, akses normal verteks dan UV
  • Ubah nod: tetapkan translasi, putaran, dan skala melalui kelas Transform
  • Terapkan bahan: tetapkan Material atau PbrMaterial kepada nod
  • Eksport ke mana-mana format yang disokong dengan scene.save()
  • Bina geometri: cipta objek Mesh secara programatik dengan titik kawalan dan poligon

Mula Cepat

Muat fail 3D, cetak hierarki adegan, dan simpan semula dalam format GLB:

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

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Langkah Seterusnya

 Bahasa Melayu