Hur man börjar med Aspose.3D FOSS för .NET

Hur man börjar med Aspose.3D FOSS för .NET

Aspose.3D FOSS för .NET är en gratis, MIT-licensierad bibliotek för laddning, manipulering och sparar 3D-filer – inga inhemska binärer krävs, ren C# från NuGet.

Steg för steg guide

Steg 1: Installera paketet

Installera från NuGet (.NET 10.0 eller senare krävs):

dotnet add package Aspose.3D --version 26.1.0

Kontrollera installationen laddas korrekt:

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

Steg 2: Import av nödvändiga namnutrymmen

Import namngräntorna för scenen och format klasser:

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

Steg 3: Ladda upp en 3D-fil

Användning Scene.Open() ladda alla stödda format. biblioteket upptäcker formatet automatiskt från filändelsen:

using Aspose.ThreeD;

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

Använd statisk fabrik metod:

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

Steg 4: Överträda scenen grafen

En laddad scen är ett träd av Node föremål som är rötta 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);

Steg 5: Spara till ett annat format

Användning Scene.Save() för export till alla stödda utgångsformat. biblioteket upptäcker Utgångsformat från filändelsen:

using Aspose.ThreeD;

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

Vanliga problem och fixar

FileNotFoundException När ringer Scene.Open() Vägen du passerade finns inte eller använder fel separator. Använd en absolut väg eller Path.Combine() För att säkerställa att filvägen är korrekt.

UnsupportedOperationException För vissa metoder Vissa metoder (scene rendering, vattenmärkning) är inte tillgängliga i FOSS-utgåvan. Kontrollera begränsningsdokumentationen innan du använder avancerade funktioner.

Okänd formatfel Se till att filändelsen matchar det faktiska formatet. biblioteket upptäcker format genom förlängning för Scene.Open() och Scene.FromFile().Passera ett explicit FileFormat Parameter för att överdriva detektion.

tom scen efter laddning Vissa binära format kan kräva specifika laddningsalternativ. försök att använda den uttryckliga överbelastningen med ObjLoadOptions eller GltfLoadOptions om standardbelastningen ger en tom scen.

Ofta ställda frågor

Behöver Aspose.3D FOSS Microsoft Office eller någon DLL?

Biblioteket är ren C# med inga inhemska beroende eller externa binärer krävs.

Vilka .NET-versioner stöds?

.NET 10.0 eller senare. biblioteket körs på Windows, macOS, Linux och Docker-behållare.

Är biblioteket gratis för kommersiellt bruk?

Det släpps under MIT-licensen. Du kan använda, modifiera och omfördelar det för alla ändamål, inklusive kommersiella applikationer.

Vilka 3D-format kan jag läsa och skriva?

Biblioteket stöder OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA och 3MF för båda. Läs och skriv. PLY är endast import-användning FileFormat.GetFormatByExtension() till Fråga stöds format i löptid.

Kan jag skapa en 3D-scena från scratch?

Ja, bygg A Scene utan argument, lägg till barn noder för att scene.RootNode,och Spara i önskad format.

Se även

 Svenska