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

Aspose.3D FOSS cho Python

Tải, tạo, biế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 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, tạo và ghi các cảnh 3D mà không cần cài đặt bất kỳ runtime gốc nào, SDK bên ngoài, hay trình render của bên thứ ba.

Thư viện cung cấp một API đồ thị cảnh (scene-graph) 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ợ các định dạng bao gồm OBJ (với việc tải vật liệu .mtl), STL (nhị phân và ASCII, đã được xác minh vòng lại), 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 mã phân tích cú pháp riêng cho định dạng.

Aspose.3D FOSS hỗ trợ Python từ phiên bản 3.7 đến 3.12 và chạy giống hệt trên các môi trường CI Windows, macOS và Linux, container Docker, và môi trường không máy chủ. Không có phần mở rộng gốc nào cần biên dịch và không có gói hệ thống nào cần cài đặt.

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 lại đầy đủ.
  • glTF 2.0 / GLB: Tải vật liệu PBR và xuất GLB nhị phân thông qua GltfSaveOptions.
  • COLLADA, 3MF, FBX: Hỗ trợ định dạng bổ sung với các lớp tùy chọn riêng cho từng định dạng.
  • Scene-graph API: Scene, Node, Mesh, Camera, Light, Transform.

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

  • Đường ống xác thực tài sản: Kiểm tra, định hướng lại và xuất lại tài sản 3D trong CI.
  • Công cụ phát triển game: Xử lý hàng loạt 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.
  • Content migration: 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 độ: Đảo trục và điều chỉnh tỉ lệ theo đị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.
  • Đầu ra nhị phân vs. JSON: Chọn GLB gọn nhẹ hoặc glTF dễ đọc cho 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 mọi định dạng).

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

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

API đồ thị cảnh (scene-graph) 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 cho bất kỳ ai quen thuộc với Three.js hoặc mô hình dữ liệu của Blender. Thư viện được cấp phép MIT, mã nguồn mở, và chào đón các báo cáo lỗi cũng như đó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ệnh scene.save() duy nhất với phần mở rộng .gltf sẽ ghi ra tệp JSON glTF 2.0, mà 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

# Tải tệp OBJ (với vật liệu .mtl)
scene = Scene()
scene.open("model.obj", ObjLoadOptions())

# Xuất dưới dạng glTF 2.0
scene.save("model.gltf")

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

Để tạo một tệp GLB nhị phân gọn thay vì JSON glTF mặc định, hãy truyền một thể hiện GltfSaveOptions với binary_mode = True. Cùng mẫu này áp dụng cho việc điều chỉnh hệ tọa độ — thay lớp tùy chọn bằng lớp đị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")

# Lưu dưới dạng binary GLB
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("mesh.glb", opts)

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

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

Đâ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ỳ môi trường chạy gốc nào hoặc SDK bên ngoài.

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

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

Nó 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 thế nào để 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 nào.

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 đảo 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.

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 tất cả các 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 đều được chào đón.

  

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

 Tiếng Việt