התקנה

Python 3.7 – 3.12 נדרש.התקנה עם ‘pip install aspose-3d-foss’.Pure Python: אין צורך בהרכבה.

Aspose.3D FOSS עבור Python מופץ כחבילה pure-Python ב‑PyPI. אין הרחבות מקומיות לקימפול, אין ספריות מערכת להתקנה, ואין צורך ב‑Microsoft Office או זמן ריצה של צד שלישי אחר.

דרישות מוקדמות

1. Install via pip (Recommended)

הדרך הפשוטה ביותר להתקנת Aspose.3D FOSS היא ישירות מ‑PyPI:

pip install aspose-3d-foss

pip יוריד ויתקין את החבילה וירשום אותה בסביבתך. אין צורך בתצורת post‑install.

להתקנת גרסה קבועה לבנייה ניתנת לשחזור:

pip install aspose-3d-foss==26.1.0

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 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. 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: RootNode

אתה יכול גם לבדוק את הגרסה המותקנת באמצעות 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 מלא עם דוגמאות קוד
• תכונות ופונקציונליות: תמיכה בפורמטים, גרף סצנה, חומרים, כלי מתמטיקה ועוד