Miten aloittaa Aspose.3D FOSS .NET: lle

Aspose.3D FOSS for .NET on MIT-lisensoitu ilmainen kirjasto 3D-tiedostojen lataamiseen, manipulointiin ja tallentamiseen – ei tarvita alkuperäisiä binäärejä, puhdasta C#:ta NuGet.

Vaiheittainen opas

Vaihe 1: Asenna paketti

Asenna NuGet (vaaditaan .NET 10.0 tai uudempi):

dotnet add package Aspose.3D --version 26.1.0

Tarkista, että asennus on ladattu oikein:

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

Vaihe 2: Vaaditut nimipaikat tuodaan

Importoi kohtauksen ja muotoiluluokkien nimipaikat:

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

Vaihe 3: Lataa 3D-tiedosto

Käytä Scene.Open() Voit ladata minkä tahansa tuetun muodon. Kirjasto havaitsee muodostuksen automaattisesti tiedoston laajennuksesta:

using Aspose.ThreeD;

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

Käytä myös staattista tehdasmenetelmää:

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

Vaihe 4: Ylitä kohtausgrafiikka

Puu on laaja näyttämö, jossa Node esineitä, jotka on asetettu 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);

Vaihe 3: Tallenna kohdeformaattiin

Käytä Scene.Save() Voit viedä tuettuun tulostusmuotoon. Kirjasto havaitsee Tiedostojen laajennuksen tulostusmuoto:

using Aspose.ThreeD;

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

Yleisiä ongelmia ja korjauksia

FileNotFoundException Kun soitat Scene.Open() polku ei ole olemassa tai käyttää väärää erottelulaitetta. Käytä absoluuttista polkua tai Path.Combine() Varmista, että tiedostojen polku on oikea.

UnsupportedOperationException Tietyillä menetelmillä Jotkin menetelmät (näyttämö, vesimerkintä) eivät ole käytettävissä FOSS -versiossa. Tarkista rajoitukset ennen kehittyneiden ominaisuuksien käyttöä.

Tuntematon muotoiluvirhe Varmista, että tiedostopääte vastaa todellista muotoa. Kirjasto tunnistaa muodonmuodostuksen Laajennusta varten Scene.Open() ja Scene.FromFile().- antaa selkeän FileFormat Parametrit, jotka ohittavat havaitsemisen.

Tyhjä kohtaus latauksen jälkeen Jotkut binäärimuodot saattavat vaatia erityisiä latausvaihtoehtoja. Yritä käyttää nimenomaista ylikuormitusta kanssa ObjLoadOptions tai GltfLoadOptions Jos oletusarvoinen kuorma tuottaa tyhjän kohtauksen.

Usein kysytyt kysymykset

Tarvitseeko DLL-tiedostoja Microsoft Office tai muita alkuperäisiä Dll-osoitteita?

Kirjasto on puhdas C#, eikä siihen tarvita natiivisia riippuvuuksia tai ulkoisia binäärejä.

Mitä .NET-versioita tuetaan?

.NET 10.0 tai uudempi. Kirjasto toimii Windows, macOS ja Docker sisältävissä pakkauksissa.

Onko kirjasto vapaa kaupalliseen käyttöön?

Kyllä. Se on julkaistu MIT-lisenssin alaisuudessa. Voit käyttää, muokata ja levittää sitä mihin tahansa tarkoitukseen, mukaan lukien kaupalliset sovellukset.

Millaisia 3D-muotoja voin lukea ja kirjoittaa?

Kirjasto tukee OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA ja 3MF molemmille lukeminen ja kirjoittaminen. PLY on tuonti-vain. Käytä FileFormat.GetFormatByExtension() 2 Tyyppi Pyyntöjen muodostaminen runtime-tilassa.

Voinko luoda 3D-näytelmän tyhjästä?

Rakenna a Scene ilman argumentteja, lisää lapsen solmuja scene.RootNode,ja tallentaa haluttuun muotoon.