Começando

Começando com Aspose.3D FOSS para Java

Bem-vindo ao aspose-3d-foss, uma biblioteca Java gratuita e de código aberto para carregar, construir e exportar cenas 3D. Este guia leva você de um projeto novo a uma cena funcional em minutos.


Pré-requisitos

RequisitoDetalhe
JavaJDK 21 ou posterior
Ferramenta de compilaçãoMaven ou Gradle
OSWindows, macOS ou Linux

Instalação

Adicione a dependência Maven ao seu pom.xml:

<dependency>
  <groupId>com.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.1.0</version>
</dependency>

Verifique:

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Veja o Guia de Instalação para configuração do Gradle e etapas de verificação.


O que você pode fazer

Depois de instalado, você pode imediatamente:

  • Carregar Arquivos OBJ, STL, glTF 2.0 / GLB e FBX via scene.open()
  • Inspecionar hierarquias de cena: percorrer Node árvores, ler Mesh geometria, acessar normais de vértice e UVs
  • Transformar nós: definir translação, rotação e escala através do Transform classe
  • Aplicar materiais: atribuir Material ou PbrMaterial a nós
  • Exportar para qualquer formato suportado com scene.save()
  • Construir geometria: criar Mesh objetos programaticamente com pontos de controle e polígonos

Início rápido

Carregue um arquivo 3D, imprima a hierarquia da cena e salve novamente no formato GLB:

import com.aspose.threed.Scene;
import com.aspose.threed.Node;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Próximas etapas

 Português