البدء

##البدء مع Aspose.3D FOSS للـ Python

مرحبًا بكم في Aspose.3D FOSS for Python، مكتبة مجانية مرخصة بموجب MIT لتحميل وبناء وتصدير المشاهد ثلاثية الأبعاد من بايثون. سيوجهك هذا الدليل من بيئة جديدة إلى مشهد يعمل في بضع دقائق.

المتطلبات المسبقة

قبل التثبيت، تأكد من أن بيئتك تلبي هذه المتطلبات:

إصدار Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, أو 3.12
  • CPython هو المفسّر المرجعي؛ تم اختبار جميع الإصدارات الستة في كل إصدار

مدير الحزم

  • pip (مُضمّن مع جميع إصدارات بايثون الحديثة)
  • لا توجد أدوات بناء أخرى أو مترجمات أو حزم نظام مطلوبة

نظام التشغيل

  • Windows و macOS و Linux مدعومة جميعًا
  • المكتبة مكتوبة بلغة Python بحتة: لا توجد امتدادات أصلية خاصة بالمنصة تحتاج إلى تجميع

التثبيت

التثبيت من PyPI باستخدام pip:

pip install aspose-3d-foss

انظر إلى دليل التثبيت لإعداد البيئة الافتراضية، وخطوات التحقق، ومثال كود سريع للبدء.

ما يمكنك القيام به باستخدام Aspose.3D FOSS للبايثون

بمجرد التثبيت، يمكنك فورًا:

  • تحميل OBJ (بدعم مواد .mtl)، STL، glTF 2.0، GLB، COLLADA، وملفات 3MF
  • فحص هياكل المشهد: استعراض العقد، قراءة الشبكات، الوصول إلى الأعمدة العادية للرؤوس وUVs
  • تحويل المشاهد: تطبيق المواضع، الدورانات (عبر Quaternion)، والقياسات باستخدام Transform
  • تطبيق المواد: العمل مع LambertMaterial وPhongMaterial على عقد المشهد
  • تصدير إلى أي تنسيق مدعوم مع خيارات حفظ لكل تنسيق
  • حساب الهندسة: استعلام عن صناديق الحدود، تجميع التحويلات في الفضاء العالمي باستخدام GlobalTransform
  • قراءة الرسوم المتحركة: الوصول إلى بيانات AnimationClip وKeyframeSequence من ملفات glTF وCOLLADA المحملة

البدء السريع

يقوم الكود التالي بتحميل ملف المشهد، ويطبع أبناء العقدة الجذرية، ويعيد حفظ المشهد بتنسيق GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

الخطوات التالية

 العربية