Aspose.3D FOSS for Python

مرجع API لـ: أسبوس-3د-فوس 26.1.0 (بايثون 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

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

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

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

الفئةوصف
Meshكيان شبكة متعددة الأطراف. تخزن نقاط التحكم (مواقع القمة كما هو الحال في الموقع) Vector4) ، قوائم الوجوه المتعددة الأطراف (قواسم مؤشرات نقاط التحكم) وطبقات عناصر القمة (الطبيعية، الأشعة فوق البنفسجية, ألوان القمم).
Geometryقاعدة مجردة لأنواع الهندسة الشبيهة بالشبكة. تحدد مجموعة نقاط التحكم ومجموعة من VertexElement طبقات. Mesh يرث من Geometry.
VertexElementقاعدة تجريدية لطبقة بيانات متصلة بالهندسة (المعايير، الأشعة فوق البنفسجية، الألوان، إلخ). mapping_mode, reference_mode,، و a data قائمة.
VertexElementNormalيخزن متجه واحد طبيعي لكل قمة أو كل زاوية متعددة الأبعاد، اعتمادا على: mapping_mode.قيم البيانات هي: FVector4 الحالات (المتواحدة الدقة) مع w غير مستخدمة.
VertexElementUVيخزن بيانات الإحداثيات النسيجية كـ: FVector4 لكل قمة أو كل زاوية متعددة الأطراف (فقط) x و y يمكن أن تحمل الشبكة طبقات UV متعددة لقنوات النسيج المختلفة.
VertexElementVertexColorتخزين بيانات اللون RGBA لكل عمق أو كل زاوية كما هو الحال. FVector4 (r، g، b، a في نطاق 01).
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 الرسوم البيانية.

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

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

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

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

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

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

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

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

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

الفئةوصف
AnimationClipحاوية مسمّى لمجموعة من القنوات المتحركة تغطي نطاق تشغيل واحد. A Scene قد تحتوي على عدة مقاطع (مثل “المشي” ، “الركض”).
AnimationNodeيربط و 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.

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

الرمزوصف
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

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

صيغة STL

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

صيغة glTF

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

صيغة FBX

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

COLLADA شكل

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

3MF Format

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

إحصاءات

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

نظام الخصائص

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

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

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

انظر أيضاً

 العربية