Ako začať s Aspose.3D FOSS pre .NET

Aspose.3D FOSS pre .NET je bezplatná knižnica s licenciou MIT na nahrávanie, manipuláciu a úsporu 3D súborov - žiadne domáce binárne požadované, čisté C# od NuGet.

Postupný návod

Krok 1: Nainštalujte balík

Inštalácia z NuGet (.NET 10.0 alebo novšie vyžaduje):

dotnet add package Aspose.3D --version 26.1.0

Skontrolujte správne nabitý inštalátor:

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

Krok 2: Import potrebných názvov priestorov

Import názvov priestorov pre scénu a formátové triedy:

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

Krok 3: Nahrať 3D súbor

Používanie Scene.Open() na stiahnutie akéhokoľvek podporovaného formátu. knižnica detekuje formát automaticky z rozšírenia súboru:

using Aspose.ThreeD;

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

Alebo použite statickú továreň:

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

Krok 4: Prejsť cez scénový graf

Nádherná scéna je stromček Node Objekty zakorenené 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 3: Uložte do cieľového formátu

Používanie Scene.Save() na export do akéhokoľvek podporovaného formátu výstupu. knižnica detekuje formát výstupu z rozšírenia súborov:

using Aspose.ThreeD;

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

Bežné problémy a riešenia

FileNotFoundException Keď volá Scene.Open() Cesta, ktorú ste prešli neexistuje alebo používa nesprávny separátor. Path.Combine() zabezpečiť, aby bola správna cesta súboru.

UnsupportedOperationException V niektorých metódach Niektoré metódy (referencie scény, vodné označenie) nie sú k dispozícii v vydaní FOSS. Skontrolujte dokumentáciu obmedzení pred použitím pokročilých funkcií.

Neznámy formát chyb Uistite sa, že rozšírenie súboru zodpovedá skutočnému formátu. knižnica detekuje formát podľa rozšírenie pre Scene.Open() a Scene.FromFile().Prejdite na jednoznačné FileFormat parameter pre override detekcie.

Prázdna scéna po nahrávaní Niektoré binárne formáty môžu vyžadovať špecifické možnosti zaťaženia. skúste použiť explicitný preťaženie s ObjLoadOptions alebo GltfLoadOptions ak predvolený zaťaženie produkuje prázdnu scénu.

Často kladené otázky

Potrebuje Aspose.3D FOSS Microsoft Office alebo akékoľvek domáce DLL?

Knižnica je čistá C# s žiadnou domorodou závislosťou alebo vonkajšími binárnymi požiadavkami.

Ktoré verzie .NET sú podporované?

.NET 10.0 alebo neskôr. knižnica beží na kontajneroch Windows, macOS, Linux a Docker.

Je knižnica voľná na komerčné použitie?

Je vydaný podľa licencie MIT. Môžete ho používať, modifikovať a distribuovať na akýkoľvek účel vrátane komerčných aplikácií.

Aké 3D formáty môžem čítať a písať?

Knižnica podporuje OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA a 3MF pre obaja čítanie a písanie. PLY je import-only. používať FileFormat.GetFormatByExtension() na Formát podporovaný v runtime.

Môžem vytvoriť 3D scénu z škrabanca?

konštrukcia a Scene bez argumentov, pridajte detské uzly k scene.RootNode,a , a Uložiť do požadovaného formátu.