Làm thế nào để bắt đầu với Aspose.3D FOSS cho .NET

Aspose.3D FOSS cho .NET là một thư viện miễn phí, được MIT cấp phép để tải lên, thao tác và tiết kiệm các tập tin 3D – không có binary bản địa cần thiết, C# tinh khiết từ NuGet.

Hướng dẫn từng bước

Bước 1: Cài Đặt Gói

Cài đặt từ NuGet (.NET 10.0 hoặc sau đó yêu cầu):

dotnet add package Aspose.3D --version 26.1.0

Kiểm tra cài đặt đã tải chính xác:

using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");

Bước 2: nhập khẩu không gian tên cần thiết

Import các không gian tên cho sân khấu và định dạng lớp học:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

Bước 3: Tải về file 3D

Sử dụng Scene.Open() tải bất kỳ định dạng được hỗ trợ. Thư viện phát hiện định hình Tự động từ file extension:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");

Hoặc sử dụng phương pháp nhà máy tĩnh:

var scene = Scene.FromFile("model.glb");

Bước 4: Đi qua kịch bản

Một cảnh tải là một cây của Node Các vật thể được làm gốc trong scene.RootNode:

using Aspose.ThreeD;

void Walk(Node node, int depth = 0)
{
    var indent = new string(' ', depth * 2);
    Console.WriteLine($"{indent}Node: {node.Name}");
    foreach (var child in node.ChildNodes)
        Walk(child, depth + 1);
}

var scene = Scene.FromFile("model.obj");
Walk(scene.RootNode);

Bước 5: Lưu vào định dạng khác nhau

Sử dụng Scene.Save() để xuất vào bất kỳ định dạng phát hành được hỗ trợ. Thư viện phát hiện các định dạng xuất từ file extension:

using Aspose.ThreeD;

var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");

Các vấn đề chung và Fixes

FileNotFoundException Khi gọi Scene.Open() Con đường bạn đã đi qua không tồn tại hoặc sử dụng bộ phân tách sai. Path.Combine() để đảm bảo con đường file là chính xác.

UnsupportedOperationException Đối với một số phương pháp Một số phương pháp (các cảnh rendering, watermarking) không có sẵn trong phiên bản FOSS. Kiểm tra tài liệu giới hạn trước khi sử dụng các tính năng tiên tiến.

lỗi định dạng không rõ Bảo đảm rằng phần mở rộng tệp phù hợp với định dạng thực tế. thư viện phát hiện định hình bằng cách: mở rộng cho Scene.Open() và Scene.FromFile().- Đưa ra một câu rõ ràng FileFormat - Parameters để vượt quá phát hiện.

Màn cảnh trống rỗng sau khi tải Một số định dạng nhị phân có thể yêu cầu tùy chọn tải cụ thể.Cố gắng sử dụng quá tải rõ ràng Với ObjLoadOptions hoặc GltfLoadOptions nếu tải mặc định tạo ra một cảnh trống rỗng.

Thường xuyên hỏi câu hỏi

Aspose.3D FOSS có yêu cầu Microsoft Office hay bất kỳ DLL nào?

Thư viện là C# tinh khiết với không có phụ thuộc bản địa hoặc binary bên ngoài cần thiết.

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

.NET 10.0 hoặc hơn. thư viện chạy trên các container Windows, macOS, Linux và Docker.

Thư viện có miễn phí để sử dụng thương mại không?

Có. Nó được phát hành theo Giấy phép MIT. Bạn có thể sử dụng, sửa đổi và phân phối lại nó cho bất kỳ mục đích nào, bao gồm các ứng dụng thương mại.

3D định dạng nào tôi có thể đọc và viết?

Thư viện hỗ trợ OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA và 3MF cho cả hai đọc và viết. PLY chỉ nhập khẩu. sử dụng FileFormat.GetFormatByExtension() để Query hỗ trợ định dạng trong runtime.

Tôi có thể tạo ra một cảnh 3D từ scratch không?

Tạo a Scene Không có lý do, thêm nút trẻ em vào scene.RootNode, và - Lưu trữ theo định dạng mong muốn.