Hướng Dẫn Nhà Phát Triển

Aspose.3D FOSS cho Python là một thư viện mã nguồn mở, được cấp phép MIT, cho phép các nhà phát triển Python tải, xây dựng, biến đổi và xuất các cảnh 3D mà không cần bất kỳ phụ thuộc runtime bên ngoài nào. Dù bạn đang xây dựng một pipeline tài sản, một công cụ kiểm tra, một script xử lý hình học, hay một dịch vụ chuyển đổi định dạng, thư viện này cung cấp một API sạch sẽ, nhất quán, được hỗ trợ bởi mô hình đồ thị cảnh phản ánh các khái niệm 3D tiêu chuẩn trong ngành.

Hướng Dẫn Nhà Phát Triển này bao gồm mọi thứ bạn cần để vượt qua việc cài đặt nhanh và viết mã xử lý 3D chất lượng sản xuất.

Những Điều Bạn Sẽ Tìm Thấy Trong Phần Này

Tính Năng và Chức Năng

Cái Tính năng trang là tài liệu tham khảo chính để làm việc với Aspose.3D FOSS cho Python. Nó bao gồm:

  • Hỗ trợ định dạng: OBJ (với vật liệu .mtl), STL (nhị phân và ASCII), glTF 2.0 / GLB, COLLADA (DAE), 3MF, và bộ phân tích FBX đang phát triển, với các lớp tùy chọn tải và lưu cho mỗi định dạng.
  • Đồ thị cảnh: Cách Scene, Node, Entity, Transform, và GlobalTransform tạo thành một cây phân cấp cảnh đầy đủ, bao gồm các mẫu duyệt nút con.
  • Mesh API: Làm việc với control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, và VertexElementSmoothingGroup để xử lý hình học.
  • Hệ thống vật liệu: Áp dụng LambertMaterial và PhongMaterial đến các nút cảnh, và đọc các thuộc tính vật liệu được tải từ các tệp .mtl.
  • Tiện ích Toán học: Sử dụng Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, và BoundingBox cho các phép biến đổi, truy vấn hộp bao, và các phép tính hình học.
  • Hoạt hình: Xây dựng và đọc AnimationClip, AnimationNode, KeyFrame, và KeyframeSequence dữ liệu.
  • Tùy chọn tải và lưu: Các lớp tùy chọn theo định dạng như ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • Các ví dụ sử dụng đầy đủ: Các script Python từ đầu đến cuối để tải OBJ, xuất STL, chuyển đổi vòng lại glTF, và duyệt đồ thị cảnh.
  • Mẹo, các vấn đề thường gặp và FAQ: Hướng dẫn thực tế để tránh các sai lầm phổ biến trong môi trường sản xuất.
  • Tóm tắt tài liệu tham chiếu API: Danh sách tham chiếu nhanh của tất cả các lớp chính.

Các khái niệm chính

Scene graph: Tất cả nội dung 3D trong Aspose.3D FOSS được biểu diễn dưới dạng một cây của Node các đối tượng có gốc tại scene.root_node. Mỗi nút có thể mang một Entity (như một Mesh, Camera, hoặc Light) và một Transform điều này đặt nó trong hệ thống phân cấp.

API không phụ thuộc vào định dạng: Bạn mở bất kỳ định dạng nào được hỗ trợ qua Scene.open() hoặc Scene.from_file() và lưu sang bất kỳ định dạng nào được hỗ trợ qua Scene.save(). Các đối tượng đồ thị cảnh (scene-graph) giống nhau được sử dụng bất kể định dạng nguồn hay đích.

Không phụ thuộc nào: Thư viện này hoàn toàn thuần Python. Không có phần mở rộng gốc nào cần biên dịch, không có gói hệ thống nào cần cài đặt, và không có thư viện bên thứ ba nào cần quản lý.

Bắt đầu

Nếu bạn chưa cài đặt thư viện, hãy xem Bắt đầu phần và Cài đặt hướng dẫn trước khi đọc tiếp.

Các chủ đề có sẵn

 Tiếng Việt