چگونه با سه‌بعدی در پایتون شروع کنیم

چگونه با سه‌بعدی در پایتون شروع کنیم

پیش‌نیازها

  • Python 3.8 یا بالاتر
  • مدیر بسته pip

مرحله 1 — نصب بسته

Aspose.3D FOSS را برای پایتون از PyPI نصب کنید:

pip install aspose-3d-foss

نصب را تأیید کنید:

import aspose.threed as a3d
print(a3d.__version__)

مرحله ۲ — ایجاد اولین صحنهٔ سه‌بعدی خود

یک Scene، محفظه ریشه برای تمام اشیاء سه‌بعدی است. سازنده یک موجودیت، صحنه والد و نام اختیاری را می‌پذیرد:

import aspose.threed as a3d

# Create an empty scene (CLM-3d-35d727)
scene = a3d.Scene()

# Access the root node of the scene (CLM-3d-859ac2)
root = scene.root_node()
print("Root node:", root)

مرحله ۳ — افزودن یک مش به صحنه

Mesh نمایانگر هندسه چندضلعی است. Node موجودیت‌ها را به گراف صحنه متصل می‌کند:

import aspose.threed as a3d

scene = a3d.Scene()

# Create a named mesh (CLM-3d-529c11)
mesh = a3d.Mesh("my_mesh")

# Create a node and attach the mesh (CLM-3d-0edae8)
node = a3d.Node("my_node", mesh)

# Add the node as a child of the root (CLM-3d-a403f5)
scene.root_node().add_child_node(node)

مرحله ۴ — بارگذاری یک فایل 3D موجود

Scene.open() یک فایل 3D را از دیسک یا جریان بارگذاری می‌کند. یک مسیر و گزینه‌های بارگذاری
اختیاری را می‌پذیرد:

import aspose.threed as a3d

# Load an OBJ file (CLM-3d-d84964)
scene = a3d.Scene()
scene.open("model.obj")

# Inspect the loaded scene
root = scene.root_node()
print("Child nodes:", len(root.child_nodes()))

برای تشخیص فرمت فایل قبل از بارگذاری:

import aspose.threed as a3d

# Detect the format from a file name (CLM-3d-d2de62)
fmt = a3d.FileFormat.detect(None, "model.fbx")
if fmt:
    print("Detected format:", fmt.extension())

مرحله 5 — ذخیره خروجی در یک فایل

Scene.save() صحنه را به هر قالب پشتیبانی‌شده‌ای صادر می‌کند. روش پیشنهادی تشخیص خودکار مبتنی بر پسوند است: Aspose.3D قالب را از پسوند فایل استنتاج می‌کند (CLM-3d-8051bd, CLM-3d-b28d7a, CLM-3d-de8e1a):

import aspose.threed as a3d

scene = a3d.Scene()
# ... populate scene ...

# Save as Wavefront OBJ — extension auto-detects the format
scene.save("output.obj")

# Save as glTF 2.0 binary — .glb extension triggers binary GLB output
scene.save("output.glb")

همچنین می‌توانید یک فرمت صریح را با استفاده از متدهای کارخانه FileFormat.WAVEFRONT_OBJ() یا FileFormat.GLTF2() پاس بدهید، اما تشخیص خودکار پسوند ساده‌تر و قابل حمل‌تر است.

مراحل بعدی

 فارسی