Jak začít s Aspose.3D FOSS pro .NET

Aspose.3D FOSS pro .NET je bezplatná knihovna s licencí MIT pro načítání, manipulaci a ukládání 3D souborů žádné nativní bináře nejsou nutné, čisté C # od NuGet.

Krok za krokem

Krok 1: Nainstalujte balíček

Instalace z NuGet (.NET 10.0 nebo novější požadovaná):

dotnet add package Aspose.3D --version 26.1.0

Ověřte, zda je instalace správně načtená:

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

Krok 2: Import požadovaných jmenových prostorů

Importem jmenových prostor pro třídy scény a formátu:

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

Krok 3: Nahrát 3D soubor

Použití: Scene.Open() k načtení jakéhokoli podporovaného formátu. Knihovna detekuje formát automaticky z rozšíření souboru:

using Aspose.ThreeD;

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

Nebo použijte statickou továrnu:

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

Krok 4: Projděte grafický graf scény

Nabitá scéna je stromem… Node objekty zakořeněné v 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: Uložit do jiného formátu

Použití: Scene.Save() knihovna detekuje soubor dat, který je v systému. Výstupní formát z rozšíření souboru:

using Aspose.ThreeD;

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

Obvyklé problémy a řešení

FileNotFoundException při volání Scene.Open() Cesta, kterou jste prošli neexistuje nebo používá špatný oddělující znak. Použijte absolutní cestu nebo Path.Combine() zajistit správnou cestu souboru.

UnsupportedOperationException pro některé metody Některé metody (rendering scén, vodní značky) nejsou k dispozici v vydání FOSS. Před použitím pokročilých funkcí zkontrolujte dokumentaci o omezeních.

Neznámý formát chybějícího nastavení . Ujistěte se, že rozšíření souboru odpovídá skutečnému formátu. Knihovna detekuje formát pomocí prodloužení platnosti pro Scene.Open() a) Scene.FromFile().- Přejít jasný. FileFormat parametry pro přehled detekce.

Prázdná scéna po načtení Některé binární formáty mohou vyžadovat specifické možnosti načítání. Zkuste použít explicitní přetížení s: ObjLoadOptions nebo: GltfLoadOptions pokud při výchozím zatížení vznikne prázdná scéna.

Časté otázky

Vyžaduje Aspose.3D FOSS Microsoft Office nebo nějaké nativní DLL?

Knihovna je čistá C# bez nativních závislostí nebo externích binárek.

Které verze .NET jsou podporovány?

.NET 10.0 nebo novější. Knihovna běží na Windows, macOS, Linux a Docker kontejnery.

Je knihovna volná pro komerční použití?

Ano, je vydán pod licencí MIT. Můžete jej používat, upravovat a redistribuovat pro jakýkoliv účel včetně komerčních aplikací.

Jaké 3D formáty můžu číst a psát?

Knihovna podporuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA a 3MF pro oba. Čtení a psaní. PLY je pouze pro import. Použijte FileFormat.GetFormatByExtension() na … formáty podporované dotazem v době spuštění.

Můžu vytvořit 3D scénu od nuly?

Ano, postavit… Scene bez argumentů, přidat dětmi uzlů k scene.RootNode,a) ukládání do požadovaného formátu.