Aspose.3D FOSS for Java

مرجع API لـ: أسبوس-3د-فوس 26.1.0 (جافا 21 + ، ترخيص MIT).

جميع الفئات تقع في المرحلة الثانوية. com.aspose.threed حزمة الجذر. الواردات الجذرية هي:

import com.aspose.threed.*;

تصميم الحزمة: تقريباً جميع الفصول العامة في com.aspose.threed.المجموعة الفرعية الوحيدة التي تستخدم عادة هي: com.aspose.threed.shading (للمرضى) PbrMaterial) المادة الثانية: com.aspose.threed.formats تحتوي الحزمة الفرعية على مستوردين/مصدري داخليين ولا يتم استيرادها بشكل مباشر عادة.

اتفاقية تسمية جافا: تستخدم جميع الخصائص أساليب getter/setter. على سبيل المثال، استخدام node.getTransform() بدلا من node.transform,، و transform.setTranslation(...) بدلا من transform.translation = ....لاحظ أن Vector3, Vector4, Quaternion, Matrix4,، و FVector أنواع الاستخدام المجال العام (v.x, v.y, v.z) بدلاً من المشتريات للوصول إلى مكون.

الرسم البياني لمشهد الأساسي

الفئة	وصف
`Scene`	حاوية مستوى أعلى لجميع بيانات المشهد ثلاثي الأبعاد. تحتوي على العقدة الجذرية، والبيانات الوصفية للأصول، ومقاطع الرسوم المتحركة. `fromFile()`, `open()`,، و `save()` كنقاط الدخول الأساسية للدخول/الخروج.
`Node`	عقدة مسمّية في التسلسل الهرمي للمشهد. تمتلك قائمة بالعقدات الأولاد وقائمة العقد المرفقة `Entity` مثل الشباك، الكاميرات والضوء. يحمل محلي `Transform`.
`Entity`	فئة أساسية مجردة لجميع الكائنات التي يمكن ربطها بـ `Node`.يقدم الاسم والهوية ولكن لا هندسة خاصة به.
`SceneObject`	الفئة الأساسية المشتركة من قبل: `Node` و `Entity`.يوفر واجهة جمع الخصائص المستخدمة للبيانات النقطية التي يحددها المُستخدم.
`A3DObject`	طبقة الأساس الجذر لجميع الكائنات Aspose.3D المدارة. تعرض خاصية الاسم والصيغة `Properties` جمعية.
`INamedObject`	واجهة تضمن `getName()` طريقة. تنفيذها: `Node`, `Entity`,، والعديد من أنواع الموصف الخاصة بالشكل.

الهندسة والشبكة

الفئة	وصف
`Mesh`	كيان شبكة متعددة الأطراف. تخزن نقاط التحكم (مواقع القمة كما هو الحال في الموقع) `Vector4`) ، قوائم الوجوه المتعددة الأطراف (قواسم مؤشرات نقاط التحكم) وطبقات عناصر القمة (الطبيعية، الأشعة فوق البنفسجية, ألوان القمم).
`Geometry`	قاعدة مجردة لأنواع الهندسة الشبيهة بالشبكة. تحدد مجموعة نقاط التحكم ومجموعة من `VertexElement` طبقات. `Mesh` يرث من `Geometry`.
`VertexElement`	قاعدة تجريدية لطبقة بيانات متصلة بالهندسة (المعايير، الأشعة فوق البنفسجية، الألوان، إلخ). `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` (مجموعة القيم بالإضافة إلى مجموعة فهرس منفصلة).

التحول والمساحة

الفئة	وصف
`Transform`	التحول المحلي المرتبط بـ `Node`.يوفر الترجمة، التدوير (كما هو الحال في المراحل السابقة) ، والإصدارات. `Quaternion`) ، ومكونات المقياس، بالإضافة إلى طرق الراحة لظلال أويلر.
`GlobalTransform`	عرض القراءة فقط لتحويل الفضاء العالمي للعنصر بعد تكوين جميع التحويلات الأجدادية. يمكن الوصول إليها عبر `node.getGlobalTransform()`.
`AssetInfo`	كتلة البيانات الوصفية المرفقة إلى `Scene`.يقوم بتخزين اسم التطبيق المؤلف، وسم الوحدة، وعامل مقياس الوحدات، وتعريف محور النظام الإحداثي، والختام الزمني لإنشاء/تغيير.

المواد والظلال

الفئة	وصف
`Material`	فئة أساسية مجردة لجميع أنواع المواد. توفر اسمًا ومجموعة من الخصائص للمعلمات العددية واللونية.
`PbrMaterial`	مادة التصوير المستندة بدنيا. تخزن البديو، عامل المعادن، عنصر الصلابة، اللون المنبعث، الشفافية والمنسوجات ذات الاطلاق. تستخدم بواسطة glTF 2.0 وغيرها من التنسيقات القابلة ل PBR. الاستيراد: `com.aspose.threed.shading.PbrMaterial`.

الكاميرا

الفئة	وصف
`Camera`	كيان الكاميرا، ورث من `Entity`.لا يتم عرض أي خصائص محددة للشكل في إصدار Java FOSS خارج مجموعة الأسماء والخصائض الموروثة. مرفق إلى a `Node` لتحديد وجهة نظر التحولات.

ملاحظة: المجلس الوزاري Light فئة ليست متوفرة في نسخة Java من Aspose.3D FOSS. يتم تخزين بيانات إضاءة المشهد من ملفات المستوردة كشكل عام Entity الأشياء.

أدوات رياضيات

الفئة	وصف
`Vector2`	متجه دقيق مزدوج من مكونين (`x`, `y`) يستخدم لتنسيقات النسيج فوق البنفسجي.
`Vector3`	متجه مزدوج الدقة من ثلاث مكونات (`x`, `y`, `z`) المستخدمة للمواقع والاتجاهات والمقياس.
`Vector4`	متجه مزدوج الدقة من 4 مكونات (`x`, `y`, `z`, `w`) تستخدم لمواقع التحكم (مواقف متجانسة) والبيانات العادية.
`FVector3`	متجه عابر ذو دقة واحدة من ثلاثة مكونات يظهر في مصفوفات بيانات العنصر القصوى للطبيعيات والملمسات.
`FVector4`	المتجه العائم ذو الدقة الواحد من 4 مكونات. نوع التخزين `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` تستخدم في الاستفسارات الفضائية ومساعدات التخلص من المخلوقات.

الرسوم المتحركة

الفئة	وصف
`AnimationClip`	حاوية مسمّى لمجموعة من الرسوم المتحركة. A `Scene` قد تحتوي على عدة مقاطع (مثل “المشي” ، “الركض”). عقدة الإعلان بيانات الإطار الرئيسي وتشغيل لا يتم تنفيذها بعد.

صيغة إدخال/إخراج

الرمز	وصف
`Scene.fromFile(path)`	طريقة ثابتة. يفتح الملف في `path`,، يكتشف الشكل من الإضافة، ويعيد شكل المملوءة. `Scene`.يرمي على ملف غير موجود أو لا يدعمها الصيغة.
`Scene.open(path, options)`	طريقة الحالة. يفتح ملف في الملف الموجود `Scene` مثال، اختياري باستخدام صيغة محددة `LoadOptions` فئة فرعية.
`Scene.save(path, options)`	طريقة الحالة. يسلس المشهد إلى `path` باستخدام الشكل المستمد من الإضافة، وإذا كان ذلك اختيارياً باستخدام شكل محدد للشكل. `SaveOptions` فئة فرعية.
`FileFormat`	سجل صيغ الملفات المدعومة. يحتوي على إدخالات مثل: `FileFormat.WAVEFRONTOBJ`, `FileFormat.GLTF2`, `FileFormat.FBX7400ASCII`.
`IOService`	استخراج داخلي للإنتاج والخروج يستخدمه مستوردون ومصدرون. لا تستخدم عادة مباشرةً من خلال رمز التطبيق.
`LoadOptions`	الطبقة الأساسية لجميع كائنات خيار التحميل الخاصة بالنسخة. `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`.
`SaveOptions`	طبقة أساسية لجميع كائنات خيار حفظ محددة للنسخة. `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`.

صيغة OBJ

الفئة	وصف
`ObjImporter`	فئة مستورد داخلية تحلل ملفات Wavefront OBJ و MTL. يتم استدعائها تلقائيًا بواسطة: `Scene.fromFile()` لـ: `.obj` تمديدات.
`ObjLoadOptions`	خيارات تحميل ملفات Wavefront OBJ. خصائص رئيسية: `setFlipCoordinateSystem()`, `setScale()`, `setEnableMaterials()`, `setNormalizeNormal()`.
`ObjSaveOptions`	حفظ خيارات لخروج Wavefront OBJ. يسيطر على الطبيعية، الأشعة فوق البنفسجية ، المواد الإشارة، ونظام النقط السحابة.
`ObjFormat`	وصف النمط لـ Wavefront OBJ. يمكن الوصول إليه ك… `FileFormat.WAVEFRONTOBJ`.

صيغة STL

الفئة	وصف
`StlImporter`	مستورد داخلي يقرأ ملفات STL الثنائية و ASCII. يتم اختيارها تلقائياً عن طريق الإضافة.
`StlExporter`	المصدّر الداخلي الذي يكتب STL.
`StlLoadOptions`	خيارات التحميل لملفات STL. الدعم `setFlipCoordinateSystem()`, `setRecalculateNormal()`,، و `setContentType()`.
`StlSaveOptions`	حفظ خيارات للخروج STL. التحكمات `setFlipCoordinateSystem()`, `setAxisSystem()`,، و `setContentType()`.
`StlFormat`	وصف الصيغة لـ STL.

صيغة glTF

الفئة	وصف
`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.

الفئة	وصف
`FbxLoadOptions`	خيارات تحميل ملفات FBX. خاصية المفتاح: `setFlipCoordinateSystem()`.
`FbxFormat`	وصف الصيغة لـ FBX. يمكن الوصول إليه كـ `FileFormat.FBX7400ASCII`.

إحصاءات

إحصاءات	وصف
`Axis`	يحدد محور إحداثيات: `X_AXIS`, `Y_AXIS`, `Z_AXIS`.يستخدم في خيارات إعادة رسم نظام الإحداثيات.
`CoordinateSystem`	يحدد اتفاقية التصرف اليدوي: `RIGHT_HANDED` أو `LEFT_HANDED`.
`TextureMapping`	يحدد كيفية ترسم النسيج إلى الهندسة: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`,، الخ.
`BooleanOperation`	نوع العملية البولية CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

نظام الخصائص

الفئة	وصف
`Property`	خاصية واحدة مسمّى على النوع `A3DObject`.يقوم بتخزين اسم العقار، وصف النوع والقيمة الحالية.
`PropertyCollection`	جمع غير قابل للتكرار من: `Property` الأجسام المرتبطة بـ… `A3DObject`.يدعم البحث عن طريق الاسم والتكرار على جميع الخصائص المحددة.
`CustomObject`	خفيف الوزن `A3DObject` الفئة الفرعية التي تحمل اسم فقط و تعسفي `PropertyCollection`.يستخدم لتخزين البيانات المتحولة التي حددها المستخدم على كائنات المشهد.

الصورة والعرض

الفئة	وصف
`ImageRenderOptions`	خيارات التشغيل بالبرمجيات عند تقديم مشهد إلى عداد المؤقت للصورة. تخزين لون الخلفية وأبعاد الصورة ومراجع الكاميرا. ملاحظة: جميع طرق التصوير يرمي `UnsupportedOperationException` في طبعة FOSS؛ لا توجد إصدارة متاحة.