Aspose.3D FOSS for Python

مرجع API لـ aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, رخصة MIT).

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

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

مخطط المشهد الأساسي

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

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

MethodsMethods
Meshكيان شبكة مضلع. يخزن نقاط التحكم (مواقع الرؤوس كـ Vector4), قوائم أوجه المضلع (قوائم مؤشرات نقاط التحكم)، وطبقات عناصر الرؤوس (المتجهات العمودية، UVs، ألوان الرؤوس).
Geometryقاعدة تجريدية لأنواع الهندسة الشبيهة بالشبكة. تُعرّف مصفوفة نقاط التحكم ومجموعة VertexElement الطبقات. Mesh يرث من Geometry.
VertexElementقاعدة تجريدية لطبقة بيانات مرفقة بالهندسة (المتجهات العمودية، UVs، الألوان، إلخ). تحمل mapping_mode, reference_mode,، و data قائمة.
VertexElementNormalيخزن متجهًا عموديًا واحدًا لكل رأس أو لكل زاوية مضلع، حسب mapping_mode. قيم البيانات هي FVector4 النُسخ (بدقة مفردة) مع w غير مستخدم.
VertexElementUVيخزن بيانات إحداثيات القوام كـ FVector4 لكل رأس أو لكل زاوية مضلع (فقط x و y المكوّنات تُستخدم للـ UV). قد يحمل الـ mesh عدة طبقات UV لقنوات القوام المختلفة.
VertexElementVertexColorيخزن بيانات اللون RGBA لكل رأس أو لكل زاوية كـ FVector4 (r, g, b, a في النطاق 0–1).
VertexElementSmoothingGroupيخزن معرفات مجموعات التنعيم الصحيحة لكل مضلع، تُستخدم من قبل مستورد OBJ لإعادة إنتاج تعيينات مجموعات التنعيم الأصلية من ملف المصدر.
VertexElementTypeتعداد يحدد الدور الدلالي لطبقة عنصر الرأس: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP, وغيرها. مرّر القيم إلى Mesh.get_element().
MappingModeتعداد يتحكم في أي بدائية تُطَبَّق قيمة عنصر القمة إليها: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, أو ALL_SAME.
ReferenceModeتعداد يتحكم في كيفية فهرسة القيم: DIRECT (قيمة واحدة لكل بدائية ربط) أو INDEX_TO_DIRECT (مصفوفة القيم بالإضافة إلى مصفوفة مؤشرات منفصلة).
PolygonModifierفئة مساعدة ثابتة تحتوي على طرق لتثليث Mesh الكائنات والكل Scene الرسوم البيانية.

التحويل والفضائي

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

المواد والتظليل

MethodsMethods
Materialفئة أساسية مجردة لجميع أنواع المواد. توفر اسمًا ومجموعة خصائص للمعلمات الرقمية واللون.
LambertMaterialنموذج مادة يقتصر على الانتشار فقط. يخزن اللون المحيطي، اللون المنتشر، اللون المنبعث، والشفافية. يتم تحميله من ملفات OBJ التي تستخدم أساسية Ka/Kd/Ke إعلانات.
PhongMaterialMethods LambertMaterial مع لون انعكاسي ولمعان (معامل الانعكاس). يتم تحميله من ملفات OBJ التي تستخدم Ks/Ns إعلانات.
PbrMaterialمادة فيزيائيًا مستندة إلى التصيير. تخزن الألبيدو، معامل المعدن، معامل الخشونة، والملمس المرتبط. تُستخدم بواسطة glTF 2.0 وغيرها من الصيغ الداعمة لـ PBR.

الكاميرا والإضاءة

MethodsMethods
Cameraكيان الكاميرا. فقط projection_type و name تعمل في هذا الإصدار؛ جميع الخصائص الرقمية الأخرى (near_plane, far_plane, field_of_view, aspect_ratio) هي نماذج تجريبية تُعيد القيم الافتراضية. مرفقة بـ Node لتحديد تحويلات وجهة النظر.
Lightكيان مصدر الضوء. يرث من Camera كصف تجريبي؛ الـ Light الصف نفسه لا يكشف عن خصائص إضافية في هذا الإصدار.
LightTypeتعداد فئات الضوء المدعومة: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeتعداد أوضاع إسقاط الكاميرا: PERSPECTIVE و ORTHOGRAPHIC.

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

MethodsMethods
Vector2متجه ذو مكوّنين بدقة مزدوجة (x, y). يُستخدم لإحداثيات القوام UV.
Vector3متجه ذو ثلاثة مكوّنات بدقة مزدوجة (x, y, z). يُستخدم للمواقع، الاتجاهات، والقياس.
Vector4متجه ذو أربعة مكوّنات بدقة مزدوجة (x, y, z, w). يُستخدم لنقاط التحكم (المواقع المتجانسة) وبيانات العادي.
FVector2متجه عائم بدقة مفردة مكوّن من عنصرين. يُستخدم داخليًا لتخزين مضغوط في مصفوفات بيانات عناصر القمة.
FVector3متجه عائم بدقة مفردة مكوّن من ثلاثة عناصر. يظهر في مصفوفات بيانات عناصر القمة للمتجهات العادية والماسية.
FVector4متجه عائم مكوّن من 4 عناصر بدقة مفردة. نوع التخزين لـ VertexElementFVector.data.
Quaternionرباعية الوحدة لتمثيل الدورانات (w, x, y, z). يُستخدم بواسطة Transform.rotation.
Matrix44×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxصندوق احتواء محاذى للمحاور يُعرّف بـ minimum و maximum Vector3 زوايا. يُستخدم لاستعلامات الفضاء ومساعدي تقليم المخروط.

Methods

MethodsMethods
AnimationClipحاوية مسماة لمجموعة من القنوات المتحركة التي تغطي نطاق تشغيل واحد. الـ Scene قد يحتوي على مقاطع متعددة (مثل “Walk”, “Run”).
AnimationNodeيربط an AnimationClip إلى عقدة مشهد أو خاصية محددة. يعمل كجسر بين بيانات المقطع وعناصر رسم بياني المشهد.
AnimationChannelتدفق خاصية متحركة واحد داخل مقطع، يستهدف خاصية مسماة على كائن (مثالاً،., Transform.translation.x).
KeyFrameعينة زمن‑قيمة واحدة داخل KeyframeSequence. يخزن الوقت (بالثواني) والقيمة في ذلك الوقت.
KeyframeSequenceقائمة مرتبة من KeyFrame كائنات لقناة عددية واحدة، مع إعدادات الاستيفاء والاستطالة.
Interpolationتعداد أوضاع الاستيفاء بين الإطارات المفتاحية: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationTypeتعداد سلوكيات ما بعد الإطار المفتاحي الأول والأخير: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

إدخال وإخراج الصيغ

MethodsMethods
Scene.from_file(path)طريقة ثابتة. يفتح الملف في path,، يكتشف الصيغة من الامتداد، ويعيد كائنًا مُعبأً Scene. يثير استثناء عند عدم العثور على الملف أو تنسيق غير مدعوم.
Scene.open(path, options=None)طريقة مثيل. تفتح ملفًا في مثيل موجود Scene ، اختياريًا باستخدام تنسيق محدد LoadOptions فئة فرعية.
Scene.save(path, options=None)طريقة مثيل. تسلسل المشهد إلى path باستخدام التنسيق المستنتج من الامتداد، اختياريًا باستخدام تنسيق محدد SaveOptions فئة فرعية.
FileFormatسجل صيغ الملفات المدعومة. يحتوي على إدخالات مثل FileFormat.WAVEFRONT_OBJ, FileFormat.GLTF, FileFormat.FBX7400ASCII, FileFormat.MICROSOFT_3MF. يتم الوصول إلى المتغيرات الخاصة بالتنسيق عبر فئات الخيارات (مثال،., ColladaSaveOptions, GltfSaveOptions).
IOServiceتجريد داخلي للإدخال/الإخراج يُستخدم من قبل مستوردي ومصدري الصيغ. عادةً لا يُستَخدم مباشرةً من قبل شفرة التطبيق.
LoadOptionsالفئة الأساسية لجميع كائنات خيارات التحميل الخاصة بالصيغة. يتم توريثها من قبل ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ColladaLoadOptions, ThreeMfLoadOptions.
SaveOptionsالفئة الأساسية لجميع كائنات خيارات الحفظ الخاصة بالصيغة. يتم توريثها من قبل ObjSaveOptions, StlSaveOptions, GltfSaveOptions, FbxSaveOptions, ColladaSaveOptions, ThreeMfSaveOptions.

صيغة OBJ

MethodsMethods
ObjImporterفئة المستورد الداخلية التي تقوم بتحليل ملفات Wavefront OBJ و MTL. يتم استدعاؤها تلقائيًا بواسطة Scene.from_file() لـ .obj الامتدادات.
ObjLoadOptionsخيارات التحميل لملفات Wavefront OBJ. الخصائص الرئيسية: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsخيارات الحفظ لإخراج Wavefront OBJ. تتحكم في المتجهات العمودية، وإحداثيات UV، وإشارات المواد، ووضع سحابة النقاط.
ObjFormatوصف الصيغة لـ Wavefront OBJ. يمكن الوصول إليه كـ FileFormat.WAVEFRONT_OBJ().

صيغة STL

MethodsMethods
StlImporterالمستورد الداخلي الذي يقرأ ملفات STL الثنائية وASCII. يتم اختياره تلقائيًا حسب الامتداد.
StlExporterالمصدر الداخلي الذي يكتب ملفات STL.
StlLoadOptionsخيارات التحميل لملفات STL. يدعم flip_coordinate_system و scale.
StlSaveOptionsخيارات الحفظ لإخراج STL. يتحكم binary_mode, scale,، و flip_coordinate_system.
StlFormatوصف التنسيق لـ STL.

صيغة glTF

MethodsMethods
GltfLoadOptionsخيارات التحميل لملفات glTF 2.0 و GLB. الخاصية الرئيسية: flip_tex_coord_v.
GltfSaveOptionsخيارات الحفظ لإخراج glTF 2.0. استخدم binary_mode=True لحزمة GLB ذاتية الاحتواء.
GltfFormatوصف التنسيق لـ glTF 2.0 / GLB. يمكن الوصول إليه كـ FileFormat.GLTF2().

صيغة FBX

MethodsMethods
FbxLoadOptionsخيارات التحميل لملفات FBX. الخصائص الرئيسية: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsخيارات الحفظ لإخراج FBX. تصدير FBX يثير NotImplementedError دون شرط؛; FbxSaveOptions موجود ولكن التصدير غير مُنفّذ.
FbxFormatوصف التنسيق لـ FBX. يمكن الوصول إليه كـ FileFormat.FBX7400ASCII().

صيغة COLLADA

MethodsMethods
ColladaLoadOptionsخيارات التحميل لـ COLLADA (.dae) ملفات. يتحكم في إعادة تعيين المحاور ومقياس الوحدات عند الاستيراد.
ColladaSaveOptionsخيارات الحفظ لإخراج COLLADA. يتحكم في indented, flip_coordinate_system,، وتصدير المواد.
ColladaFormatوصف التنسيق لـ COLLADA. يتم حله تلقائيًا من .dae امتداد الملف.

3MF Format

MethodsMethods
ThreeMfLoadOptionsتحميل الخيارات لملفات 3MF (.3mf) ملفات.
ThreeMfSaveOptionsحفظ الخيارات لإخراج 3MF. 3MF هو التنسيق المفضل لسير عمل الطباعة ثلاثية الأبعاد.
ThreeMfFormatوصف التنسيق لملف 3MF. يمكن الوصول إليه كـ FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingيحدد كيفية ربط النسيج بالهندسة: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT,، إلخ.
BooleanOperationنوع عملية بوليانية CSG: UNION, DIFFERENCE, INTERSECTION.

نظام الخصائص

MethodsMethods
Propertyخاصية واحدة مسماة ومُعرفة النوع على A3DObject. يخزن اسم الخاصية، ووصف النوع، والقيمة الحالية.
PropertyCollectionمجموعة قابلة للتكرار من Property الكائنات المرفقة بـ A3DObject. يدعم البحث بالاسم والتكرار على جميع الخصائص المعرفة.
CustomObjectخفيفة الوزن A3DObject فئة فرعية تحمل فقط اسمًا وعشوائي PropertyCollection. تُستخدم لتخزين البيانات الوصفية المعرفة من قبل المستخدم على كائنات المشهد.

الصورة والتصيير

MethodsMethods
ImageRenderOptionsخيارات للتصوير النقطي البرمجي عند تصيير مشهد إلى مخزن صور. يخزن لون الخلفية، أبعاد الصورة، وإشارة الكاميرا. Scene.render() يثير NotImplementedError; لم يتم تنفيذ التصيير في هذا الإصدار.

انظر أيضًا

 العربية