Hogyan lehet elkezdeni Aspose.3D FOSS .NET

Az Aspose.3D FOSS for .NET egy ingyenes, MIT-licencelt könyvtár a 3D fájlok betöltésére, manipulálására és mentésére - nincsenek natív bináris kódok szükségesek, tiszta C# a NuGet-től.

Lépésről‑lépésre útmutató

1. lépés: A csomag telepítése

A NuGet (.NET 10.0 vagy újabb verzió szükséges) telepítéséhez:

dotnet add package Aspose.3D --version 26.1.0

Ellenőrizze, hogy a telepítés helyesen történt:

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

2. lépés: A szükséges névtér importálása

A jelenet és a formátum osztályok nevterületeinek importálása:

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

Hogyan töltsek be egy 3D fájlt?

használja Scene.Open() bármely támogatott formátum betöltéséhez. A könyvtár észleli a formátumot, ha automatikusan a fájl kiterjesztéséből:

using Aspose.ThreeD;

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

A statikus gyár módszerét használja:

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

Hogyan járhatom be a jelenet gráfot?

A színpad egy fának tűnik, a Node A tárgyak a 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);

3. lépés: Mentse el a célformátumba

használja Scene.Save() exportálhat bármilyen támogatott kimeneti formátumra. A könyvtár észleli a A fájl kimeneti formátumát a kiterjesztésből:

using Aspose.ThreeD;

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

Közös problémák és fixok

FileNotFoundException Amikor hívnak Scene.Open() Az út, amelyet átmentél nem létezik vagy a helytelen elválasztót használja. Path.Combine() A fájl útvonalának helyesnek kell lennie.

UnsupportedOperationException Bizonyos módszerek esetében Egyes módszerek (színházi ábrázolás, vízjelzés) nem érhetők el a FOSS kiadásban. Ellenőrizze a korlátozások dokumentációját, mielőtt használná a speciális funkciókat.

Ismeretlen formátum hiba Győződjön meg arról, hogy a fájl kiterjesztése megfelel az aktuális formátumnak.A könyvtár észleli a formázást a kiterjesztése a Scene.Open() és Scene.FromFile().Egyértelműen átadjuk FileFormat A paraméterek felismerése.

Üres jelenet a töltés után Egyes bináris formátumok speciális terhelési lehetőségeket igényelhetnek. Próbáld ki a kifejezett túlterhelést A ObjLoadOptions vagy GltfLoadOptions Ha az alapértelmezett terhelés üres jelenetet eredményez.

Gyakran ismételt kérdések

A DLL-hez szükséges a Microsoft Office vagy bármilyen natív Dll?

A könyvtár tiszta C#, nincsenek szükségük a natív függőségekre vagy külső bináris számokra.

Milyen .NET verziók támogatottak?

.A könyvtár Windows, macOS és Docker konténerekben fut.

A könyvtár szabadon használható kereskedelmi célokra?

Az MIT licenc alatt áll, és bármilyen célra használhatja, módosíthatja és terjesztheti.

Milyen 3D formátumban lehet olvasni és írni?

A könyvtár támogatja az OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA és 3MF mindkettőt. olvasás és írás. PLY csak importálható. használja FileFormat.GetFormatByExtension() két A kérdőívek futtatása a Runtime-ban.

Hozhatok létre 3D-s jelenetet a semmiből?

Építsünk a Scene Nincsenek megjegyzések, adjunk hozzá gyermekcsomópontokat a scene.RootNode,és mentse a kívánt formátumra.