Kako započeti sa Aspose.3D FOSS za .NET
Aspose.3D FOSS za .NET je besplatna, MIT-licencirana biblioteka za učitavanje, manipulaciju i čuvanje 3D fajlova — nije potrebno nijedno nativno binarno, čisti C# iz NuGet.
Vodič korak po korak
Korak 1: Instalirajte paket
Instalirajte iz NuGet (potreban je .NET 10.0 ili noviji):
dotnet add package Aspose.3D --version 26.1.0Proverite da je instalacija učitana ispravno:
using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");Korak 2: Uvezi potrebne prostore imena
Uvezite prostore imena za klase scene i formata:
using Aspose.ThreeD;
using Aspose.ThreeD.Formats;Korak 3: Učitaj 3D fajl
Koristi statičku metodu Scene.from_file() da otvoriš bilo koji podržani format. Biblioteka automatski otkriva format na osnovu ekstenzije fajla.
using Aspose.ThreeD;
var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");Ili koristite statičku fabriku metodu:
var scene = Scene.FromFile("model.glb");Korak 4: Prođite kroz graf scene
Učitana scena je stablo objekata Node koje ima koren u 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 3: Sačuvajte u ciljni format
Koristite Scene.Save() da izvezete u bilo koji podržani izlazni format. Biblioteka otkriva izlazni format na osnovu ekstenzije fajla:
using Aspose.ThreeD;
var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");Uobičajeni problemi i rešenja
FileNotFoundException prilikom poziva Scene.Open() Putanja koju ste prosledili ne postoji ili koristi pogrešan separator. Koristite apsolutnu putanju ili Path.Combine() da osigurate da je putanja do fajla ispravna.
UnsupportedOperationException za određene metode Neke metode (renderovanje scene, vodeni žig) nisu dostupne u FOSS izdanju. Proverite dokumentaciju o ograničenjima pre nego što koristite napredne funkcije.
Greška nepoznatog formata. Uverite se da ekstenzija fajla odgovara stvarnom formatu. Biblioteka otkriva format po ekstenziji za Scene.Open() i Scene.FromFile(). Prosledite eksplicitni parametar FileFormat da biste prepisali detekciju.
Prazna scena nakon učitavanja. Neki binarni formati mogu zahtevati specifične opcije učitavanja. Pokušajte da koristite eksplicitno preopterećenje sa ObjLoadOptions ili GltfLoadOptions ako podrazumevano učitavanje daje praznu scenu.
Često postavljana pitanja
Da li Aspose.3D FOSS zahteva Microsoft Office ili bilo koje native DLL‑ove?
Ne. Biblioteka je čista C# i ne zahteva native zavisnosti niti eksterne binarne fajlove.
Koje .NET verzije su podržane?
.NET 10.0 ili noviji. Biblioteka radi na Windows‑u, macOS‑u, Linux‑u i Docker kontejnerima.
Da li je biblioteka besplatna za komercijalnu upotrebu?
Da. Objavljena je pod MIT licencom. Možete je koristiti, menjati i redistribuirati u bilo koje svrhe, uključujući komercijalne aplikacije.
Koje 3D formate mogu da čitam i pišem?
Biblioteka podržava OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i 3MF za čitanje i pisanje. PLY je samo za uvoz. Koristite FileFormat.GetFormatByExtension() da u runtime‑u upitate podržane formate.
Mogu li da napravim 3D scenu od početka?
Da. Kreirajte Scene bez argumenata, dodajte podređene čvorove u scene.RootNode i sačuvajte u željeni format.
Vidi takođe
- FAQ — Aspose.3D FOSS za .NET
- Kako učitati 3D modele u .NET
- Kako konvertovati 3D modele u .NET
- Dokumentacija za početak
- API referenca