Hoe te beginnen met Aspose.3D FOSS voor .NET

Aspose.3D FOSS voor .NET is een gratis, MIT-licentieerde bibliotheek voor het opladen, manipuleren en besparen van 3D-bestanden - geen inheemse binaire vereiste, pure C# van NuGet.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

Installeer vanaf NuGet (.NET 10.0 of later vereist):

dotnet add package Aspose.3D --version 26.1.0

Controleer de installatie correct geladen:

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

Stap 2: Import van vereiste naamruimten

Import de naamruimten voor het podium en format klassen:

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

Hoe laad ik een 3D-bestand?

Gebruik Scene.Open() om alle ondersteunde formaten te laden. de bibliotheek detecteert het format automatisch uit de bestanduitbreiding:

using Aspose.ThreeD;

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

Of gebruik de statische fabrieksmethode:

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

Hoe doorloop ik de scene graph?

Een opgeladen scène is een boom van Node De voorwerpen die in 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);

Stap 3: Sla op naar het doelformaat

Gebruik Scene.Save() om te exporteren naar een ondersteunde outputformat. de bibliotheek detecteert de Uitgangsformaat van de bestanduitbreiding:

using Aspose.ThreeD;

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

Veelvoorkomende problemen en oplossingen

FileNotFoundException Wanneer het roepen Scene.Open() De weg die je hebt doorbracht bestaat niet of gebruikt de verkeerde scheider. gebruik een absolute route of Path.Combine() Om ervoor te zorgen dat de bestandpad correct is.

UnsupportedOperationException Voor bepaalde methoden Sommige methoden (scene rendering, watermarking) zijn niet beschikbaar in de FOSS-editie. Controleer de beperkingendocumentatie voordat u geavanceerde functies gebruikt.

Onbekende formatenfouten Zorg dat de bestanduitbreiding overeenkomt met het werkelijke formaat.De bibliotheek detecteert format door: Uitbreiding voor Scene.Open() en Scene.FromFile().Geef een uitdrukkelijke FileFormat Parameters om de detectie te override.

Vakantie scene na loading Sommige binaire formaten kunnen specifieke ladingopties vereisen. probeer de uitdrukkelijke overbelasting te gebruiken met ObjLoadOptions of GltfLoadOptions als de standaardloade een leeg scène produceert.

Veelgestelde vragen

Heeft Aspose.3D FOSS Microsoft Office of een van de inheemse DLL’s nodig?

De bibliotheek is pure C# met geen inheemse afhankelijkheden of externe binariën vereist.

Welke .NET-versies zijn ondersteund?

.NET 10.0 of later.De bibliotheek loopt op Windows, macOS, Linux en Docker containers.

Is de bibliotheek gratis voor commerciële gebruik?

U kunt het gebruiken, wijzigen en redistribueren voor elk doel, inclusief commerciële toepassingen.

Welke 3D-formaat kan ik lezen en schrijven?

De bibliotheek ondersteunt OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA en 3MF voor beide. lezen en schrijven. PLY is alleen geïmporteerd. gebruik FileFormat.GetFormatByExtension() om te Vraag ondersteunde formaten in runtime.

Kan ik een 3D-scène maken van scratch?

Ja, bouw een Scene zonder argumenten, voeg de kindernodes toe aan scene.RootNode, en op het gewenste formaat.