Comment démarrer avec Aspose.3D FOSS pour .NET

Aspose.3D FOSS pour .NET est une bibliothèque gratuite, certifiée par MIT pour le chargement, la manipulation et l’épargne de fichiers 3D - aucun binaire natif requis, pure C# de NuGet.

Guide étape par étape

Étape 1 : Installer le package

Installation à partir de NuGet (.NET 10.0 ou ultérieur requis):

dotnet add package Aspose.3D --version 26.1.0

Vérifiez que l’installation est correctement chargée :

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

Étape 2 : Importation des espaces de nom requis

Importer les spaces de nom pour la scène et les classes de format:

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

Comment charger un fichier 3D ?

Utiliser Scene.Open() pour télécharger tout format supporté. la bibliothèque détecte le format Automatikement de l’extension du fichier :

using Aspose.ThreeD;

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

Utilisez la méthode de fabrication statique :

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

Comment parcourir le graphe de la scène ?

Une scène chargée est un arbre de Node Les objets enracinés à 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);

Étape 3 : Enregistrez au format cible

Utiliser Scene.Save() pour exporter à tout format de sortie supporté. la bibliothèque détecte le Formats de sortie du fichier extension :

using Aspose.ThreeD;

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

Problèmes courants et solutions

FileNotFoundException Quand on appelle Scene.Open() Le chemin que vous avez traversé n’existe pas ou utilisez le séparateur incorrect. Path.Combine() Pour que le fichier soit correct.

UnsupportedOperationException Pour certaines méthodes Certaines méthodes (rédaction de scène, marquage d’eau) ne sont pas disponibles dans l’édition FOSS. Vérifiez la documentation des limitations avant d’utiliser les fonctionnalités avancées.

Erreur de format inconnu Assurez-vous que l’extension de fichier correspond au format réel.La bibliothèque détecte le format par Extension pour Scene.Open() et Scene.FromFile().Passez une explication FileFormat Paramètres pour détecter.

Scène vide après le chargement Certains formats binaires peuvent nécessiter des options de charge spécifiques. essayez d’utiliser la surcharge explicite avec ObjLoadOptions ou GltfLoadOptions Si la charge par défaut produit une scène vide.

Questions fréquentes

Aspose.3D FOSS nécessite-t-il Microsoft Office ou des DLL indigènes ?

La bibliothèque est pure C# avec aucune dépendance native ou des binaires externes nécessaires.

Quelles versions .NET sont-elles soutenues ?

.NET 10.0 ou plus tard. La bibliothèque fonctionne sur les conteneurs Windows, macOS, Linux et Docker.

La bibliothèque est-elle gratuite pour une utilisation commerciale ?

Oui. Il est libéré sous la licence MIT. Vous pouvez l’utiliser, modifier et redistribuer à tout but, y compris les applications commerciales.

Quels sont les formats 3D que je peux lire et écrire ?

La bibliothèque prend en charge OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA et 3MF pour les deux. Lire et écrire. PLY est importé-uniquement. Utiliser FileFormat.GetFormatByExtension() à Les formats de recherche sont soutenus à temps réel.

Puis-je créer une scène 3D à partir de la crème ?

Construire A Scene sans arguments, ajoutez les nodes de l’enfant à scene.RootNode,et Enregistrer dans le format souhaité.