Início rápido

Início rápido

Este guia mostra o caminho mais rápido desde a instalação para carregar e salvar um arquivo 3D usando Aspose.3D FOSS para Java. A biblioteca é licenciada pelo MIT, pura Java, e não requer binárias nativas ou dependências externas além do Maven artefato.


Precondições

RequisitosDetalhes
Java21 or later
Construa ferramentaMaven 3.6 ou Gradle
OSWindows, MacOS e Linux, Docker
Pacotecom.aspose:aspose-3d-foss:26.1.0

Instalação

Adicione a dependência de Maven ao seu pom.xml.A biblioteca detecta formatos de arquivo 3D automaticamente de extensões de arquivo, para que não sejam necessárias constantes de formato explícitas para Utilização básica:

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

Carregar um arquivo 3D

Chamado Scene.fromFile() com um caminho para carregar qualquer formato suportado. aceder à cena A hierarquia através da scene.getRootNode():

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
System.out.println("Root node: " + scene.getRootNode().getName());

Passando pelo gráfico da cena

Uma cena carregada é uma árvore de Node Objetos que se enraizam em scene.getRootNode().Usando Um recursivo para processar cada nodo e seus filhos:

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

void walk(Node node, int depth) {
    String indent = " ".repeat(depth * 2);
    System.out.println(indent + "Node: " + node.getName());
    for (Node child : node.getChildNodes()) {
        walk(child, depth + 1);
    }
}

Scene scene = Scene.fromFile("model.glb");
walk(scene.getRootNode(), 0);

Salve para um formato diferente

A biblioteca detecta o formato de saída da extensão do arquivo. Passar a rota de output Para Scene.save() Para converter entre formatos:

import com.aspose.threed.Scene;

Scene scene = Scene.fromFile("model.obj");
scene.save("output.glb");
System.out.println("Converted to GLB.");

Crie uma nova cena e salve

Construindo a Scene sem argumentos para começar vazio, adicione nodos de criança a scene.getRootNode(),Então chame scene.save() Para escrever o arquivo:

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

Scene scene = new Scene();
Node box = scene.getRootNode().createChildNode("box");
scene.save("new_scene.obj");

Próximo Passos

 Português