نصب

Python 3.7 تا 3.12 را مورد نیاز قرار می دهد.Pip install aspose-3d-foss: بدون نیاز به ساخت.

Aspose.3D FOSS برای Python به‌عنوان یک بستهٔ pure-Python در PyPI توزیع می‌شود. هیچ افزونهٔ بومی برای کامپایل وجود ندارد، کتابخانهٔ سیستمی برای نصب نیست و نیازی به Microsoft Office یا سایر زمان‌اجرای شخص ثالث نیست.

پیش‌نیازها

1. Install via pip (Recommended)

ساده‌ترین روش برای نصب Aspose.3D FOSS مستقیماً از PyPI است:

pip install aspose-3d-foss

pip بسته را دانلود و نصب می‌کند و در محیط شما ثبت می‌نماید. نیازی به پیکربندی پس از نصب نیست.

برای نصب نسخهٔ ثابت به‌منظور ساخت‌های قابل تکرار:

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) را چاپ می‌کند.

شروع سریع: بارگذاری یک صحنه و بررسی آن

اسکریپت زیر یک فایل 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")

یادداشت‌های پلتفرم

ویندوز، macOS، لینوکس: کتابخانه در تمام پلتفرم‌ها یکسان است. هیچ مسیر کد یا افزونه باینری مخصوص پلتفرم وجود ندارد.

Docker / بدون سرور: به دلیل عدم وجود وابستگی‌های بسته‌های سیستمی، کتابخانه در داخل تصاویر 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 به همراه مثال‌های کد
• ویژگی‌ها و عملکردها: پشتیبانی از فرمت‌ها، گراف صحنه، مواد، ابزارهای ریاضی، و موارد دیگر