Comenzando

Comenzando con Aspose.3D FOSS para .NET

Bienvenido a Aspose.3D, una biblioteca .NET gratuita y de código abierto para cargar, construir y exportar escenas 3D. Esta guía te lleva de un entorno nuevo a una escena funcional en minutos.


Requisitos previos

RequisitoDetalle
.NET SDK.NET 10.0 o posterior
IDEVisual Studio 2022+, Rider o VS Code con la extensión C#
OSWindows, macOS o Linux
Gestor de paquetesNuGet (incluido con el SDK de .NET)

Instalación

  1. Crea o abre un proyecto .NET:
dotnet new console -n My3DApp
cd My3DApp
  1. Agrega el paquete NuGet:
dotnet add package Aspose.3D --version 26.1.0
  1. Verifica que la referencia compile:
using Aspose.ThreeD;

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

Ver el Guía de instalación para obtener más detalles sobre la configuración del proyecto y la verificación.


Qué puede hacer

Una vez instalado, puede inmediatamente:

  • Cargar archivos OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY y 3MF a través de Scene.Open()
  • Inspeccionar jerarquías de escena: recorrer Node árboles, leer Mesh geometría, acceder a normales de vértices y UVs
  • Transformar nodos: establecer Translation, Rotation (a través de Quaternion), y Scale a través del Transform clase
  • Aplicar materiales: asignar LambertMaterial, PhongMaterial, o PbrMaterial a nodos
  • Exportar a cualquier formato compatible con opciones por formato SaveOptions
  • Construir geometría: crear Box, Sphere, y Cylinder primitivas y convertirlas a Mesh a través de ToMesh()

Inicio rápido

Cargue un archivo 3D, imprima la jerarquía de la escena y vuelva a guardarlo en formato 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");

Próximos pasos

 Español