Sådan starter du med Aspose.3D FOSS til .NET
Aspose.3D FOSS for .NET er et gratis, MIT-licenseret bibliotek til indlæsning, manipulation og gemme 3D-filer – ingen native binære filer kræves, rent C# fra NuGet.
Step-by-step guide til dig
Trin 1: Installer pakken
Installation fra NuGet (.NET 10.0 eller nyere er påkrævet):
dotnet add package Aspose.3D --version 26.1.0Kontroller, at installationen er korrekt indlæst:
using Aspose.ThreeD;
Console.WriteLine("Aspose.3D loaded.");Trin 2: Importér navnerum
Importer navneområder for scenen og formatklasser:
using Aspose.ThreeD;
using Aspose.ThreeD.Formats;API-reference
Brug af Scene.Open() at indlæse et understøttet format. Biblioteket registrerer det automatisk fra filtypen:
using Aspose.ThreeD;
var scene = new Scene();
scene.Open("model.obj");
Console.WriteLine($"Loaded scene with root node: {scene.RootNode.Name}");Eller brug den statiske fabrik metode:
var scene = Scene.FromFile("model.glb");Trin 4: Gå gennem scenen graf
En skærm er et træ af Node Objekter, der er indlejret i 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);Trin 3: Gem til målformatet
Brug af Scene.Save() eksporteres til ethvert understøttet outputformat. Biblioteket registrerer Udgangsformat fra filtypen:
using Aspose.ThreeD;
var scene = Scene.FromFile("model.obj");
scene.Save("output.glb");
Console.WriteLine("Saved as GLB.");Almindelige problemer og rettelser
FileNotFoundException Når man ringer Scene.Open() Den vej, du har passeret, eksisterer ikke eller bruger den forkerte separator. Brug en absolut vej eller Path.Combine() Det er vigtigt at sikre, at filen er korrekt.
UnsupportedOperationException For visse metoder Nogle metoder (scene rendering, vandmærkning) er ikke tilgængelige i FOSS-udgaven. Tjek begrænsningsdokumentationen, før du bruger avancerede funktioner.
Ukendt formatfejl Sørg for, at filtypen matcher det faktiske format. Biblioteket registrerer formatet ved hjælp af Udvidelse af Scene.Open() og Scene.FromFile().Giv en udtrykkelig FileFormat Parametre til at overvinde detektion.
Større skærm efter indlæggelse Nogle binære formater kan kræve specifikke belastningsindstillinger. Prøv at bruge den eksplicitte overbelastning med ObjLoadOptions eller GltfLoadOptions Hvis standardindlæsningen producerer en tom scene.
Ofte stillede spørgsmål
Kræver DLL-DOS.NET Microsoft Office eller nogen af de indfødte Dll’er?
Biblioteket er rent C# uden brug af indfødte afhængigheder eller eksterne binære værdier.
Hvilke .NET-versioner understøttes?
.NET 10.0 eller nyere. Biblioteket kører på Windows, macOS, Linux og Docker-containere.
Er biblioteket gratis til kommerciel brug?
Den er udgivet under MIT License. Du kan bruge, ændre og omdistribuere den til ethvert formål, herunder kommercielle applikationer.
Hvilke 3D-formater kan jeg læse og skrive?
Biblioteket understøtter OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA og 3MF for begge. Læs og skriv. PLY er kun import-bare. Brug FileFormat.GetFormatByExtension() To af Formater, der understøttes af query på runtime.
Kan jeg oprette en 3D-scene fra bunden?
Bygning A Scene uden argumenter, tilføje børnenoder til scene.RootNode,og gemme til det ønskede format.