Aspose.3D FOSS
Python
Bắt đầu
Cài đặt

Cài đặt

Cài đặt Aspose.3D FOSS cho Python

Aspose.3D FOSS cho Python được phân phối dưới dạng gói pure-Python trên PyPI. Không có phần mở rộng gốc nào cần biên dịch, không có thư viện hệ thống nào cần cài đặt, và không yêu cầu Microsoft Office hay bất kỳ môi trường chạy của bên thứ ba nào.

Yêu cầu trước

Yêu cầuChi tiết
Python phiên bản3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
Trình quản lý góipip (được kèm theo CPython)
Hệ điều hànhWindows, macOS, Linux (bất kỳ nền tảng nào chạy CPython)
Trình biên dịch / công cụ xây dựngKhông cần thiết
Gói hệ thốngKhông cần thiết

1. Install via pip (Recommended)

Cách đơn giản nhất để cài đặt Aspose.3D FOSS là trực tiếp từ PyPI:

pip install aspose-3d-foss

pip sẽ tải xuống và cài đặt gói, đồng thời ghi lại trong môi trường của bạn. Không cần cấu hình nào sau khi cài đặt.

Để cài đặt một phiên bản cố định cho các bản dựng có thể tái tạo:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

Sử dụng môi trường ảo giúp thư viện được cô lập khỏi các dự án Python khác và tránh xung đột phiên bản.

Tạo và kích hoạt môi trường ảo:

##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

Cài đặt thư viện trong môi trường đã kích hoạt:

pip install aspose-3d-foss

Ghi lại các phụ thuộc để tái tạo:

pip freeze > requirements.txt

Để tái tạo môi trường trên máy khác:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

Sau khi cài đặt, xác minh rằng thư viện được nhập khẩu đúng cách:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

Kết quả mong đợi:

Aspose.3D FOSS installed successfully
Root node name:

Lưu ý: Nút gốc không có tên mặc định — scene.root_node.name trả về một chuỗi rỗng.

Bạn cũng có thể kiểm tra phiên bản đã cài đặt bằng pip:

pip show aspose-3d-foss

Lệnh này sẽ in ra phiên bản, tác giả và giấy phép (MIT).

Bắt đầu nhanh: Tải một Scene và Kiểm tra nó

Đoạn script sau tải một tệp 3D, in thông tin về mỗi nút mesh, và xuất lại scene sang định dạng 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")

Nếu bạn chưa có tệp OBJ, thư viện cũng có thể tạo một scene từ đầu:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

Ghi chú về nền tảng

Windows, macOS, Linux: Thư viện giống hệt trên mọi nền tảng. Không có đường dẫn mã đặc thù cho nền tảng nào hoặc phần mở rộng nhị phân.

Docker / serverless: Vì không có phụ thuộc gói hệ thống, thư viện hoạt động trong các hình ảnh Docker gọn (như python:3.12-slim) mà không cần cài đặt bất kỳ gói apt hoặc yum nào thêm.

CI/CD: Thêm pip install aspose-3d-foss vào bước phụ thuộc của pipeline CI của bạn. Không cần thiết lập bổ sung.

Conda: Nếu dự án của bạn sử dụng Conda, hãy cài đặt thư viện từ PyPI trong môi trường Conda:

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

Tài nguyên bổ sung

 Tiếng Việt