چگونه با سهبعدی در پایتون شروع کنیم
پیشنیازها
- 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() پاس بدهید، اما تشخیص خودکار پسوند سادهتر و قابل حملتر است.
مراحل بعدی
- نحوه بارگذاری مدلهای سهبعدی در پایتون — قالبها، گزینهها، پیمایش گراف صحنه
- نحوه تبدیل مدلهای سهبعدی در پایتون — گردشکارهای تبدیل دستهای
- نحوه ساخت هندسه مش در پایتون — نقاط کنترل، چندضلعیها، نرمالها
- سوالات متداول — سوالات رایج و عیبیابی