Cara Memulai dengan Aspose.3D FOSS untuk .NET

Aspose.3D FOSS untuk .NET adalah perpustakaan gratis, lisensi MIT untuk muat naik, memanipulasi, dan menyimpan file 3D - tidak ada binari asli yang diperlukan, C# murni dari NuGet.

Panduan Langkah-demi-Langkah

Langkah 1: Instal Paket

Instal dari NuGet ( .NET 10.0 atau lebih baru diperlukan):

dotnet add package Aspose.3D --version 26.1.0

Periksa instalasi yang diisi dengan benar:

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

Langkah 2: Impor Namespace

Import ruang nama untuk adegan dan format kelas:

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

Bagaimana cara memuat file 3D?

Penggunaan Scene.Open() untuk mengunggah format yang didukung. perpustakaan mendeteksi format secara otomatis dari file extension:

using Aspose.ThreeD;

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

Atau gunakan metode pabrik statik:

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

Bagaimana cara menelusuri scene graph?

Sebuah tempat yang penuh beban adalah sebuah pohon dari Node Objek yang berakar 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 Target

Penggunaan Scene.Save() untuk mengekspor ke format output yang didukung. perpustakaan mendeteksi Format output dari file extension:

using Aspose.ThreeD;

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

Masalah dan Fixes Umum

FileNotFoundException Ketika memanggil Scene.Open() Jalan yang Anda lalui tidak ada atau menggunakan pemisah yang salah. gunakan jalan mutlak atau Path.Combine() Untuk memastikan jalur file yang benar.

UnsupportedOperationException Untuk beberapa metode Beberapa metode (penyataan adegan, watermarking) tidak tersedia dalam edisi FOSS. Periksa dokumentasi pembatasan sebelum menggunakan fitur lanjutan.

Kesalahan Format yang Tidak Dikenal Pastikan file extension sesuai dengan format yang sebenarnya. perpustakaan mengidentifikasi format oleh Perpanjangan untuk Scene.Open() dan Scene.FromFile().Lakukan ekspresinya FileFormat Parameter untuk mengecilkan deteksi.

Tempat kosong setelah muat Beberapa format biner mungkin memerlukan opsi beban tertentu.Coba gunakan overload yang jelas Dengan ObjLoadOptions atau GltfLoadOptions Jika beban default menghasilkan adegan kosong.

Pertanyaan yang Sering Diajukan

Apakah Aspose.3D FOSS membutuhkan Microsoft Office atau DLL asli?

No. Perpustakaan adalah C# murni dengan tidak ada ketergantungan asli atau binari eksternal yang diperlukan.

Versi .NET apa yang disokong?

.NET 10.0 atau lebih baru. perpustakaan berjalan pada Windows, macOS, Linux, dan Docker konten.

Apakah perpustakaan ini gratis untuk penggunaan komersial?

Ya. ini dikeluarkan di bawah lisensi MIT. Anda dapat menggunakannya, mengubah dan meredistribusinya untuk tujuan apa pun, termasuk aplikasi komersial.

3D format apa yang bisa saya baca dan tulis?

Perpustakaan ini mendukung OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA dan 3MF untuk keduanya. membaca dan menulis. PLY hanya diimport-hanya. gunakan FileFormat.GetFormatByExtension() Untuk Format yang didukung dalam waktu runtime.

Dapatkah saya membuat adegan 3D dari scratch?

Ya. membangun a Scene Dengan tidak ada alasan, tambahkan nodes anak ke scene.RootNode,dan disimpan dalam format yang diinginkan.