البدء

البدء مع Aspose.3D FOSS لـ Java

مرحبًا بك في aspose-3d-foss,، مكتبة مجانية ومفتوحة المصدر Java لتحميل وبناء وتصدير المشاهد ثلاثية الأبعاد. يوضح هذا الدليل كيفية الانتقال من مشروع جديد إلى مشهد يعمل في دقائق.


المتطلبات المسبقة

المتطلباتالتفاصيل
JavaJDK 21 أو أحدث
أداة البناءMaven أو Gradle
OSWindows أو macOS أو Linux

التثبيت

أضف تبعية Maven إلى pom.xml:

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

تحقق:

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.");
    }
}

انظر إلى دليل التثبيت لإعداد Gradle وخطوات التحقق.


ما يمكنك القيام به

بعد التثبيت يمكنك فورًا:

  • حمّل ملفات OBJ، STL، glTF 2.0 / GLB، و FBX عبر scene.open()
  • فحص تسلسلات المشهد: استعرض Node الأشجار، اقرأ Mesh الهندسة، الوصول إلى متجهات القمم العادية و UVs
  • تحويل العقد: ضبط الإزاحة، الدوران، والقياس عبر Transform فئة
  • تطبيق المواد: تعيين Material أو PbrMaterial إلى العقد
  • تصدير إلى أي تنسيق مدعوم باستخدام scene.save()
  • بناء الهندسة: إنشاء Mesh كائنات برمجياً باستخدام نقاط التحكم والمضلعات

البدء السريع

حمّل ملفًا ثلاثي الأبعاد، اطبع تسلسل المشهد، وأعد حفظه بتنسيق 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");
    }
}

الخطوات التالية

 العربية