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

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.0

Proverite 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
 Српски