Começando

Começando com Aspose.3D FOSS para .NET

Bem-vindo a Aspose.3D, uma biblioteca .NET gratuita e de código aberto para carregar, construir e exportar cenas 3D. Este guia leva você de um ambiente novo a uma cena funcional em minutos.

Pré-requisitos

RequisitoDetalhe
.NET SDK.NET 10.0 ou posterior
IDEVisual Studio 2022+, Rider ou VS Code com extensão C#
OSWindows, macOS ou Linux
Gerenciador de pacotesNuGet (incluído com o SDK .NET)

Instalação

  1. Crie ou abra um projeto .NET:
dotnet new console -n My3DApp
cd My3DApp
  1. Adicione o pacote NuGet:
dotnet add package Aspose.3D --version 26.1.0
  1. Verifique se a referência compila:
using Aspose.ThreeD;

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

Veja o Guia de Instalação para mais detalhes sobre a configuração do projeto e verificação.

O que você pode fazer

Depois de instalado, você pode imediatamente:

  • Carregar Arquivos OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA, PLY e 3MF via Scene.Open()
  • Inspecionar hierarquias de cena: percorrer Node árvores, ler Mesh geometria, acessar normais de vértice e UVs
  • Transformar nós: definir Translation, Rotation (via Quaternion), e Scale através do Transform classe
  • Aplicar materiais: atribuir LambertMaterial, PhongMaterial, ou PbrMaterial para nós
  • Exportar para qualquer formato suportado com opções por formato SaveOptions
  • Construir geometria: criar Box, Sphere, e Cylinder primitivas e convertê-las para Mesh via ToMesh()

Início rápido

Carregue um arquivo 3D, imprima a hierarquia da cena e salve novamente no 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óximas etapas

 Português