مرجع API لـ aspose-3d-foss 26.1.0 (Java 21+, رخصة MIT).
جميع الفئات موجودة في com.aspose.threed الحزمة الجذرية. الاستيراد الجذري هو:
هيكل الحزمة: تقريبًا جميع الفئات العامة موجودة في com.aspose.threed. الحزمة الفرعية الوحيدة التي تُستخدم عادةً هي com.aspose.threed.shading (ل PbrMaterial). الـ com.aspose.threed.formats الحزمة الفرعية تحتوي على مستوردين/مصدرين داخليين ولا يتم استيرادها عادةً مباشرةً.
اتفاقية تسمية Java: جميع الخصائص تستخدم أساليب getter/setter. على سبيل المثال، استخدم node.getTransform() بدلاً من node.transform, و transform.setTranslation(...) بدلاً من transform.translation = .... لاحظ أن Vector3, Vector4, Quaternion, Matrix4, و FVector الأنواع تستخدم الحقول العامة (v.x, v.y, v.z) بدلاً من getters للوصول إلى المكوّن.
الرسم البياني الأساسي للمشهد
| Enumerations | Enumerations |
|---|
Scene | حاوية المستوى الأعلى لجميع بيانات المشهد ثلاثي الأبعاد. تحتفظ بالعقدة الجذرية، وبيانات تعريف الأصول، ومقاطع الرسوم المتحركة. تكشف fromFile(), open(),، و save() كنقاط الدخول الأساسية للإدخال/الإخراج. |
Node | عقدة مسماة في تسلسل المشهد الهرمي. تمتلك قائمة من العقد الفرعية وقائمة من المرفقات Entity كائنات مثل meshes، والكاميرات، والأضواء. تحمل محلية Transform. |
Entity | فئة أساسية مجردة لجميع الكائنات التي يمكن إرفاقها بـ Node. توفر اسم وهوية ولكن لا تحتوي على هندسة خاصة بها. |
SceneObject | فئة أساسية مشتركة بين Node و Entity. يوفر واجهة تجميع الخصائص المستخدمة للبيانات الوصفية المعرفة من قبل المستخدم. |
A3DObject | الفئة الأساسية الجذرية لجميع Aspose.3D المدارة. تكشف عن خاصية الاسم و Properties المجموعة. |
INamedObject | واجهة تضمن getName() طريقة. تم تنفيذها بواسطة Node, Entity,، وعدة أنواع موصّفات خاصة بالتنسيق. |
الهندسة والشبكة
| Enumerations | Enumerations |
|---|
Mesh | كيان شبكة مضلع. يخزن نقاط التحكم (مواقع الرؤوس ك Vector4)، قوائم أوجه المضلع (قوائم مؤشرات نقاط التحكم)، وطبقات عناصر الرؤوس (العموميات، UVs، ألوان الرؤوس). |
Geometry | قاعدة تجريدية لأنواع الهندسة الشبيهة بالشبكة. تعرف مصفوفة نقاط التحكم ومجموعة VertexElement الطبقات. Mesh يرث من Geometry. |
VertexElement | قاعدة تجريدية لطبقة بيانات مرفقة بالهندسة (السطوح، إحداثيات UV، الألوان، إلخ). تحمل getMappingMode(), getReferenceMode(),، وقائمة بيانات. |
VertexElementNormal | يخزن متجه عادي واحد لكل رأس أو لكل زاوية مضلع، حسب وضعية التعيين. قيم البيانات هي Vector4 نماذج مع w غير مستخدمة. |
VertexElementUV | يخزن أزواج إحداثيات النسيج (Vector2) لكل رأس أو لكل زاوية مضلع. قد يحمل الشبكة عدة طبقات UV لقنوات نسيج مختلفة. |
VertexElementVertexColor | يخزن بيانات لون RGBA لكل رأس أو لكل زاوية كـ Vector4 (r، g، b، a في النطاق 0–1). |
VertexElementType | تعداد يحدد الدور الدلالي لطبقة عنصر القمة: NORMAL, UV, VERTEX_COLOR, وغيرها. مرّر القيم إلى Mesh.getElement(). |
MappingMode | تعداد يتحكم في أي بدائية يتم ربط قيمة عنصر القمة بها: CONTROL_POINT, POLYGON_VERTEX, أو POLYGON. |
ReferenceMode | تعداد يتحكم في طريقة فهرسة القيم: DIRECT (قيمة واحدة لكل بدائية ربط) أو INDEX_TO_DIRECT (مصفوفة القيم بالإضافة إلى مصفوفة مؤشرات منفصلة). |
التحويل والفضائي
| Enumerations | Enumerations |
|---|
Transform | تحويل محلي مرفق بـ Node. يوفر إزاحة، دوران (كـ Quaternion), ومكوّنات مقياس، بالإضافة إلى طرق مساعدة لزوايا أويلر. |
GlobalTransform | عرض للقراءة فقط لتحويل الفضاء العالمي للعقدة بعد تجميع جميع تحويلات الأسلاف. يتم الوصول إليه عبر node.getGlobalTransform(). |
AssetInfo | كتلة بيانات التعريف المرفقة بـ Scene. يخزن اسم تطبيق الإنشاء، اسم الوحدة، معامل مقياس الوحدة، تعريفات محاور نظام الإحداثيات، وطوابع زمنية للإنشاء/التعديل. |
المواد والتظليل
| Enumerations | Enumerations |
|---|
Material | فئة أساسية مجردة لجميع أنواع المواد. توفر اسمًا ومجموعة خصائص للمعلمات الرقمية واللون. |
PbrMaterial | مادة تجسيد معتمدة على الفيزياء. تخزن albedo، معامل المعدن، معامل الخشونة، اللون المنبعث، الشفافية، والملمس المرتبط. تُستخدم بواسطة glTF 2.0 وغيرها من الصيغ الداعمة لـ PBR. الاستيراد: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | كيان الكاميرا. يرث من Entity. لا يتم كشف أي خصائص خاصة بالصيغ في نسخة Java FOSS بخلاف الاسم الموروث ومجموعة الخصائص. مرفق بـ Node لتحديد تحويلات نقطة المشهد. |
ملاحظة: Enumerations Light الفئة غير متوفرة في نسخة Java من Aspose.3D FOSS. يتم تخزين بيانات إضاءة المشهد من الملفات المستوردة كـ generic Entity الكائنات.
أدوات الرياضيات
| Enumerations | Enumerations |
|---|
Vector2 | متجه ذو دقة مزدوجة مكوّن من عنصرين (x, y). يُستخدم لإحداثيات القوام UV. |
Vector3 | متجه ذو دقة مزدوجة مكوّن من ثلاثة عناصر (x, y, z). يُستخدم للمواقع، الاتجاهات، والقياس. |
Vector4 | متجه ذو دقة مزدوجة مكوّن من أربعة عناصر (x, y, z, w). يُستخدم لنقاط التحكم (المواقع المتجانسة) وبيانات العادية. |
FVector3 | متجه عائم بدقة مفردة مكوّن من ثلاثة عناصر. يظهر في مصفوفات بيانات عناصر القمم للمتجهات العادية والماسية. |
FVector4 | متجه عائم بدقة مفردة مكوّن من أربعة عناصر. نوع التخزين لـ VertexElementFVector البيانات. |
Quaternion | كواتيرنيون وحدة لتمثيل الدورانات (w, x, y, z). يُستخدم بواسطة Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | صندوق احتواء محاذٍ للمحاور يُعرّف بـ getMinimum() و getMaximum() Vector3 زوايا. يُستخدم لاستعلامات الفضاء ومساعدي frustum culling. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | حاوية مسماة لنطاق الرسوم المتحركة. A Scene قد تحتوي على مقاطع متعددة (مثل “Walk”, “Run”). قالب إعلان — بيانات الإطارات المفتاحية والتشغيل لم تُنفّذ بعد. |
إدخال وإخراج الصيغ
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | طريقة ثابتة. يفتح الملف في path,، يكتشف الصيغة من الامتداد، ويعيد كائنًا مُعبأً Scene. يطرح استثناء عند عدم العثور على الملف أو صيغة غير مدعومة. |
Scene.open(path, options) | طريقة كائن. يفتح ملفًا في كائن موجود Scene كائن، اختياريًا باستخدام format-specific LoadOptions فئة فرعية. |
Scene.save(path, options) | طريقة كائن. تسلسل المشهد إلى path باستخدام الصيغة المستنتجة من الامتداد، مع إمكانية استخدام format-specific SaveOptions فئة فرعية. |
FileFormat | سجل صيغ الملفات المدعومة. يحتوي على مدخلات مثل FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | تجريد I/O داخلي يُستخدم من قبل مستوردي ومصدري الصيغ. عادةً لا يُستَخدم مباشرةً من قبل شفرة التطبيق. |
LoadOptions | الفئة الأساسية لجميع كائنات خيارات التحميل الخاصة بالصيغة. يتم توريثها من قبل ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | الفئة الأساسية لجميع كائنات خيارات الحفظ الخاصة بالصيغة. يتم توريثها من قبل ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
صيغة OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | فئة المستورد الداخلية التي تقوم بتحليل ملفات Wavefront OBJ و MTL. تُستدعى تلقائيًا بواسطة Scene.fromFile() لـ .obj الامتدادات. |
ObjLoadOptions | خيارات التحميل لملفات Wavefront OBJ. الخصائص الرئيسية: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | خيارات الحفظ لإخراج Wavefront OBJ. تتحكم في normals، UVs، مراجع المواد، ووضع point‑cloud mode. |
ObjFormat | وصف الصيغة لـ Wavefront OBJ. يمكن الوصول إليه كـ FileFormat.WAVEFRONT_OBJ(). |
صيغة STL
| Enumerations | Enumerations |
|---|
StlImporter | المستورد الداخلي الذي يقرأ ملفات STL الثنائية و ASCII. يتم اختياره تلقائيًا حسب الامتداد. |
StlExporter | مُصدِّر داخلي يكتب ملفات STL. |
StlLoadOptions | خيارات التحميل لملفات STL. يدعم setFlipCoordinateSystem(), setRecalculateNormal(),، و setContentType(). |
StlSaveOptions | خيارات الحفظ لإخراج STL. يتحكم setFlipCoordinateSystem(), setAxisSystem(),، و setContentType(). |
StlFormat | وصف التنسيق لـ STL. |
صيغة glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | خيارات التحميل لملفات glTF 2.0 و GLB. الخصائص الرئيسية: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | خيارات الحفظ لإخراج glTF 2.0 و GLB. استخدم setContentType(FileContentType.BINARY) لإنتاج حزمة مستقلة .glb حزمة. |
GltfFormat | وصف تنسيق لـ glTF 2.0 / GLB. يمكن الوصول إليه كـ FileFormat.GLTF2(). |
تنسيق FBX
يتم دعم FBX لـ استيراد فقط. تصدير إلى FBX غير متوفر في نسخة Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | خيارات التحميل لملفات FBX. الخاصية الرئيسية: setFlipCoordinateSystem(). |
FbxFormat | وصف تنسيق لـ FBX. يمكن الوصول إليه كـ FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | يحدد محور إحداثي: X_AXIS, Y_AXIS, Z_AXIS. يُستخدم في خيارات إعادة تعيين نظام الإحداثيات. |
CoordinateSystem | يحدد اتفاقية اليد: RIGHT_HANDED أو LEFT_HANDED. |
TextureMapping | يحدد كيفية ربط النسيج بالهندسة: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, إلخ. |
BooleanOperation | نوع عملية بوليانية CSG: UNION, DIFFERENCE, INTERSECTION. |
نظام الخصائص
| Enumerations | Enumerations |
|---|
Property | خاصية واحدة مسماة ومُعرفة النوع على A3DObject. يخزن اسم الخاصية، ووصف النوع، والقيمة الحالية. |
PropertyCollection | مجموعة قابلة للتكرار من Property كائنات مرفقة بـ A3DObject. يدعم البحث بالاسم والتكرار على جميع الخصائص المعرفة. |
CustomObject | خفيفة الوزن A3DObject فئة فرعية تحمل فقط اسمًا وـ PropertyCollection. يُستخدم لتخزين البيانات الوصفية المعرفة من قبل المستخدم على كائنات المشهد. |
الصورة والتصيير
| Enumerations | Enumerations |
|---|
ImageRenderOptions | خيارات software rasterisation عند تصيير مشهد إلى image buffer. يخزن لون الخلفية، أبعاد الصورة، وإشارة الكاميرا. هذه الميزة متاحة في التكوينات المدعومة. |
انظر أيضًا
