1. Sản Phẩm
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Python

Aspose.3D FOSS cho Python

Tải, tạo, chuyển đổi và xuất các cảnh 3D từ Python — miễn phí và mã nguồn mở.

Aspose.3D FOSS for Python Aspose.3D FOSS
for Python

Tài Liệu GitHub

Thư viện Python mã nguồn mở cho Xử lý Tập tin 3D

Aspose.3D FOSS cho Python là một thư viện thuần Python có giấy phép MIT, dùng để làm việc với các định dạng tệp 3D. Cài đặt nó bằng một lệnh pip duy nhất và ngay lập tức bắt đầu đọc, xây dựng và ghi các cảnh 3D mà không cần cài đặt bất kỳ môi trường chạy gốc nào, SDK bên ngoài, hoặc bộ dựng hình của bên thứ ba.

Thư viện cung cấp một API đồ thị cảnh sạch sẽ được xây dựng quanh Scene, Node, Mesh, Camera, Light, và Transform, cùng mô hình khái niệm được các công cụ 3D chuyên nghiệp sử dụng. Hỗ trợ định dạng bao gồm OBJ (với việc tải vật liệu .mtl), STL (nhị phân và ASCII, đã xác minh quá trình round‑trip), glTF 2.0 / GLB (vật liệu PBR), COLLADA (DAE), 3MF, và FBX. Các tùy chọn tải và lưu cho từng định dạng cho phép bạn kiểm soát việc lật tọa độ, tỉ lệ, chuẩn hoá pháp tuyến và tải vật liệu mà không cần viết bất kỳ mã phân tích định dạng nào.

Aspose.3D FOSS hỗ trợ Python 3.7 đến 3.12 và chạy giống hệt trên Windows, macOS và các trình chạy CI Linux, container Docker và môi trường không máy chủ. Đối với các tính năng doanh nghiệp và hỗ trợ, xem Aspose.3D for Python — Enterprise Product.

Hỗ trợ Định dạng 3D và API Đồ thị Cảnh

  • OBJ / MTL: Tải các tệp Wavefront OBJ kèm theo định nghĩa vật liệu.
  • STL: Đọc và ghi cả STL nhị phân và ASCII với việc xác minh vòng tròn đầy đủ.
  • glTF 2.0 / GLB: Tải vật liệu PBR và xuất GLB nhị phân qua GltfSaveOptions.
  • COLLADA, 3MF, FBX: Hỗ trợ định dạng bổ sung với các lớp tùy chọn cho từng định dạng.
  • API đồ thị cảnh: Scene, Node, Mesh, Camera, Light, Transform.

Nơi Aspose.3D FOSS có thể được sử dụng

  • Asset validation pipelines: Xác minh, định hướng lại và xuất lại các tài sản 3D trong CI.
  • Công cụ phát triển trò chơi: Xử lý hàng loạt các lưới OBJ/GLB mà không cần engine gốc.
  • Quy trình in 3D: Đọc, xác thực và xuất lại các tệp STL và 3MF.
  • Web backends: Cung cấp các endpoint chuyển đổi 3D trong Docker hoặc các hàm serverless.
  • Di chuyển nội dung: Chuyển đổi giữa các họ định dạng ở quy mô lớn.

Tùy chọn Theo Định dạng và Kiểm soát Tọa độ

  • Hướng hệ tọa độ: Lật trục và điều chỉnh tỷ lệ cho mỗi định dạng mà không cần mã tùy chỉnh.
  • Chuẩn hoá pháp tuyến: Tự động chuẩn hoá các pháp tuyến đỉnh khi tải hoặc lưu.
  • Kiểm soát tải vật liệu: Bật hoặc tắt việc tải MTL/texture để phân tích nhanh hơn.
  • Binary vs. JSON output: Chọn GLB gọn nhẹ hoặc glTF có thể đọc được bởi con người qua các tùy chọn.
  • Độ trung thực vòng quay: Cấu trúc đồ thị cảnh được duy trì qua các chu kỳ tải và lưu (độ trung thực bảo tồn nút phụ thuộc vào định dạng và không được xác minh độc lập cho tất cả các định dạng).

Trải nghiệm nhà phát triển

Aspose.3D FOSS cho Python cài đặt bằng một lệnh pip install aspose-3d-foss duy nhất. Thư viện là Python thuần, không có phần mở rộng gốc để biên dịch và không có gói hệ thống nào cần cài đặt.

API đồ thị cảnh phản ánh mô hình khái niệm của các công cụ 3D chuyên nghiệp, vì vậy đường cong học tập ngắn đối với bất kỳ ai quen thuộc với mô hình dữ liệu của Three.js hoặc Blender. Thư viện được cấp phép MIT-licensed, open-source, và chào đón các báo cáo lỗi và đóng góp trên GitHub.

Tải một cảnh OBJ và xuất dưới dạng glTF

Cài đặt bằng pip, sau đó gọi Scene.open() với ObjLoadOptions để tải tệp OBJ cùng với các định nghĩa vật liệu MTL của nó. Một lần gọi scene.save() duy nhất với phần mở rộng .gltf sẽ ghi một tệp JSON glTF 2.0 — không cần đăng ký định dạng hay đối tượng chuyển đổi.

pip install aspose-3d-foss

from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
# Load an OBJ file (with .mtl materials)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())
# Export as glTF 2.0
scene.save("model.gltf")

Chuyển đổi STL sang Binary GLB với việc lật tọa độ

Để tạo ra một tệp GLB nhị phân gọn thay vì glTF JSON mặc định, hãy truyền một thể hiện GltfSaveOptions với binary_mode = True. Cùng một mẫu áp dụng cho việc điều chỉnh hệ tọa độ — thay thế lớp tùy chọn bằng định dạng bạn đang nhắm tới.

from aspose.threed import Scene
from aspose.threed.formats import GltfSaveOptions
scene = Scene()
scene.open("mesh.stl")
# Save as binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

Câu Hỏi Thường Gặp

Aspose.3D FOSS cho Python là gì?

Đây là một thư viện pure-Python miễn phí, có giấy phép MIT, dùng để tải, thao tác và lưu các cảnh 3D mà không cần cài đặt bất kỳ runtime gốc nào hoặc SDK bên ngoài.

Các định dạng 3D nào được hỗ trợ?

OBJ (với .mtl), STL (binary và ASCII), glTF 2.0 và GLB, COLLADA (DAE), 3MF và FBX. Mỗi định dạng có một lớp tùy chọn tải/lưu riêng.

Có yêu cầu bất kỳ phụ thuộc gốc nào không?

Không. Aspose.3D FOSS cho Python là pure Python không có bất kỳ phần mở rộng gốc nào. Nó chạy trên Windows, macOS và Linux mà không cần bước biên dịch nào.

Làm sao để cài đặt nó?

Chạy pip install aspose-3d-foss. Không cần gói hệ thống bổ sung hay phần mở rộng gốc.

Tôi có thể kiểm soát hướng hệ tọa độ không?

Có. Các lớp tùy chọn theo định dạng cho phép bạn lật trục, điều chỉnh tỉ lệ và chuẩn hoá vector pháp tuyến mà không cần viết mã phân tích cú pháp riêng cho từng định dạng.

Các phiên bản Python nào được hỗ trợ?

Python 3.7 đến 3.12 được hỗ trợ. Thư viện chạy giống hệt trên mọi hệ điều hành chính.

Mã nguồn có sẵn không?

Có. Thư viện được cấp phép MIT và được lưu trữ trên GitHub. Các báo cáo lỗi và yêu cầu kéo (pull request) đều được chào đón.

  

Tài Nguyên Hỗ Trợ và Học Tập

 Tiếng Việt