Rozpoczęcie

Rozpoczęcie pracy z Aspose.3D FOSS dla .NET

Witamy w Aspose.3D, darmowa, otwarto‑źródłowa biblioteka .NET do ładowania, budowania i eksportowania scen 3D. Ten przewodnik poprowadzi Cię od świeżego środowiska do działającej sceny w ciągu kilku minut.

Wymagania wstępne

WymaganiaSzczegóły
.NET SDK.NET 10.0 lub nowszy
IDEVisual Studio 2022+, Rider lub VS Code z rozszerzeniem C#
OSWindows, macOS lub Linux
Menedżer pakietówNuGet (dołączony do SDK .NET)

Instalacja

  1. Utwórz lub otwórz projekt .NET:
dotnet new console -n My3DApp
cd My3DApp
  1. Dodaj pakiet NuGet:
dotnet add package Aspose.3D --version 26.1.0
  1. Sprawdź, czy odwołanie się kompiluje:
using Aspose.ThreeD;

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

Zobacz Przewodnik instalacji po więcej szczegółów na temat konfiguracji projektu i weryfikacji.

Co możesz zrobić

Po zainstalowaniu możesz od razu:

  • Załaduj pliki OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY i 3MF za pomocą Scene.Open()
  • Sprawdź hierarchie scen: przeglądaj Node drzewa, odczytuj Mesh geometrię, uzyskaj dostęp do normalnych wierzchołków i UV
  • Przekształć węzły: ustaw Translation, Rotation (przez Quaternion), oraz Scale przez Transform klasa
  • Zastosuj materiały: przypisz LambertMaterial, PhongMaterial, lub PbrMaterial do węzłów
  • Eksportuj do dowolnego obsługiwanego formatu z ustawieniami per-format SaveOptions
  • Zbuduj geometrię: utwórz Box, Sphere, i Cylinder prymitywy i konwertować je na Mesh przez ToMesh()

Szybki start

Wczytaj plik 3D, wyświetl hierarchię sceny i ponownie zapisz w formacie GLB:

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");

Kolejne kroki

 Polski