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

Aspose.3D FOSS للـ Java

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

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

توثيق GitHub

مكتبة جافا مفتوحة المصدر لمعالجة ملفات 3D

Aspose.3D FOSS for Java هي مكتبة مكتوبة بالكامل بلغة Java مرخصة بموجب رخصة MIT للعمل مع صيغ ملفات ثلاثية الأبعاد. أضف تبعية Maven واحدة وابدأ فورًا في قراءة وإنشاء وكتابة المشاهد ثلاثية الأبعاد دون الحاجة لتثبيت أي بيئة تشغيل أصلية أو 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، والبيئات الخالية من الخوادم. لا توجد امتداد أصلي للترجمة ولا حزمة نظام لتثبيتها.

3D Format Support and Scene-Graph API

  • OBJ / MTL: Load Wavefront OBJ files with accompanying material definitions.
  • STL: Read and write both binary and ASCII STL with full roundtrip verification.
  • glTF 2.0 / GLB: PBR material loading and export via GltfSaveOptions. Use setContentType(FileContentType.BINARY) for GLB output.
  • FBX: Import support for loading FBX files (export not available).
  • Scene-graph API: Scene, Node, Mesh, Camera, Transform.

Where Aspose.3D FOSS Can Be Used

  • Asset validation pipelines: Verify, re-orient, and re-export 3D assets in CI.
  • Game development tooling: Batch-process OBJ and STL meshes without a native engine.
  • 3D printing workflows: Read, validate, and re-export STL files.
  • Web backends: Serve 3D conversion endpoints in Docker or serverless functions.
  • Content migration: Convert between format families at scale.

Per-Format Options and Coordinate Control

  • Coordinate-system orientation: Flip axes and adjust scale per format without custom code.
  • Normal normalization: Automatically normalize vertex normals on load (ObjLoadOptions.setNormalizeNormal()).
  • Material loading control: Enable or disable MTL/texture loading for faster parsing.
  • Pretty-print output: Choose compact or human-readable glTF JSON via options.

Developer Experience

Aspose.3D FOSS for Java installs with a single Maven dependency (com.aspose:aspose-3d-foss:26.1.0). The library is pure Java, with no native extensions to compile and no system packages to install.

The scene-graph API mirrors the conceptual model of professional 3D tools, so the learning curve is short for anyone familiar with Three.js or Blender’s data model. The library is MIT-licensed, open-source, and welcomes bug reports and contributions on GitHub.

Load an OBJ Scene and Export as glTF

Add the Maven dependency, then call Scene.fromFile("model.obj") to load the OBJ file together with its MTL material definitions. A single scene.save() call with a .gltf extension writes a glTF 2.0 JSON file, with no format registry or converter object needed.

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

import com.aspose.threed.*;

// Load an OBJ file (with .mtl materials)
Scene scene = Scene.fromFile("model.obj");

// Export as glTF 2.0
scene.save("model.gltf");

Convert STL to glTF with GltfSaveOptions

To produce a glTF file with coordinate-system adjustments, pass a GltfSaveOptions instance with setFlipCoordinateSystem(true). The same pattern applies to all per-format options — swap out the options class for the format you are targeting.

import com.aspose.threed.*;

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

// Save as glTF with options
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

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

What is Aspose.3D FOSS for Java?

It is a free, MIT-licensed pure-Java library for loading, manipulating, and saving 3D scenes without installing any native runtime or external SDK.

Which 3D formats are supported?

OBJ (with .mtl), STL (binary and ASCII), glTF 2.0, GLB (binary glTF), and FBX (import only). Each format has a dedicated load/save options class.

Does it require any native dependencies?

No. Aspose.3D FOSS for Java is pure Java with zero native extensions. It runs on Windows, macOS, and Linux without any compilation step.

How do I install it?

Add the Maven dependency com.aspose:aspose-3d-foss:26.1.0 to your project. No additional system packages or native extensions are required.

Can I control coordinate-system orientation?

Yes. Per-format option classes let you flip axes, adjust scale, and normalize normals without writing any format-specific parsing code.

Which Java versions are supported?

Java 21 and later are supported. The library runs identically on all major operating systems.

Is the source code available?

Yes. The library is MIT-licensed and hosted on GitHub. Bug reports and pull requests are welcome.

  

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

 العربية