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
| Requisito | Detalle |
|---|---|
| .NET SDK | .NET 10.0 o posterior |
| IDE | Visual Studio 2022+, Rider o VS Code con la extensión C# |
| OS | Windows, macOS o Linux |
| Gestor de paquetes | NuGet (incluido con el SDK de .NET) |
Instalación
- Crea o abre un proyecto .NET:
dotnet new console -n My3DApp
cd My3DApp- Agrega el paquete NuGet:
dotnet add package Aspose.3D --version 26.1.0- Verifica que la referencia compile:
using Aspose.ThreeD;
var scene = new Scene();
Console.WriteLine("Aspose.3D loaded successfully.");dotnet runVer 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, leerMeshgeometría, acceder a normales de vértices y UVs - Transformar nodos: establecer
Translation,Rotation(a través deQuaternion), yScalea través delTransformclase - Aplicar materiales: asignar
LambertMaterial,PhongMaterial, oPbrMateriala nodos - Exportar a cualquier formato compatible con opciones por formato
SaveOptions - Construir geometría: crear
Box,Sphere, yCylinderprimitivas y convertirlas aMesha través deToMesh()
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
- Guía de instalación: Configuración detallada de NuGet, configuración del proyecto y verificación
- Guía del desarrollador: Soporte de formatos, operaciones de malla, materiales y transformaciones
- Características y funcionalidades: Análisis profundo de cada área de funcionalidad con ejemplos en C#