Cum să începi cu Aspose.3D FOSS pentru .NET

Aspose.3D FOSS pentru .NET este o bibliotecă gratuită, licențiată de MIT pentru încărcarea, manipularea și salvarea fișierelor 3D – nu sunt necesare binare native, pur C# din NuGet.

Ghid pas cu pas

Pasul 1: Instalați pachetul

Instalarea din NuGet (necesitatea de .NET 10.0 sau mai târziu):

dotnet add package Aspose.3D --version 26.1.0

Verificați instalarea încărcată corect:

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

Pasul 2: Importă spațiile de nume

Importarea spațiilor de nume pentru scena și formate clasele:

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

Pasul 3: Încărcați un fișier 3D

Utilizarea Scene.Open() pentru a încărca orice format susținut. bibliotecă detectează formatul automat din extinderea fișierului:

using Aspose.ThreeD;

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

Folosește metoda statică de fabricație:

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

Pasul 4: Întoarceți graficul de scenă

Un scenă încărcată este un copac de Node Obiectele înrădăcinate de 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);

Pasul 3: Salvează în formatul țintă

Utilizarea Scene.Save() pentru a exporta la orice format de ieșire susținut. biblioteca detectează Formatul de ieșire din extinderea fișierului:

using Aspose.ThreeD;

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

Probleme comune și soluții

FileNotFoundException Când sună Scene.Open() Calea pe care o treceți nu există sau foloseste separatorul greșit. Path.Combine() Pentru a se asigura că ruta de fișier este corectă.

UnsupportedOperationException Pentru anumite metode Unele metode (renderare scenă, marcare de apă) nu sunt disponibile în ediția FOSS. Verificați documentația limitărilor înainte de a utiliza caracteristicile avansate.

Erori de format necunoscute Asigurați-vă că extinderea fișierului se potrivește cu formatul real. biblioteca detectează format prin extinderea pentru Scene.Open() şi Scene.FromFile().- să treacă explicit FileFormat Parametru pentru a depăşi detecţia.

Scena goală după încărcare Unele formate binare pot necesita opțiuni specifice de încărcare. încercați să utilizați o supraîncărcătură explicită Cu ObjLoadOptions sau GltfLoadOptions dacă încărcătura de bază produce o scenă goală.

Întrebări frecvente

Aspose.3D FOSS necesită Microsoft Office sau orice DLL native?

Nu. Biblioteca este pură C# cu nici dependențe native sau binare externe necesare.

Ce versiuni .NET sunt susținute?

.NET 10.0 sau mai târziu. biblioteca funcționează pe containere Windows, macOS, Linux și Docker.

Este biblioteca liberă pentru utilizare comercială?

Este eliberat în temeiul licenței MIT. Puteți să-l utilizați, să modificați și să o redistribuiți pentru orice scop, inclusiv aplicații comerciale.

Ce formate 3D pot citi și scrie?

Biblioteca susține OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA și 3MF pentru ambele Citeste si scrie. PLY este doar import-utilizare FileFormat.GetFormatByExtension() pentru Formate de întrebare suportate în timp lucrător.

Pot crea o scenă 3D din scratch?

Construcţia a Scene fără argumente, adăugați noduri pentru copii la scene.RootNode, şi salvare în formatul dorit.