Come iniziare con Aspose.3D FOSS per .NET

Aspose.3D FOSS per .NET è una libreria gratuita, con licenza MIT per il caricamento, la manipolazione e lo salvataggio di file 3D – nessun binario nativo richiesto, puro C# da NuGet.

Guida passo passo

Passo 1: Installa il pacchetto

Installare da NuGet (.NET 10.0 o successivo richiesto):

dotnet add package Aspose.3D --version 26.1.0

Verificare l’installazione caricata correttamente:

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

Passo 2: Importare spazi di nome necessari

Importare gli spazi di nome per la scena e le classi di formato:

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

Passo 3: Caricare un file 3D

Utilizzo Scene.Open() per caricare qualsiasi formato supportato. la biblioteca rileva il formato automaticamente dalla estensione del file:

using Aspose.ThreeD;

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

Utilizzare il metodo statico di fabbrica:

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

Passo 4: attraversare il grafico della scena

Una scena caricata è un albero di Node oggetti radicati in 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);

Passo 3: Salva nel formato di destinazione

Utilizzo Scene.Save() per esportare in qualsiasi formato di uscita supportato. la biblioteca rileva il Il formato di uscita dalla estensione del file:

using Aspose.ThreeD;

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

Problemi e fissazioni comuni

FileNotFoundException Quando chiamare Scene.Open() Il percorso che hai attraversato non esiste o utilizza il separatore sbagliato. Path.Combine() Per assicurarsi che il file path sia corretto.

UnsupportedOperationException Per alcuni metodi Alcuni metodi (rendering di scena, watermarking) non sono disponibili nella versione FOSS. Verificare la documentazione delle limitazioni prima di utilizzare le funzionalità avanzate.

errore di formato sconosciuto Assicurarsi che l’estensione del file corrisponda al formato reale. la biblioteca rileva il formato da estensione per Scene.Open() e Scene.FromFile().Passare una spiegazione FileFormat Parametri per superare la rilevazione.

Scena vuota dopo il carico Alcuni formati binari potrebbero richiedere opzioni di carico specifiche. provare a utilizzare il sovraccarico esplicito con ObjLoadOptions o GltfLoadOptions se la carica predefinita produce una scena vuota.

Domande frequenti

Aspose.3D FOSS richiede Microsoft Office o qualsiasi DLL nativo?

La biblioteca è pura C# con nessuna dipendenza nativa o binari esterni richiesti.

Quali versioni di .NET sono supportate?

.NET 10.0 o successivo. la biblioteca funziona su Windows, macOS, Linux e Docker contenitori.

La biblioteca è gratuita per uso commerciale?

È rilasciato sotto la licenza MIT. Puoi utilizzarla, modificarla e redistribuirla per qualsiasi scopo, comprese le applicazioni commerciali.

Quali formati 3D posso leggere e scrivere?

La biblioteca supporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA e 3MF per entrambi. Leggi e scrivete. PLY è importato solo. utilizzo FileFormat.GetFormatByExtension() per Query supportato formati in tempo reale.

Posso creare una scena 3D da scratch?

Sì, costruire una Scene senza argomenti, aggiungere i nodi per bambini a scene.RootNode,e salvo nel formato desiderato.