Wie man mit Aspose.3D FOSS für .NET beginnt

Aspose.3D FOSS für .NET ist eine kostenlose, MIT-Lizenzbibliothek für die Laden, Manipulation und Speicherung von 3D-Filen – keine native binären erforderlich, reine C# von NuGet.

Schritt für Schritt Guide

Schritt 1: Paket installieren

Installation von NuGet (.NET 10.0 oder höher erforderlich):

dotnet add package Aspose.3D --version 26.1.0

Überprüfen Sie die installierte korrekt geladen:

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

Schritt 2: Import erforderlichen Namenspazierungen

Importieren Sie die Namenspände für die Szene und Formatklassen:

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

Schritt 3: Laden Sie eine 3D-Datei herunter

Gebrauch Scene.Open() um alle unterstützten Formate zu laden. Die Bibliothek erkennt das Format automatisch aus der Dateierweiterung:

using Aspose.ThreeD;

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

Oder verwenden Sie die statische Fabrik:

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

Schritt 4: Überqueren Sie den Scene Graph

Eine beladenen Szene ist ein Baum von Node Objekte, die in den 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);

Schritt 3: In das Zielformat speichern

Gebrauch Scene.Save() für den Export in jedes unterstützte Ausgangsformat. Die Bibliothek erkennt die Ausgangsformat aus der Dateierweiterung:

using Aspose.ThreeD;

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

Häufige Probleme und Lösungen

FileNotFoundException Wenn Sie rufen Scene.Open() Der Weg, den Sie durchlaufen, existiert nicht oder verwendet den falschen Separator. Path.Combine() Um sicherzustellen, dass die Datei-Path korrekt ist.

UnsupportedOperationException Für bestimmte Methoden Einige Methoden (Szenen rendering, watermarking) sind nicht in der FOSS-Edition verfügbar. Überprüfen Sie die Dokumentation der Einschränkungen, bevor Sie fortgeschrittene Funktionen verwenden.

Unbekannte Formatfehler Sicherstellen, dass die Datei-Erweiterung dem tatsächlichen Format entspricht. Die Bibliothek erkennt das Format durch Erweiterung für Scene.Open() und Scene.FromFile().Geben Sie eine explicite FileFormat Parameter zur Überride der Erkennung.

Leere Szenen nach dem Laden Einige binäre Formate können spezifische Ladungsoptionen benötigen. versuchen Sie, die explicite Überlastung zu verwenden mit ObjLoadOptions oder GltfLoadOptions wenn die Standardlast eine leere Szenen erzeugt.

Häufig gestellte Fragen

Braucht Aspose.3D FOSS Microsoft Office oder alle native DLLs?

Die Bibliothek ist rein C# mit keine innigen Abhängigkeiten oder externe Binären erforderlich.

Welche .NET-Versionen werden unterstützt?

.NET 10.0 oder später. Die Bibliothek läuft auf Windows, macOS, Linux und Docker-Kontinern.

Ist die Bibliothek für kommerzielle Nutzung frei?

Sie können es für jeden Zweck verwenden, modifizieren und umverteilen, einschließlich kommerzieller Anwendungen.

Welche 3D-Formate kann ich lesen und schreiben?

Die Bibliothek unterstützt OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA und 3MF für beide. Lesen und schreiben. PLY ist nur importiert. FileFormat.GetFormatByExtension() zu Query unterstützt Format in Runtime.

Kann ich eine 3D-Szenen aus Schrauben erstellen?

Konstruktion A Scene ohne Argumente, fügen Sie Kindernoten zu scene.RootNode,und auf das gewünschte Format.