Començar

Introducció a Aspose.3D FOSS per a .NET

Benvingut a Aspose.3D, una biblioteca .NET gratuïta i de codi obert per a carregar, construir i exportar escenes 3D. Aquesta guia us porta d’un entorn nou a una escena funcional en minuts.

Requisits previs

RequisitDetall
.NET SDK.NET 10.0 o posterior
IDEVisual Studio 2022+, Rider o VS Code amb extensió C#
OSWindows, macOS o Linux
Gestor de paquetsNuGet (inclòs amb el SDK de .NET)

Instal·lació

  1. Creeu o obriu un projecte .NET:
dotnet new console -n My3DApp
cd My3DApp
  1. Afegiu el paquet NuGet:
dotnet add package Aspose.3D --version 26.1.0
  1. Verifiqueu que la referència es compila:
using Aspose.ThreeD;

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

Vegeu el Guia d’instal·lació per a més detalls sobre la configuració del projecte i la verificació.

Què pots fer

Un cop instal·lat, pots immediatament:

  • Carrega Fitxers OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY i 3MF via Scene.Open()
  • Inspecciona jerarquies d’escena: recorre Node arbres, llegeix Mesh geometria, accedeix a les normals de vèrtex i a les UV
  • Transforma nodes: estableix Translation, Rotation (via Quaternion), i Scale a través del Transform classe
  • Aplica materials: assigna LambertMaterial, PhongMaterial, o PbrMaterial a nodes
  • Exporta a qualsevol format compatible amb per-format SaveOptions
  • Construeix geometria: crea Box, Sphere, i Cylinder primitives i convertir-les a Mesh via ToMesh()

Inici ràpid

Carrega un fitxer 3D, imprimeix la jerarquia de l’escena i torna a desar-lo en 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");

Propers passos

 Català