1. المنتجات
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS لـ Java

حمّل، أنشئ، حوّل، وصّدّر المشاهد ثلاثية الأبعاد من Java — مجانية ومفتوحة المصدر.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

توثيق GitHub

مكتبة Java مفتوحة المصدر لمعالجة ملفات ثلاثية الأبعاد

Aspose.3D FOSS لـ Java هي مكتبة مرخصة تحت MIT، خالصة-Java للعمل مع صيغ ملفات 3D. أضف تبعية Maven واحدة وابدأ فورًا في قراءة، إنشاء، وكتابة مشاهد 3D دون تثبيت أي بيئة تشغيل أصلية، أو SDK خارجي، أو عارض طرف ثالث.

تُظهر المكتبة واجهة برمجة تطبيقات (API) نظيفة للرسم البياني للمشهد مبنية حول Scene و Node و Mesh و Camera و Transform، وهو نفس النموذج المفاهيمي المستخدم في أدوات 3D الاحترافية. تشمل صيغ الدعم OBJ (مع تحميل مواد .mtl)، STL (ثنائي وASCII، تم التحقق من الجولة الكاملة)، glTF 2.0 (مواد PBR)، GLB (glTF ثنائي)، و FBX (استيراد فقط). تتيح خيارات التحميل والحفظ لكل صيغة التحكم في عكس الإحداثيات، المقياس، تطبيع القواعد، وتحميل المواد دون كتابة أي كود تحليل خاص بالصيغ.

Aspose.3D FOSS يتطلب Java 21 أو أحدث ويعمل بنفس الطريقة على أنظمة Windows و macOS و Linux في بيئات CI، وحاويات Docker، والبيئات الخالية من الخوادم. لا توجد امتداد أصلي للترجمة ولا حزمة نظام لتثبيتها.

دعم صيغ ثلاثية الأبعاد وواجهة برمجة تطبيقات مخطط المشهد

  • OBJ / MTL: تحميل ملفات Wavefront OBJ مع تعريفات المواد المرفقة.
  • STL: قراءة وكتابة كل من STL الثنائي وASCII مع تحقق كامل من الجولة.
  • glTF 2.0 / GLB: تحميل مواد PBR وتصديرها عبر GltfSaveOptions. استخدم setContentType(FileContentType.BINARY) لإخراج GLB.
  • FBX: دعم الاستيراد لتحميل ملفات FBX (التصدير غير متاح).
  • Scene-graph API: Scene، Node، Mesh، Camera، Transform.

أين يمكن استخدام Aspose.3D FOSS

  • خطوط أنابيب التحقق من الأصول: التحقق، وإعادة توجيه، وإعادة تصدير الأصول ثلاثية الأبعاد في بيئة التكامل المستمر.
  • أدوات تطوير الألعاب: معالجة دفعات من شبكات OBJ و STL دون الحاجة إلى محرك أصلي.
  • سير عمل الطباعة ثلاثية الأبعاد: قراءة، والتحقق، وإعادة تصدير ملفات STL.
  • Web backends: تقديم نقاط نهاية تحويل 3D في Docker أو وظائف بدون خادم.
  • Content migration: التحويل بين عائلات الصيغ على نطاق واسع.

خيارات لكل صيغة والتحكم في الإحداثيات

  • توجيه نظام الإحداثيات: عكس المحاور وضبط المقياس حسب الصيغة دون كود مخصص.
  • تطبيع المتجهات العادية: تطبيع متجهات القمم تلقائيًا عند التحميل أو الحفظ.
  • التحكم في تحميل المواد: تمكين أو تعطيل تحميل ملفات MTL/الملمس لتسريع التحليل.
  • إخراج منسق بشكل جميل: اختر تنسيق JSON لـ glTF مضغوط أو قابل للقراءة البشرية عبر الخيارات.
  • دقة الجولة الكاملة: تُحفظ عقد الرسم البياني للمشهد غير المعروفة حرفيًا عند إعادة الحفظ.

تجربة المطور

Aspose.3D FOSS لتثبيت Java باستخدام تبعية Maven واحدة (com.aspose:aspose-3d-foss:26.1.0). المكتبة هي Java صافية، بدون امتدادات أصلية للتجميع ولا حزم نظام لتثبيتها.

واجهة برمجة تطبيقات الرسم البياني للمشهد (scene-graph) تعكس النموذج المفاهيمي لأدوات 3D الاحترافية، لذا فإن منحنى التعلم قصير لأي شخص مألوف بـ Three.js أو نموذج بيانات Blender. المكتبة مرخصة بموجب MIT، مفتوحة المصدر، وترحب بتقارير الأخطاء والمساهمات على GitHub.

تحميل مشهد OBJ وتصديره كـ glTF

أضف تبعية Maven، ثم استدعِ Scene.fromFile("model.obj") لتحميل ملف OBJ مع تعريفات المواد MTL الخاصة به. استدعاء واحد scene.save() مع امتداد .gltf يكتب ملف JSON من نوع glTF 2.0، دون الحاجة إلى سجل صيغ أو كائن محول.

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

import com.aspose.threed.*;

// تحميل ملف OBJ (مع مواد .mtl)
Scene scene = Scene.fromFile("model.obj");

// تصدير كـ glTF 2.0
scene.save("model.gltf");

تحويل STL إلى glTF باستخدام GltfSaveOptions

لإنتاج ملف glTF مع تعديلات نظام الإحداثيات، مرّر كائن GltfSaveOptions مع setFlipCoordinateSystem(true). نفس النمط ينطبق على جميع خيارات كل تنسيق — استبدل فئة الخيارات بالتنسيق الذي تستهدفه.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// حفظ كـ glTF مع الخيارات
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

الأسئلة الشائعة

ما هو Aspose.3D FOSS لـ Java؟

إنها مكتبة مجانية، مرخصة بموجب MIT، خالصة-Java لتحميل، ومعالجة، وحفظ المشاهد ثلاثية الأبعاد دون تثبيت أي بيئة تشغيل أصلية أو SDK خارجي.

ما هي صيغ 3D المدعومة؟

OBJ (مع .mtl)، STL (ثنائي وASCII)، glTF 2.0، GLB (glTF ثنائي)، وFBX (استيراد فقط). كل تنسيق له فئة خيارات تحميل/حفظ مخصصة.

هل يتطلب أي تبعيات أصلية؟

لا. Aspose.3D FOSS لـ Java هو خالص Java بدون أي امتدادات أصلية. يعمل على Windows وmacOS وLinux دون أي خطوة تجميع.

كيف أقوم بتثبيته؟

أضف تبعية Maven com.aspose:aspose-3d-foss:26.1.0 إلى مشروعك. لا توجد حزم نظام إضافية أو امتدادات أصلية مطلوبة.

هل يمكنني التحكم في توجيه نظام الإحداثيات؟

نعم. تسمح فئات خيارات كل تنسيق لك بعكس المحاور، وضبط المقياس، وتطبيع المتجهات العمودية دون كتابة أي كود تحليل خاص بالتنسيق.

ما إصدارات Java المدعومة؟

Java 21 وما بعده مدعومان. المكتبة تعمل بشكل متماثل على جميع أنظمة التشغيل الرئيسية.

هل الشيفرة المصدرية متاحة؟

نعم. المكتبة مرخصة MIT ومستضافة على GitHub. تقارير الأخطاء وطلبات السحب مرحب بها.

  

الدعم وموارد التعلم

 العربية