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

Aspose.3D FOSS para Java é uma biblioteca gratuita, licenciada pelo MIT para carregar, manipular e salvar arquivos 3D – sem binários nativos necessários, pura Java de Maven Central.

Guia passo a passo

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

import com.aspose.threed.*;
Scene s = new Scene();
System.out.println("Aspose.3D loaded.");

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

import com.aspose.threed.Scene;

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

Scene scene = new Scene();
scene.open("model.glb");

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.obj");
walk(scene.getRootNode(), 0);

import com.aspose.threed.Scene;

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

Problemas comuns e fixos

FileNotFoundException Quando chamar Scene.fromFile() O caminho que você passou não existe ou usa o separador errado.Utiliza um caminho absoluto ou java.nio.file.Paths.get() Para garantir que o caminho de arquivo é correto.

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 open() e fromFile().Passar um parâmetro de formato explícito para sobrecarregar.

A cena vazia após o carregamento Alguns formatos binários podem exigir opções de carga específicas. tente usar uma sobrecarga explícita com opções de carga se o padrão produz uma cena vazia.

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.

Perguntas frequentes

O Aspose.3D FOSS requer qualquer DLL nativo?

A biblioteca é pura Java sem dependências nativas ou binárias externas necessárias.

Quais versões de Java são suportadas?

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 e FBX para tanto leitura quanto escrita. Use o Scene.save() API baseado em extensões para exportar a qualquer formato suportado.

Posso criar uma cena 3D de escorregamento?

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

Veja também

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