Cara untuk mula menggunakan Aspose.3D FOSS untuk .NET

Aspose.3D FOSS untuk .NET ialah pustaka percuma yang dilesenkan oleh MIT untuk muat naik, memanipulasi dan menyimpan fail 3D – tiada binari asli diperlukan, C# tulen daripada NuGet.

Panduan Langkah demi Langkah

Langkah 1: Pasang Pakej

Menginstal daripada NuGet (.NET 10.0 atau lebih baru diperlukan):

dotnet add package Aspose.3D --version 26.1.0

Pastikan instalasi telah diisi dengan betul:

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

Langkah 2: Import Namespaces yang diperlukan

Import namespaces untuk kelas adegan dan format:

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

Langkah 3: Muat naik fail 3D

digunakan Scene.Open() untuk muat naik sebarang format yang disokong. Perpustakaan mendeteksi format secara automatik daripada ekstensi fail:

using Aspose.ThreeD;

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

Atau gunakan kilang statik:

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

Bagaimana saya menelusuri graf adegan?

Sebuah tempat yang tertutup ialah sebuah pokok Node Objek yang dihasilkan pada 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);

Langkah 3: Simpan ke Format Sasaran

digunakan Scene.Save() untuk mengeksport ke mana-mana format output yang disokong. Perpustakaan mendeteksi Format output daripada ekstensi fail:

using Aspose.ThreeD;

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

Isu Umum dan Penyelesaian

FileNotFoundException Apabila memanggil Scene.Open() Jalan yang anda lalui tidak wujud atau menggunakan pemisah yang salah. gunakan jalan mutlak atau Path.Combine() untuk memastikan laluan fail adalah betul.

UnsupportedOperationException Untuk kaedah tertentu Sesetengah kaedah (penyerahan adegan, watermarking) tidak tersedia dalam edisi FOSS. Semak dokumen batasan sebelum menggunakan ciri-ciri lanjutan.

Kesilapan format yang tidak diketahui Pastikan ekstensi fail sepadan dengan format sebenar. pustaka mendeteksi format oleh Perpanjangan untuk Scene.Open() dan Scene.FromFile().• Melalui ekspresi FileFormat parameter untuk mengalih keluar daripada pengesanan.

Skenario kosong selepas muat turun Sesetengah format binari mungkin memerlukan pilihan muat tertentu. cuba menggunakan overload eksplisit dengan ObjLoadOptions atau GltfLoadOptions jika muat lalai menghasilkan adegan kosong.

Soalan Lazim

Adakah Aspose.3D FOSS memerlukan Microsoft Office atau mana-mana DLL asli?

Perpustakaan adalah C # murni tanpa ketergantungan asli atau binari luaran diperlukan.

Versi .NET mana yang disokong?

.NET 10.0 atau lebih baru. pustaka ini berjalan pada Windows, macOS, Linux dan Docker kontena.

Adakah perpustakaan ini percuma untuk kegunaan komersial?

Ia dikeluarkan di bawah lesen MIT. anda boleh menggunakan, mengubah dan mendistribusikannya untuk apa-apa tujuan, termasuk aplikasi komersial.

Format 3D apa yang boleh saya baca dan tulis?

Perpustakaan ini menyokong OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA dan 3MF untuk kedua-dua membaca dan menulis. PLY hanya import-only. gunakan FileFormat.GetFormatByExtension() 2 buah Format yang disokong dalam runtime.

Bolehkah saya mencipta adegan 3D daripada awal?

a. membina sebuah Scene tanpa argumen, tambahkan anak nodes kepada scene.RootNode,dan Simpan kepada format yang diingini.