Premiers pas

Premiers pas avec Aspose.3D FOSS pour .NET

Bienvenue à Aspose.3D, une bibliothèque .NET gratuite et open-source pour charger, construire et exporter des scènes 3D. Ce guide vous fait passer d’un environnement vierge à une scène fonctionnelle en quelques minutes.

Prérequis

PrérequisDétail
.NET SDK.NET 10.0 ou version ultérieure
IDEVisual Studio 2022+, Rider ou VS Code avec l’extension C#
OSWindows, macOS ou Linux
Gestionnaire de paquetsNuGet (inclus avec le SDK .NET)

Installation

  1. Créez ou ouvrez un projet .NET :
dotnet new console -n My3DApp
cd My3DApp
  1. Ajoutez le package NuGet :
dotnet add package Aspose.3D --version 26.1.0
  1. Vérifiez que la référence compile :
using Aspose.ThreeD;

var scene = new Scene();
Console.WriteLine("Aspose.3D loaded successfully.");
dotnet run

Voir le Guide d’installation pour plus de détails sur la configuration du projet et la vérification.

Ce que vous pouvez faire

Une fois installé, vous pouvez immédiatement :

  • Charger fichiers OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY et 3MF via Scene.Open()
  • Inspecter hiérarchies de scène : parcourir Node arbres, lire Mesh géométrie, accéder aux normales des sommets et aux UV
  • Transformer nœuds : définir Translation, Rotation (via Quaternion), et Scale à travers le Transform classe
  • Appliquer les matériaux: assigner LambertMaterial, PhongMaterial, ou PbrMaterial aux nœuds
  • Exporter vers tout format pris en charge avec per-format SaveOptions
  • Construire la géométrie: créer Box, Sphere, et Cylinder primitives et les convertir en Mesh via ToMesh()

Démarrage rapide

Chargez un fichier 3D, affichez la hiérarchie de la scène et réenregistrez au format GLB :

using Aspose.ThreeD;

var scene = new Scene();
scene.Open("input.obj");

Console.WriteLine($"Root children: {scene.RootNode.ChildNodes.Count}");
foreach (var node in scene.RootNode.ChildNodes)
{
    var entityType = node.Entity?.GetType().Name ?? "no entity";
    Console.WriteLine($"  {node.Name} [{entityType}]");
}

scene.Save("output.glb");
Console.WriteLine("Saved output.glb");

Étapes suivantes

 Français