دليل المطور

Aspose.3D FOSS for Python هي مكتبة مفتوحة المصدر مرخصة بموجب رخصة MIT تتيح لمطوري Python تحميل، إنشاء، تحويل، وتصدير مشاهد 3D دون أي تبعيات تشغيلية خارجية. سواء كنت تبني خط أنابيب الأصول، أداة تحقق، برنامج معالجة هندسي، أو خدمة تحويل صيغ، توفر هذه المكتبة API نظيفة ومتسقة مدعومة بنموذج مخطط المشهد (scene-graph) الذي يعكس مفاهيم 3D القياسية في الصناعة.

دليل المطور هذا يغطي كل ما تحتاجه لتجاوز تثبيت البدء السريع وكتابة شفرة معالجة ثلاثية الأبعاد بجودة الإنتاج.

ما ستجده في هذا القسم

الميزات والوظائف

صفحة الميزات هي المرجع الأساسي للعمل مع Aspose.3D FOSS للبايثون. تغطي:

  • دعم الصيغ: OBJ (مع مواد .mtl)، STL (ثنائي و ASCII)، glTF 2.0 / GLB، COLLADA (DAE)، 3MF، ومحلل FBX قيد التطوير، مع فئات خيارات التحميل والحفظ لكل صيغة.
  • رسم بياني للمشهد: كيف Scene، Node، Entity، Transform، وGlobalTransform تتكوّن إلى هيكلية مشهد كاملة، بما في ذلك أنماط عبور العقد الفرعية.
  • واجهة برمجة تطبيقات الشبكة: العمل مع control_points، VertexElementNormal، VertexElementUV، VertexElementVertexColor، وVertexElementSmoothingGroup لمعالجة الهندسة.
  • نظام المواد: تطبيق LambertMaterial وPhongMaterial على عقد المشهد، وقراءة خصائص المواد المحمّلة من ملفات .mtl.
  • أدوات الرياضيات: استخدام Vector2، Vector3، Vector4، FVector3، Quaternion، Matrix4، وBoundingBox للتحويلات، استعلامات صندوق الحدود، والحسابات الهندسية.
  • الرسوم المتحركة: إنشاء وقراءة بيانات AnimationClip، AnimationNode، KeyFrame، وKeyframeSequence.
  • خيارات التحميل والحفظ: فئات خيارات لكل صيغة مثل ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) وStlSaveOptions.
  • أمثلة استخدام كاملة: سكريبتات بايثون شاملة من البداية للنهاية لتحميل OBJ، تصدير STL، تحويل ذهابًا وإيابًا glTF، وتصفح رسومات المشهد.
  • نصائح، مشكلات شائعة، وأسئلة متكررة: إرشادات عملية لتجنب الأخطاء الشائعة في الاستخدام الإنتاجي.
  • ملخص مرجع API: قائمة مرجعية سريعة بجميع الفئات الرئيسية.

المفاهيم الأساسية

مخطط المشهد: كل محتوى ثلاثي الأبعاد في Aspose.3D FOSS يُمثَّل كشجرة من كائنات Node جذورها scene.root_node. يمكن لكل عقدة أن تحمل Entity (مثل Mesh، Camera، أو Light) وTransform يحدد موقعها في التسلسل الهرمي.

واجهة برمجة تطبيقات غير معتمدة على الصيغة: يمكنك فتح أي صيغة مدعومة عبر Scene.open() أو Scene.from_file() وحفظ إلى أي صيغة مدعومة عبر Scene.save(). يتم استخدام نفس كائنات مخطط المشهد بغض النظر عن صيغة المصدر أو الوجهة.

صفر تبعيات: المكتبة مكتوبة بلغة بايثون خالصة. لا توجد امتداد أصلي للترجمة، ولا حزمة نظام لتثبيتها، ولا مكتبة طرف ثالث لإدارتها.

البدء

إذا لم تقم بتثبيت المكتبة بعد، راجع قسم Getting Started ودليل Installation قبل المتابعة في القراءة.

المواضيع المتاحة

 العربية