Perguntas frequentes

Licença e Open Source

Qual é o modelo de licenciamento para Aspose.3D FOSS para Java?

Aspose.3D FOSS para Java é lançado sob a Licença MIT. Você pode usá-lo em projetos pessoais, comerciais e open source sem restrições. Não há necessidade de chave ou activação da licença do tempo de execução. O código fonte está disponível no GitHub.

Posso usar Aspose.3D FOSS para Java em um produto comercial?

Sim. A Licença MIT permite uso ilimitado em produtos comerciais.Não é necessário pagamento de royalties, servidor de licença ou conexão à internet no tempo real.

Instalação & Requisitos

Como posso instalar Aspose.3D FOSS para Java?

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

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>

Em seguida, importar o pacote em seus arquivos de origem:

import com.aspose.threed.*;

Qual a versão Java necessária?

Aspose.3D FOSS para Java requer JDK 21 ou mais tarde. é totalmente autônomo com nenhuma dependência nativa e nenhum binário específico da plataforma.

Formato de Apoio

Quais formatos de arquivo 3D podem ler e escrever o FOSS 3d para Java?

A versão atual suporta os seguintes formatos:

Como posso detectar automaticamente o formato de um arquivo?

Usando FileFormat.getFormatByExtension(filePath) Para ver o formato com extensão de arquivo:

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

Como posso usar opções de carregamento ou armazenamento para um formato específico?

Passar uma opção específica de formato para Scene.open() ou Scene.save().Por exemplo, Para permitir o sistema de coordenadas flutuar ao carregar glTF:

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

Para a exportação de glTF com JSON impresso:

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

Assim como, FbxLoadOptions Disponível para configuração de importação FBX.

Uso de API

Como posso carregar um modelo 3D de um arquivo?

Use a fábrica estática Scene.fromFile(filePath) para um carregamento de um passo, ou construir uma Scene e chamando scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

Como posso criar uma nova cena vazia e salvar?

Construindo a Scene,Adicione nódulos conforme necessário, e depois chame scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

Como posso atravessar o gráfico da cena?

Acesso ao nodo de raiz através do scene.getRootNode() e iterai seus filhos:

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

Como posso salvar uma cena em um formato específico?

Passar o caminho de saída com a extensão alvo — Aspose.3D detecta o formato do Aplicar automaticamente. para controle explícito, passem a FileFormat Ou o objeto de opções de armazenamento:

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

Limitações conhecidas

A renderização 3D está disponível neste lançamento?

Não, o Scene.render() Métodos de jogamento UnsupportedOperationException No atual FOSS release. Rendering ainda não está implementado. Use esta biblioteca para importação, processamento, Exportar apenas dados de cena 3D.

Todos os recursos do FBX são suportados?

A importação do FBX é suportada para geometria e dados de gráfico da cena. implementado — chamando para salvar com o formato FBX jogadas ExportException.Complexo FBX Importa recursos como animações incorporadas, restrições e FBX proprietário As extensões não podem ser totalmente preservadas.