Erste Schritte

Erste Schritte mit Aspose.3D FOSS für .NET

Willkommen bei Aspose.3D, eine kostenlose, Open-Source .NET Bibliothek zum Laden, Erstellen und Exportieren von 3D‑Szenen. Dieser Leitfaden führt Sie von einer frischen Umgebung zu einer funktionierenden Szene in wenigen Minuten.

Voraussetzungen

AnforderungDetail
.NET SDK.NET 10.0 oder neuer
IDEVisual Studio 2022+, Rider oder VS Code mit C#‑Erweiterung
OSWindows, macOS oder Linux
PaketmanagerNuGet (enthalten im .NET SDK)

Installation

  1. Erstellen oder öffnen Sie ein .NET-Projekt:
dotnet new console -n My3DApp
cd My3DApp
  1. Fügen Sie das NuGet-Paket hinzu:
dotnet add package Aspose.3D --version 26.1.0
  1. Überprüfen Sie, ob die Referenz kompiliert:
using Aspose.ThreeD;

var scene = new Scene();
Console.WriteLine("Aspose.3D loaded successfully.");
dotnet run

Siehe die Installationsanleitung für weitere Details zur Projektkonfiguration und -verifizierung.

Was Sie tun können

Nach der Installation können Sie sofort:

  • Laden OBJ-, STL-, glTF 2.0 / GLB-, FBX-, COLLADA-, PLY- und 3MF-Dateien über Scene.Open()
  • Untersuchen Szenenhierarchien: durchlaufen Node Bäume, auslesen Mesh Geometrie, Zugriff auf Scheitelnormale und UVs
  • Transformieren Knoten: setzen Translation, Rotation (über Quaternion), und Scale durch das Transform Klasse
  • Materialien anwenden: zuweisen LambertMaterial, PhongMaterial, oder PbrMaterial zu Knoten
  • Exportieren in jedes unterstützte Format mit pro-Format SaveOptions
  • Geometrie erstellen: erstellen Box, Sphere, und Cylinder Primitive und konvertiere sie zu Mesh über ToMesh()

Schnellstart

Lade eine 3D-Datei, gib die Szenenhierarchie aus und speichere sie erneut im GLB-Format:

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("input.obj");

Console.WriteLine($"Root children: {scene.RootNode.ChildNodes.Count}");
foreach (var node in scene.RootNode.ChildNodes)
{
    var entityType = node.Entity?.GetType().Name ?? "no entity";
    Console.WriteLine($"  {node.Name} [{entityType}]");
}

scene.Save("output.glb");
Console.WriteLine("Saved output.glb");

Nächste Schritte

 Deutsch