Bắt đầu

Aspose.3D FOSS cho Python

Chào mừng đến với Aspose.3D FOSS cho Python, một thư viện miễn phí, có giấy phép MIT, dùng để tải, xây dựng và xuất các cảnh 3D từ Python. Hướng dẫn này sẽ đưa bạn từ môi trường mới đến một cảnh hoạt động trong vài phút.

Yêu cầu trước

Trước khi cài đặt, hãy đảm bảo môi trường của bạn đáp ứng các yêu cầu sau:

Phiên bản Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython là trình thông dịch tham chiếu; cả sáu phiên bản đều được kiểm tra trên mỗi bản phát hành

Trình quản lý gói

  • pip (được bao gồm trong tất cả các cài đặt Python hiện đại)
  • Không cần công cụ xây dựng, trình biên dịch hay gói hệ thống nào khác

Hệ điều hành

  • Windows, macOS và Linux đều được hỗ trợ
  • Thư viện thuần Python: không có phần mở rộng gốc đặc thù nền tảng nào cần biên dịch

Cài đặt

Cài đặt từ PyPI bằng pip:

pip install aspose-3d-foss

Xem Hướng dẫn Cài đặt để thiết lập môi trường ảo, các bước xác minh, và một ví dụ mã khởi động nhanh.

Aspose.3D FOSS cho Python

Sau khi cài đặt, bạn có thể ngay lập tức:

  • Tải các tệp OBJ (có hỗ trợ vật liệu .mtl), STL, glTF 2.0, GLB, COLLADA và 3MF
  • Kiểm tra các phân cấp cảnh: duyệt các nút, đọc lưới, truy cập các pháp tuyến đỉnh và UV
  • Biến đổi các cảnh: áp dụng vị trí, quay (qua Quaternion) Transform
  • Áp dụng vật liệu: làm việc với LambertMaterial và PhongMaterial trên các nút cảnh
  • Xuất đến bất kỳ định dạng nào được hỗ trợ với các tùy chọn lưu riêng cho mỗi định dạng
  • Tính toán hình học: truy vấn hộp bao, tích lũy các biến đổi không gian thế giới với GlobalTransform
  • Đọc hoạt hình: truy cập AnimationClip và KeyframeSequence dữ liệu từ các tệp glTF và COLLADA đã tải

Bắt đầu nhanh

Đoạn mã sau tải một tệp cảnh, in ra các nút con của nút gốc, và lưu lại cảnh ở định dạng GLB:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

Các bước tiếp theo

 Tiếng Việt