Com començar amb Aspose.3D FOSS per a .NET
Aspose.3D FOSS per a .NET és una biblioteca gratuïta, llicenciada pel MIT per carregar, manipular i salvar arxius 3D - no requereixen binaris nadius, pur C# de NuGet.
Guia de pas a pas
Pas 1: Instal·la el paquet
Instal·lació de la plataforma NuGet (necessària .NET 10.0 o posterior):
dotnet add package Aspose.3D --version 26.1.0Verifica la instal·lació carregada correctament:
using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");Pas 2: Importar espais de nom necessaris
Importar els espais de nom per a l’escena i classes de format:
using Aspose.ThreeD;
using Aspose.ThreeD.Formats;Pas 3: Carregar un fitxer 3D
Utilitzar Scene.Open() per carregar qualsevol format recolzat. la biblioteca detecta el format automàticament de l’extenssió del fitxer:
using Aspose.ThreeD;
var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");Utilitza el mètode d’estació:
var scene = Scene.FromFile("model.glb");Pas 4: Travessar el gràfic de l’escena
Una escena carregada és un arbre de Node Els objectes que es corren a 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);Pas 5: Salvar a un format diferent
Utilitzar Scene.Save() per exportar a qualsevol format de sortida suportat. la biblioteca detecta el Format de sortida de l’extenssió del fitxer:
using Aspose.ThreeD;
var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");Problemes comuns i fixos
FileNotFoundException Quan crida Scene.Open() El camí que has passat no existeix o utilitza el separador equivocat. Path.Combine() Per assegurar-se que el camí de fitxer és correcte.
UnsupportedOperationException Per certes mètodes Alguns mètodes (rendering d’escena, marcatge d’aigua) no estan disponibles en l’edició FOSS. Consulteu la documentació de limitacions abans d’utilitzar característiques avançades.
Error de format desconegut Assegureu-vos que l’extenssió de fitxer coincideix amb el format real. La biblioteca detecta el format per Extensions per Scene.Open() i Scene.FromFile().Passar una explicació FileFormat Paràmetres per a la detecció.
Escena buit després de la càrrega Alguns formats binaris poden requerir opcions de càrrega específiques. tractar utilitzant la sobrecarga explícita amb ObjLoadOptions o GltfLoadOptions Si la càrrega de default produeix una escena buida.
Preguntes freqüents
Aspose.3D FOSS requereix Microsoft Office o qualsevol DLL nativa?
No. La biblioteca és pura C# amb cap dependència nativa o binàries externes necessàries.
Quines versions de .NET estan supportades?
.NET 10.0 o posterior. La biblioteca funciona en els contenidors de Windows, macOS, Linux i Docker.
La biblioteca és lliure per a ús comercial?
Sí. Es publica sota la Llicència MIT. Pot utilitzar, modificar i redistribuir-la per a qualsevol propòsit, incloses les aplicacions comercials.
Quins formats 3D puc llegir i escriure?
La biblioteca dóna suport a OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i 3MF per a tots dos. Llegir i escriure. PLY és només importat. Utilitzar FileFormat.GetFormatByExtension() a la Query format suportat en el temps de treball.
Puc crear una escena 3D de la fusta?
Són: Construïm un Scene sense cap argument, afegir nodes infantils a scene.RootNode,i Es pot guardar al format desitjat.