การติดตั้ง

การติดตั้ง Aspose.3D FOSS สำหรับ 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 จะดาวน์โหลดและติดตั้งแพ็กเกจและบันทึกไว้ในสภาพแวดล้อมของคุณ ไม่จำเป็นต้องกำหนดค่าหลังการติดตั้ง.

เพื่อติดตั้งเวอร์ชันที่ระบุเพื่อการสร้างที่ทำซ้ำได้:

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:

หมายเหตุ: โหนดรากไม่มีชื่อเริ่มต้น — scene.root_node.name จะคืนสตริงว่าง.

คุณยังสามารถตรวจสอบเวอร์ชันที่ติดตั้งไว้ด้วย 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")

หมายเหตุแพลตฟอร์ม

Windows, macOS, Linux: ไลบรารีนี้เหมือนกันบนทุกแพลตฟอร์ม ไม่มีเส้นทางโค้ดหรือส่วนขยายไบนารีที่เฉพาะเจาะจงต่อแพลตฟอร์ม.

Docker / serverless: เนื่องจากไม่มีการพึ่งพาแพ็กเกจระบบ ไลบรารีทำงานได้ภายในอิมเมจ Docker แบบบาง (เช่น python:3.12-slim) โดยไม่ต้องติดตั้งแพ็กเกจ apt หรือ yum เพิ่มเติมใดๆ.

CI/CD: เพิ่ม pip install aspose-3d-foss ไปยังขั้นตอนการจัดการ dependencies ของ CI pipeline ของคุณ ไม่จำเป็นต้องตั้งค่าเพิ่มเติม.

Conda: หากโครงการของคุณใช้ Conda ให้ติดตั้งไลบรารีจาก PyPI ภายในสภาพแวดล้อม Conda:

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

แหล่งข้อมูลเพิ่มเติม

• หน้าผลิตภัณฑ์: ภาพรวม, สรุปคุณลักษณะ, และคำรับรอง
• คู่มือสำหรับนักพัฒนา: เอกสารอ้างอิง API ฉบับเต็มพร้อมตัวอย่างโค้ด
• คุณสมบัติและฟังก์ชันการทำงาน: การสนับสนุนรูปแบบ, กราฟฉาก, วัสดุ, ยูทิลิตี้คณิตศาสตร์, และอื่นๆ