Cómo comenzar con Aspose.3D FOSS para .NET

Aspose.3D FOSS para .NET es una biblioteca gratuita, licenciada por MIT para cargar, manipular y salvar archivos 3D — no se requieren binarios nativos, puro C# de NuGet.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde NuGet (necesario .NET 10.0 o posterior):

dotnet add package Aspose.3D --version 26.1.0

Verifique la instalación cargada correctamente:

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

Paso 2: Importación de espacios de nombre necesarios

Importa los espacios de nombre para la escena y las clases de formato:

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

Paso 3: Cargar un archivo 3D

Uso Scene.Open() para cargar cualquier formato apoyado. la biblioteca detecta el formato Automaticamente desde la extensión de archivo:

using Aspose.ThreeD;

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

Uso de la técnica de fábrica estática:

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

Paso 4: Caminar por el gráfico de escena

Una escena cargada es un árbol de Node Objetos enracinados en 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);

Paso 5: Salva en un formato diferente

Uso Scene.Save() para exportar a cualquier formato de salida compatible. la biblioteca detecta el Formato de salida del archivo extendido:

using Aspose.ThreeD;

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

Problemas y soluciones comunes

FileNotFoundException Cuando llamar Scene.Open() El camino que pasaste no existe o utiliza el separador equivocado.Utilizar un camino absoluto o Path.Combine() Para asegurar que el archivo es correcto.

UnsupportedOperationException Para ciertos métodos Algunos métodos (referencia de escena, marquillaje del agua) no están disponibles en la edición FOSS. Verifique la documentación de limitaciones antes de utilizar las características avanzadas.

Error de formato desconocido Asegúrese que la extensión de archivo se ajusta al formato real.La biblioteca detecta el formato por Extension para Scene.Open() y Scene.FromFile().Pasar una explicación FileFormat Parámetros para superar la detección.

Escena vacía después de la carga Algunos formatos binarios pueden requerir opciones de carga específicas.Tenta utilizar la sobrecarga explícita con ObjLoadOptions o GltfLoadOptions Si la carga de default produce una escena vacía.

Preguntas frecuentes

¿Acaso Aspose.3D FOSS requiere Microsoft Office o cualquier DLL nativo?

No. La biblioteca es pura C# con ninguna dependencia nativa o binarios externos requeridos.

¿Qué versiones de .NET están apoyadas?

.NET 10.0 o más tarde. la biblioteca se ejecuta en los contenedores de Windows, macOS, Linux y Docker.

¿La biblioteca es libre para uso comercial?

Se publica bajo la Licencia MIT. Puede utilizar, modificar y redistribuirlo para cualquier propósito, incluidas las aplicaciones comerciales.

¿Qué formatos 3D puedo leer y escribir?

La biblioteca soporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA y 3MF para ambos. Leer y escribir. PLY es solo importado. FileFormat.GetFormatByExtension() para Query soporta formatos en tiempo real.

¿Puedo crear una escena 3D de la escuridad?

Construcción A Scene sin argumentos, añade nodos infantiles a los scene.RootNode,y, Salvo en el formato deseado.