Kaip pradėti su Aspose.3D FOSS .NET

Aspose.3D FOSS .NET yra nemokama, MIT licencija biblioteka 3D failams atsisiųsti, manipuliuoti ir išsaugoti – jokių kilmės binarų nereikia, grynas C# iš NuGet.

Žingsnis po žingsnio vadovėlis

1 žingsnis: įdiegti pakuotę

Įdiegti iš NuGet (.NET 10.0 arba naujesnė reikalaujama):

dotnet add package Aspose.3D --version 26.1.0

Įsitikinkite, kad įrenginys yra teisingai įkrautas:

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

2 žingsnis: Reikalingų pavadinimų importuojimas

Importuoti scenos ir formatų klasės pavadinimų erdvę:

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

3 žingsnis: įkeliate 3D failą

Naudojimas Scene.Open() bet kokio palaikomo formato įkrovimas. biblioteka atpažįsta formatą Automatinis iš failų plėtinės:

using Aspose.ThreeD;

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

Naudokite statinį gamyklos metodą:

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

4 žingsnis: peržengti sceną grafikas

Sklypas yra medžio Node Objektas, įsikūręs 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);

5 žingsnis: išsaugoti į kitą formatą

Naudojimas Scene.Save() eksportuoti į bet kurį remiamą išleidimo formatą. biblioteka atpažįsta, kad Išleidimo formatas iš failų plėtinės:

using Aspose.ThreeD;

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

Bendros problemos ir fiksacijos

FileNotFoundException Kai skambina Scene.Open() Kelias, kurį praeinate, neegzistuoja arba naudoja neteisingą atskyrėją. Path.Combine() užtikrinti, kad failo maršrutas būtų teisingas.

UnsupportedOperationException Tam tikrų metodų Kai kurie metodai (scenos atranka, vandens ženklinimas) nėra prieinami FOSS leidinyje. Peržiūrėkite apribojimų dokumentaciją prieš naudodami pažangias funkcijas.

Nežinomas formato klaidas Įsitikinkite, kad failų plėtinė atitinka tikrąjį formatą. biblioteka atpažįsta formatus pagal Išplėstinė už Scene.Open() ir Scene.FromFile().Pasakykite aiškiai FileFormat Parametras, kad pernelyg didelis aptikimas.

Laisva scena po įkrovimo Kai kuriems binariniams formatams gali prireikti konkrečių apkrovos variantų. pabandykite naudoti aiškią perkaitą su ObjLoadOptions arba GltfLoadOptions jei numatytoji apkrova sukelia tuščią scenos.

Dažnai užduodami klausimai

Ar „Aspose.3D FOSS“ reikalauja „Microsoft Office“ ar bet kokių gimtojo DLL?

Biblioteka yra grynai C#, be gimtojo priklausomybės ar išorinių binarių.

Kokios .NET versijos yra palaikomos?

.NET 10.0 arba vėliau. biblioteka veikia Windows, macOS, Linux ir Docker konteineriuose.

Ar biblioteka yra nemokama komercinio naudojimo tikslais?

Taip. Jis išleistas pagal MIT licenciją. galite jį naudoti, modifikuoti ir perparduoti bet kokiu tikslu, įskaitant komercinę programą.

Kokius 3D formatus galiu skaityti ir rašyti?

Biblioteka palaiko OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA ir 3MF tiek Skaityti ir rašyti. PLY yra importuojamas tik. Naudokite FileFormat.GetFormatByExtension() Į Užklausos palaikomi formatiškai darbo metu.

Ar galiu sukurti 3D scenos iš skraidančio?

Konstrukcija A Scene be jokių argumentų, pridėkite vaiko mazgai į scene.RootNode,ir Išsaugokite pageidaujamą formą.