Como começar com Aspose.3D FOSS para .NET

Aspose.3D FOSS para .NET é uma biblioteca gratuita, licenciada pelo MIT para carregar, manipular e salvar arquivos 3D – sem binários nativos necessários, puro C# da NuGet.

Guia passo a passo

dotnet add package Aspose.3D --version 26.1.0

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

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

using Aspose.ThreeD;

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

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

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);

using Aspose.ThreeD;

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

Problemas comuns e fixos

FileNotFoundException Quando chamar Scene.Open() O caminho que você passou não existe ou usa o separador errado.Utiliza um caminho absoluto ou Path.Combine() Para garantir que o caminho de arquivo é correto.

UnsupportedOperationException Para certos métodos Alguns métodos (referência de cena, marcação de água) não estão disponíveis na edição FOSS. Verifique a documentação de limitações antes de usar recursos avançados.

Erro de formato desconhecido Assegure-se que a extensão de arquivo corresponde ao formato real.A biblioteca detecta o formato por meio do Extensão para Scene.Open() e Scene.FromFile().Passar uma explicação FileFormat Parâmetros para superar a detecção.

A cena vazia após o carregamento Alguns formatos binários podem exigir opções de carga específicas. tente usar o expresso sobrecarga com ObjLoadOptions ou GltfLoadOptions Se a carga padrão produz uma cena vazia.

Perguntas frequentes

O Aspose.3D FOSS requer Microsoft Office ou qualquer DLL nativo?

A biblioteca é pura C# com nenhuma dependência nativa ou binárias externas necessárias.

Quais versões do .NET são suportadas?

.NET 10.0 ou posterior. a biblioteca funciona em contêineres Windows, macOS, Linux e Docker.

A biblioteca é livre para uso comercial?

É lançado sob a Licença MIT. Você pode usá-lo, modificar e redistribuir para qualquer finalidade, incluindo aplicações comerciais.

Quais os formatos 3D que posso ler e escrever?

A biblioteca suporta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA e 3MF para ambos. Leia e escreva. PLY é apenas importado. Use FileFormat.GetFormatByExtension() Para Query suportado formatos em tempo real.

Posso criar uma cena 3D de escorregamento?

Construindo a Scene sem argumentos, adicione os nodos da criança para scene.RootNode,e Acompanhe o formato desejado.

Veja também

• FAQ — Aspose.3D FOSS para .NET
• Como fazer o download de modelos 3D em .NET
• Como converter modelos 3D em .NET
• Começando com Docs
• Referência de API