Jak zacząć z Aspose.3D FOSS dla .NET

Aspose.3D FOSS dla .NET to darmowa, licencjonowana biblioteka MIT do ładowania, manipulacji i oszczędzania plików 3D – nie wymagane są native binary, czysty C# od NuGet.

Przewodnik krok po kroku

Krok 1: Instalacja pakietu

Instalacja z NuGet (wymagane .NET 10.0 lub nowsze):

dotnet add package Aspose.3D --version 26.1.0

Sprawdź, czy instalacja jest prawidłowo ładowana:

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

Krok 2: Wprowadzenie wymaganych przestrzeni nazwowych

Importowanie nazwisk dla sceny i formatu klas:

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

Krok 3: Pobierz plik 3D

Używanie Scene.Open() do pobierania dowolnego obsługiwanego formatu. biblioteka wykrywa format automatycznie z rozszerzenia pliku:

using Aspose.ThreeD;

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

Użyj statycznej metody fabrycznej:

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

Krok 4: Przejdź przez scenę grafiki

„Przemocny sceną jest drzewo Node Obiekty z korzeniami w 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);

Krok 5: Zapisz do innego formatu

Używanie Scene.Save() do eksportu do dowolnego obsługiwanego formatu wyjścia. biblioteka wykrywa Format wyjścia z rozszerzenia pliku:

using Aspose.ThreeD;

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

Wspólne problemy i rozwiązania

FileNotFoundException Kiedy zadzwonić Scene.Open() Droga, którą przeszedłeś nie istnieje lub używa błędnego oddzielnika. Path.Combine() Aby upewnić się, że droga do pliku jest poprawna.

UnsupportedOperationException W przypadku niektórych metod Niektóre metody (renderowanie scen, woda) nie są dostępne w edycji FOSS. Sprawdź dokumentację ograniczeń przed użyciem zaawansowanych funkcji.

Nieznany błąd formatowy Upewnij się, że rozszerzenie pliku odpowiada rzeczywistemu formatowi. biblioteka wykrywa format przez Rozszerzenie dla Scene.Open() i Scene.FromFile().Przejdź do wyjaśnienia FileFormat parametry do wykrywania.

Puste miejsce po ładowaniu Niektóre formaty binarne mogą wymagać konkretnych opcji ładowania. spróbuj używać wyraźnego nadładunku z ObjLoadOptions lub GltfLoadOptions Jeśli domyślne obciążenie powoduje pustą scenę.

Często zadawane pytania

Czy Aspose.3D FOSS wymaga Microsoft Office lub jakichkolwiek native DLL?

Biblioteka jest czysta C# z żadnymi domowymi uzależnieniami ani zewnętrznymi binary nie wymagane.

Jakie wersje .NET są obsługiwane?

.Biblioteka działa na kontenerach Windows, macOS, Linux i Docker.

Czy biblioteka jest wolna do użytku komercyjnego?

Jest on wydany na podstawie licencji MIT. Możesz używać, modyfikować i redistribuować go do jakiegokolwiek celu, w tym aplikacji komercyjnych.

Jakie formaty 3D można czytać i pisać?

Biblioteka obsługuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA i 3MF dla obu czytanie i pisanie. PLY jest tylko importowane. użyj FileFormat.GetFormatByExtension() do Formaty obsługiwane w czasie pracy.

Czy mogę stworzyć scenę 3D z scratch?

Konstrukcja A Scene bez argumentów, dodaj dziecięce węzły do scene.RootNode,i Wystarczy przechowywać w pożądanej formie.