التثبيت

تثبيت Aspose.3D FOSS للبايثون

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

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

1. التثبيت عبر pip (مستحسن)

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

pip install aspose-3d-foss

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

لتثبيت نسخة مثبتة لبناءات قابلة للتكرار:

pip install aspose-3d-foss==26.1.0

2. إعداد بيئة افتراضية (موصى به للمشاريع)

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

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

##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 install aspose-3d-foss

تسجيل الاعتمادات لإعادة الإنتاج:

pip freeze > requirements.txt

لإعادة إنشاء البيئة على جهاز آخر:

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

3. التحقق من التثبيت

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

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).

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

البرنامج النصي التالي يقوم بتحميل ملف ثلاثي الأبعاد، ويطبع معلومات عن كل عقدة شبكة، ويعيد تصدير المشهد إلى تنسيق 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")

ملاحظات المنصة

Windows, macOS, Linux: المكتبة متطابقة على جميع الأنظمة. لا توجد مسارات شفرة خاصة بالمنصة أو امتدادات ثنائية.

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

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

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

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

موارد إضافية

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