Java için Aspose.3D FOSS ile Nasıl Başlarsınız

Aspose.3D FOSS for Java, Maven Central’dan gelen yerli binary gerektirmeyen ücretsiz, MIT lisanslı bir 3D dosyaları yüklemek, manipüle etmek ve kurtarmak için bir kütüphane.

Adım-Adım Rehberi

Adım 1: Maven Bağımlılığı Ekleyin

Aşağıdaki bağımlılığı sizin için ekleyin. pom.xml (Java 21 veya sonraki gereklidir):

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

Doğru yüklü yüklemeyi kontrol edin:

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

Adım 2: İthalat Gerekli Sınıflar

Sahne yükleme ve manipülasyon için çekirdek sınıfları ithal etmek:

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

Adım 3: 3D dosyayı yükleme

Kullanım Scene.fromFile() Desteklenen herhangi bir biçim yüklemek için. kütüphane biçimi tespit eder Dosya uzantısından otomatik olarak:

import com.aspose.threed.Scene;

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

ya da kullanın open() Örnek Yöntem:

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

Adım 4: Sahne grafiklerini geçin

Bir sahne bir ağaçtır, bir Node ırkçı olan nesneler 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);

5. Adım: Farklı bir formatta kaydetmek

Kullanım Scene.save() Herhangi bir destekleyici çıkış biçimine ihraç etmek için. kütüphane, Dosya uzantısından çıkış biçimi:

import com.aspose.threed.Scene;

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

Toplam Sorunlar ve Çözümler

FileNotFoundException çağrıldığında Scene.fromFile() Geçtiğiniz yol yok ya da yanlış ayrıştırıcı kullanır. java.nio.file.Paths.get() Dosya yolunun doğru olduğundan emin olmak.

Bilinmeyen format hatası Dosya uzantısı gerçek formatla eşleşir. kütüphane biçimi tespit eder Uzantısı için open() ve fromFile().* Bir parametreyi aşmak için açık bir biçim belirleyin.

Yükleme sonrası boş sahne Bazı ikili biçimler belirli yük seçenekleri gerekebilir. açık bir aşırı yükleme kullanmaya çalışın yükleme seçenekleri ile varsayılan bir boş sahne üretir.

UnsupportedOperationException Belirli yöntemler için Bazı yöntemler (scen rendering, su işaretleme) FOSS sürümünde mevcut değildir. Gelişmiş özellikleri kullanmadan önce sınırlama belgelerini kontrol edin.

Sıkça Sorulan Sorular

Aspose.3D FOSS herhangi bir yerli DLL’ye ihtiyaç duyuyor mu?

Kütüphane saf Java’dır ve hiçbir yerli bağımlılık veya dış binary gerektirmez.

Java versiyonları hangi yöntemlere uygulanır?

Kütüphane Windows, macOS, Linux ve Docker konteynerlerinde çalışır.

Kütüphane ticari kullanım için ücretsiz mi?

Evet. MIT Lisansı altında yayınlanmaktadır. ticari uygulamalar da dahil olmak üzere herhangi bir amaç için kullanabilir, değiştirebilir ve yeniden dağıtabilirsiniz.

Hangi 3D formatı okuyabilir ve yazabilirim?

Kütüphane hem okuma hem de yazma için OBJ, STL, glTF 2.0 / GLB ve FBX’i destekler. Kullanmak için Scene.save() Uzantı tabanlı API’ler, desteklenen herhangi bir biçime ihraç edilebilir.

3D sahneyi çarpışmadan yapabilir miyim?

Evet. yapılandırma a Scene Hiçbir sebeple, çocuk düğümlerini ekleyin. scene.getRootNode(),ve İstediğiniz formatta kaydedilir.