التثبيت

تثبيت Aspose.3D FOSS لـ Python

يتم توزيع Aspose.3D FOSS for Python كحزمة Python النقية على PyPI. لا توجد إضافات أصلية لتركيبها، ولا مكتبات النظام لتثبيتها، وليس هناك مايكروسوفت أو أي وقت تشغيل من طرف ثالث مطلوب.

المعايير

1. Install via pip (Recommended)

أسهل طريقة لتثبيت Aspose.3D FOSS هي مباشرة من PyPI:

سوف يقوم pip بتنزيل وتثبيت الحزمة وسجلها في بيئتك.لا تحتاج إلى تكوين ما بعد التثبت.

لتثبيت نسخة مرفوعة للتركيبات قابلة للتكرار:

2. Set Up a Virtual Environment (Recommended for Projects)

ويحافظ استخدام البيئة الافتراضية على مكتبة بعيدة عن مشاريع Python الأخرى وتجنب نزاعات النسخة.

إنشاء وتشغيل بيئة افتراضية:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

قم بتثبيت المكتبة داخل البيئة المحمولة:

إحصائيات التردد في العادة:

pip freeze > requirements.txt

إعادة تدوير البيئة على آلة أخرى:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

بعد التثبيت، تأكد من أن المكتبة تستورد بشكل صحيح:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

الناتج المتوقع :

Aspose.3D FOSS installed successfully
Root node name:

ملاحظة : لا يوجد اسم مبدئي للصوت - scene.root_node.name يعود سلك فارغ.

يمكنك أيضًا التحقق من النسخة المثبتة باستخدام Pip:

pip show aspose-3d-foss

هذا سوف يطبع النسخة، المؤلف، والترخيص (MIT).

بدء سريع: تحميل المشهد ومراجعته

يُحمل السيناريو التالي ملفًا 3D، ويطبع معلومات عن كل عقدة من النوافذ، ويتم إعادة تصدير المشهد إلى تنسيق GLB:

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions

##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False

scene = Scene()
scene.open("model.obj", options)

##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")

for node in scene.root_node.child_nodes:
    if node.entity is None:
        continue
    mesh = node.entity
    print(f"  Node: {node.name}")
    print(f"    Vertices: {len(mesh.control_points)}")
    print(f"    Polygons: {len(mesh.polygons)}")
    if node.material:
        print(f"    Material: {type(node.material).__name__}")

##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")

إذا لم يكن لديك ملف OBJ بعد ، فيمكن للمكتبة أيضًا إنشاء مشهد من التخفيضات:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

منصة ملاحظات

ويندوز، ماكوس، لينكس: المكتبة هي نفسها على جميع المنصات لا توجد مسارات رمزية محددة للمنصة أو التمديدات الثنائية.

الخادم / الخادمة : وبما أنه لا توجد إدمانات نظامية، فإن المكتبة تعمل داخل صور Docker الضيقة (مثل: python:3.12-slim) دون تثبيت أي حزم إضافية apt أو yum.

CI/CD: إضافة pip install aspose-3d-foss إلى مرحلة الاعتماد على خط أنابيب CI الخاص بك. لا يتطلب إعدادات إضافية.

كوندا : إذا كان مشروعك يستخدم كوندا، قم بتثبيت مكتبة من PyPI داخل بيئة كوندا:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

الموارد الإضافية

• صفحة المنتج: نظرة عامة ، ملخص الميزات ، والشهادات
• دليل المطور: إشارة API كاملة مع أمثلة الرمز
• الخصائص والوظائف: دعم تنسيق، الرسم البياني للمشهد، والمواد، والوسائل الرياضية، وأكثر من ذلك.