Predstavljamo Aspose.3D FOSS za .NET

Uzbuđeni smo da najavimo dostupnost Aspose.3D FOSS za .NET – besplatna, open‑source biblioteka za rad sa 3D formatima fajlova u .NET aplikacijama. Izgrađena kao čisto C# rešenje bez nativnih zavisnosti, biblioteka cilja .NET 10.0 i novije, čineći je dostupnom širokom spektru projekata i okruženja.

Ovaj post prikazuje šta biblioteka nudi, kako započeti i kuda dalje.

Šta je Aspose.3D FOSS za .NET?

Aspose.3D FOSS za .NET je lagana biblioteka za obradu 3D fajlova objavljena pod MIT licenca. Pruža scene-graph API koji vam omogućava da učitate, pregledate, transformišete i sačuvate 3D modele kroz nekoliko široko korišćenih formata. Biblioteka je u potpunosti napisana u C# i ne zahteva eksterne nativne binarne fajlove niti konfiguracije specifične za platformu.

Izvorni kod je dostupan na GitHub‑u: https://github.com/aspose-3d-foss/Aspose.3D-FOSS-for-NET

Ključne karakteristike

• Čist C# – nema P/Invoke, nema nativnih biblioteka, nema ograničenja platforme.
• .NET 10.0+ kompatibilno.
• MIT licencirano – koristite ga u ličnim, komercijalnim ili vlasničkim projektima bez ograničenja.
• Arhitektura scene-graph – poznato stablo čvorova, mreža, kamera i materijala.
• Podrška za više formata – čitanje i pisanje OBJ, STL, glTF 2.0, GLB, FBX, Collada i 3MF fajlova.

Brzi početak

NuGet instalacija

Dodajte NuGet paket u vaš projekat:

dotnet add package Aspose.3D.Converter --version 1.0.0

Vaša prva konverzija

Najjednostavniji slučaj upotrebe je učitavanje 3D fajla u jednom formatu i njegovo čuvanje u drugom. Evo dvostruke konverzije iz OBJ u STL:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("cube.obj");
scene.Save("output.stl");

The Scene klasa je centralna tačka ulaza. Pozovite scene.Open() sa putanjom do fajla da učita model, zatim pozovite Save() sa odredišnom putanjom. Biblioteka zaključuje format iz ekstenzije fajla.

Izgradnja scene od nule

Možete takođe programatski konstruisati scene:

using Aspose.ThreeD;
using Aspose.ThreeD.Entities;

var scene = new Scene();
var box = new Box(2, 2, 2);
var node = scene.RootNode.CreateChildNode("Box", box);

node.Transform.Translation = new FVector3(1, 2, 3);

scene.Save("scene.gltf");

Ovo kreira novu scenu, dodaje primitivni kvadar kao čvor‑dete pod korenom, postavlja ga na koordinate (1, 2, 3) i izveze rezultat kao glTF fajl.

Učitavanje sa opcijama specifičnim za format

Kada vam je potrebna finija kontrola nad procesom učitavanja, svaki format pruža svoju klasu opcija. Na primer, učitavanje STL fajla sa eksplicitnim opcijama:

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

var scene = new Scene();
var opts = new StlLoadOptions();
scene.Open("part.stl", opts);

// Inspect the loaded scene
Console.WriteLine("Root children: " + scene.RootNode.ChildNodes.Count);

// Re-export as OBJ
scene.Save("part.obj");

The scene.Open() metod prihvata bilo koji od tipova opcija učitavanja: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions, ili TmfLoadOptions.

Prolazak kroz graf scene

Kada je scena učitana, možete preći kroz stablo čvorova da pregledate ili izmenite njen sadržaj:

using Aspose.ThreeD;
using Aspose.ThreeD.Entities;

var scene = new Scene();
scene.Open("model.gltf");

foreach (var child in scene.RootNode.ChildNodes)
{
    Console.WriteLine("Node: " + child.Name);
    Console.WriteLine("  Translation: " + child.Transform.Translation);

    if (child.Entity is Mesh mesh)
    {
        Console.WriteLine("  Vertices: " + mesh.ControlPoints.Count);
    }
}

Ovaj obrazac je koristan za otklanjanje grešaka, generisanje izveštaja o sadržaju modela ili selektivno menjanje delova scene pre ponovnog izvoza.

Primena transformacija

Pozicioniranje čvorova u 3D prostoru se vrši putem Transform svojstva na svakom Node:

using Aspose.ThreeD;
using Aspose.ThreeD.Entities;

var scene = new Scene();

var parent = scene.RootNode.CreateChildNode("Parent");
parent.Transform.Translation = new FVector3(10, 0, 0);

var child = parent.CreateChildNode("Child");
child.Transform.Translation = new FVector3(5, 0, 0);
child.Transform.Scale = new FVector3(2, 2, 2);

// Child's world position is (15, 0, 0) due to
// parent-child transform inheritance

scene.Save("transformed.gltf");

Transformacije prate standardni model nasleđivanja roditelj‑dete: pozicija deteta u svetskom prostoru je kombinacija njegovog lokalnog transforma i svih transformacija pretka do korena.

Šta je uključeno

Biblioteka dolazi sa fokusiranim skupom mogućnosti dizajniranih oko 3D modela grafika scene.

Grafik scene

Grafik scene je kičma API-ja. Svaka 3D datoteka je predstavljena kao struktura stabla:

Ugrađene primitive

Izdanje .NET uključuje parametarske klase oblika koje se mogu direktno prikačiti čvorovima ili konvertovati u Mesh:

• Kocka – kocka poravnata sa osama sa podesivom širinom, visinom i dubinom.
• Sfera – parametarska sfera sa podesivim radijusom.
• Cilindar – parametarski cilindar sa podesivim radijusima i visinom.

var sphere = new Sphere(1);
var mesh = sphere.ToMesh();
Console.WriteLine("Vertices: " + mesh.ControlPoints.Count);

Materijali

Biblioteka pruža više tipova materijala:

• LambertMaterial – klasični materijal samo difuznog osvetljenja sa komponentama boje ambient, difuzne, emisivne i reflektujuće.
• PhongMaterial – proširuje Lambert sa specularnim naglascima i sjajnošću.
• PbrMaterial – materijal zasnovan na fizički baziranom renderovanju sa osnovnom bojom, metalnošću, hrapavosti, zaklonom i slotovima za teksture.

Matematički alati

The Aspose.ThreeD namespace uključuje osnovne matematičke primitive:

• FVector3 – vektor od tri komponente u jednoj preciznosti za pozicije, pravce i skalu. Koristi se u Transform.Translation i Transform.Scale.
• Vector4 – vektor od četiri komponente u jednoj preciznosti za kontrolne tačke i normale.
• Matrix4 – 4x4 transformaciona matrica.
• Quaternion – reprezentacija rotacije. Koristi se u Transform.Rotation.
• BoundingBox – okvir ograničavajući kvadar poravnat na ose za prostorne upite.

var a = new FVector3(1, 0, 0);
var b = new FVector3(0, 1, 0);
// Vector operations for spatial computations

Opcije učitavanja i čuvanja

Svaki format ima posvećene klase opcija koje vam omogućavaju da kontrolišete ponašanje uvoza i izvoza:

Na primer, za učitavanje OBJ fajla sa preokretanjem koordinata i normalizacijom normala:

var opts = new ObjLoadOptions();
opts.FlipCoordinateSystem = true;
opts.NormalizeNormal = true;

scene.Open("model.obj", opts);

Podržani formati

Sledeća tabela sumira formate koje Aspose.3D FOSS za .NET može da čita i piše.

Vodič za izbor formata

Izbor pravog formata zavisi od vašeg slučaja upotrebe:

• OBJ je idealan kada vam je potrebna maksimalna kompatibilnost između 3D alata. Gotovo svaka aplikacija za modelovanje može da čita i piše OBJ. Dobro funkcioniše za razmenu mrežnih podataka, ali prenosi samo osnovne informacije o materijalu kroz prateće MTL fajlove.
• STL je format po izboru za radne tokove 3D štampe. Čuva sirovu trianguliranu geometriju bez materijala ili hijerarhije scene, što je tačno ono što softver za sečenje očekuje.
• glTF je moderan standard za web i real‑time 3D. Podržava PBR materijale, potpune hijerarhije scene i dizajniran je za efikasno prenošenje. Koristite glTF kada pravite web‑bazirane preglednike ili ciljate bilo koji real‑time render pipeline.
• FBX je duboko integrisan u radne tokove razvoja igara i kreiranja digitalnog sadržaja. Podržava bogate podatke o sceni uključujući hijerarhije i materijale. Aspose.3D FOSS za .NET podržava FBX uvoz i izvoz u oba ASCII i binarna režima.
• 3MF je moderan format za 3D štampu koji podržava bogate metapodatke, materijale i scene sa više objekata u jednom paketu zasnovanom na ZIP.

Poznata ograničenja

Scene.Render() je nije podržano u FOSS izdanju. Pozivanje ove metode će baciti NotImplementedException. Biblioteka je dizajnirana za obradu 3D podataka zasnovanu na fajlovima – učitavanje, manipulaciju, transformaciju i čuvanje modela – umesto real-time renderovanja na ekranu.

Open source i licenciranje

Aspose.3D FOSS za .NET je objavljen pod MIT License. Ovo znači da ste slobodni da:

• Koristite biblioteku u komercijalnim i vlasničkim aplikacijama.
• Izmenite izvorni kod da odgovara vašim potrebama.
• Distribuirajte biblioteku kao deo vašeg softvera.

Ne postoje royalty takse, nema ograničenja upotrebe, i nema zahteva za atribuciju izvan onoga što MIT licenca definiše.

Puni izvorni kod je hostovan na GitHub-u, a doprinosi su dobrodošli: https://github.com/aspose-3d-foss/Aspose.3D-FOSS-for-NET

Sistemski zahtevi

Početak rada

Evo resursa koji će vam pomoći da započnete:

• Dokumentacija – sveobuhvatni vodiči i API pregledi su dostupni na Aspose.3D sajt dokumentacije.
• Baza znanja – praktični how-to članci i saveti za rešavanje problema u Aspose.3D KB.
• API referenca – detaljna referenca klasa i metoda na Aspose.3D API referenca.
• Izvorni kod – pregledajte i doprinesite na GitHub.
• NuGet – paket je objavljen kao Aspose.3D.Converter na NuGet-u.

Uobičajeni slučajevi upotrebe

Evo nekoliko praktičnih scenarija u kojima se Aspose.3D FOSS za .NET odlično uklapa:

Tokovi konverzije formata

Mnogi timovi primaju 3D resurse u jednom formatu, ali im je potreban drugi. Dizajnerski tim može raditi u FBX formatu, dok web tim treba glTF. Biblioteka vam omogućava da izgradite automatizovane tokove konverzije:

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

// Convert all incoming FBX assets to GLB for the web team
var scene = new Scene();
scene.Open("asset.fbx");

scene.Save("asset.glb");

3D Model Inspection and Validation

Pre nego što integrišete 3D resurs u vašu aplikaciju, možda ćete želeti da validirate njegov sadržaj — proverom broja čvorova, verifikacijom geometrije ili potvrđivanjem da su očekivani elementi prisutni:

using Aspose.ThreeD;
using Aspose.ThreeD.Entities;

var scene = new Scene();
scene.Open("model.obj");

int nodeCount = scene.RootNode.ChildNodes.Count;
Console.WriteLine("Top-level nodes: " + nodeCount);

foreach (var child in scene.RootNode.ChildNodes)
{
    if (child.Entity is Mesh mesh)
    {
        Console.WriteLine(child.Name + ": "
            + mesh.ControlPoints.Count + " vertices");
    }
}

Sastavljanje scene

Možete učitati više modela i kombinovati ih u jedinstvenu scenu:

using Aspose.ThreeD;

var scene = new Scene();

var part1 = new Scene();
part1.Open("chassis.obj");

var part2 = new Scene();
part2.Open("wheels.obj");

// Add nodes from each part into the combined scene
foreach (var child in part1.RootNode.ChildNodes)
{
    scene.RootNode.ChildNodes.Add(child);
}
foreach (var child in part2.RootNode.ChildNodes)
{
    scene.RootNode.ChildNodes.Add(child);
}

scene.Save("assembled.gltf");

Šta sledi

U narednim objavama, pokrićemo:

• Detaljno istraživanje ključnih funkcija scene-graph API-ja, materijala i matematičkih alata.
• Praktični vodič za rad sa svakim podržanim 3D formatom — OBJ, STL, glTF, FBX i 3MF — uključujući opcije učitavanja/čuvanja i obrasce grupne konverzije.

Ostanite u toku i slobodno istražite biblioteku i podelite svoje povratne informacije na GitHub-u.