Kako započeti s Aspose.3D FOSS za .NET

Aspose.3D FOSS za .NET je besplatna knjižnica koja je licencirana MIT-om za preuzimanje, manipulaciju i spašavanje 3D datoteka – nema potrebnih nativnih binara, čiste C# od NuGet.

Kratak korak vodič

Korak 1: Instalirajte paket

Instaliranje iz NuGet (potrebno je .NET 10.0 ili noviji):

dotnet add package Aspose.3D --version 26.1.0

Provjerite instaliranje ispravno:

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

2. korak: Uvoz potrebnih nazivnih prostora

Uvoz nazivnih prostora za scenu i formate razreda:

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

Korak 3: Preuzmite 3D datoteku

korištenje Scene.Open() za preuzimanje bilo kojeg podržanog formata. knjižnica otkriva format automatski iz proširenja datoteke:

using Aspose.ThreeD;

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

Ili koristite statsku metodu tvornice:

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

Korak 4: Pređite kroz grafikon scene

Uspješna scena je drvo od Node Objekt koji je usmjeren na 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);

Korak 5: Sačuvajte u različitim formatima

korištenje Scene.Save() u bilo kojem formatu podupiranog izlaska. knjižnica otkriva Izlazni format iz proširenja datoteke:

using Aspose.ThreeD;

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

Zajednički problemi i korekcije

FileNotFoundException Kada se poziva Scene.Open() Put koji ste prošli ne postoji ili koristi pogrešan separator. Path.Combine() osigurati da je dosjeni put ispravan.

UnsupportedOperationException Za određene metode Neke metode (scenijska rendering, vodena oznaka) nisu dostupne u izdanju FOSS-a. Provjerite dokumentaciju ograničenja prije korištenja naprednih značajki.

Nepoznata pogreška u formatu U svakom slučaju, neka se dosje prilagođava stvarnom formatu.Knjižnica otkriva format po Proširenje za Scene.Open() i Scene.FromFile().Provedite izričito FileFormat Parametri za prekomjernu detekciju.

Prolazna scena nakon punjenja Neki binarni formati mogu zahtijevati određene opcije tereta. pokušajte koristiti izričito preopterećenje sa ObjLoadOptions ili GltfLoadOptions ako privremeni teret proizvodi praznu scenu.

Često postavljana pitanja

Trebaju li Aspose.3D FOSS Microsoft Office ili bilo koje domaće DLL?

Knjižnica je čista C# s ne-native ovisnosti ili vanjske binare potrebne.

Koje su verzije .NET-a podržane?

.NET 10.0 ili kasnije. knjižnica radi na Windows, macOS, Linux i Docker kontejnerima.

Je li knjižnica slobodna za komercijalnu upotrebu?

Da, izdan je pod MIT licencom. možete ga koristiti, izmijeniti i redistribuirati za bilo koji svrhu, uključujući komercijalne aplikacije.

Koje 3D formate mogu čitati i pisati?

Knjižnica podržava OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i 3MF za oba čitanje i pisanje. PLY je samo uvoz. FileFormat.GetFormatByExtension() u Pitanje podupiru formati u radnom vremenu.

Mogu li napraviti 3D scenu iz skraćenja?

I. Izgradnja A Scene bez argumenata, dodajte dječje čvorove na scene.RootNode,i Uključite u željeni format.