1. Produtos
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS para Java

Carregue, crie, transforme e exporte cenas 3D a partir de Java — gratuito e de código aberto.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Documentação GitHub

Biblioteca Java de Código Aberto para Processamento de Arquivos 3D

Aspose.3D FOSS para Java é uma biblioteca licenciada sob MIT, pure-Java, para trabalhar com formatos de arquivos 3D. Adicione uma única dependência Maven e comece imediatamente a ler, construir e gravar cenas 3D sem instalar nenhum runtime nativo, SDK externo ou renderizador de terceiros.

A biblioteca expõe uma API de grafo de cena limpa construída em torno de Scene, Node, Mesh, Camera e Transform, o mesmo modelo conceitual usado por ferramentas 3D profissionais. O suporte a formatos inclui OBJ (com carregamento de materiais .mtl), STL (binário e ASCII, verificado em roundtrip), glTF 2.0 (materiais PBR), GLB (glTF binário) e FBX (apenas importação). As opções de carregamento e gravação por formato permitem controlar a inversão de coordenadas, escala, normalização de normais e carregamento de materiais sem escrever código de análise específico de formato.

Aspose.3D FOSS requer Java 21 ou superior e funciona de forma idêntica em runners CI Windows, macOS e Linux, contêineres Docker e ambientes serverless. Não há extensão nativa para compilar nem pacote de sistema para instalar.

Suporte a Formatos 3D e API de Grafo de Cena

  • OBJ / MTL: Carregue arquivos Wavefront OBJ com definições de material acompanhantes.
  • STL: Leia e escreva STL binário e ASCII com verificação completa de roundtrip.
  • glTF 2.0 / GLB: Carregamento de materiais PBR e exportação via GltfSaveOptions. Use setContentType(FileContentType.BINARY) para saída GLB.
  • FBX: Suporte de importação para carregamento de arquivos FBX (exportação não disponível).
  • API de grafo de cena: Scene, Node, Mesh, Camera, Transform.

Onde Aspose.3D FOSS pode ser usado

  • Pipelines de validação de ativos: Verifique, reoriente e reexporte ativos 3D na CI.
  • Ferramentas de desenvolvimento de jogos: Processamento em lote de malhas OBJ e STL sem um motor nativo.
  • Fluxos de trabalho de impressão 3D: Leia, valide e reexporte arquivos STL.
  • Web backends: Sirva endpoints de conversão 3D em Docker ou funções serverless.
  • Content migration: Converta entre famílias de formatos em escala.

Opções por Formato e Controle de Coordenadas

  • Orientação do sistema de coordenadas: Inverta eixos e ajuste a escala por formato sem código personalizado.
  • Normalização de normais: Normaliza automaticamente as normais dos vértices ao carregar ou salvar.
  • Controle de carregamento de material: Ative ou desative o carregamento de MTL/textura para análise mais rápida.
  • Saída formatada: Escolha JSON glTF compacto ou legível por humanos via opções.
  • Fidelidade de ida e volta: Nós desconhecidos do grafo de cena são preservados literalmente ao regravar.

Experiência do desenvolvedor

Aspose.3D FOSS para instalações Java com uma única dependência Maven (com.aspose:aspose-3d-foss:26.1.0). A biblioteca é pura Java, sem extensões nativas para compilar e sem pacotes de sistema para instalar.

A API de grafo de cena reflete o modelo conceitual das ferramentas 3D profissionais, portanto a curva de aprendizado é curta para quem está familiarizado com o modelo de dados do Three.js ou do Blender. A biblioteca tem licença MIT, é open-source e aceita relatórios de bugs e contribuições no GitHub.

Carregue uma cena OBJ e exporte como glTF

Adicione a dependência Maven, então chame Scene.fromFile("model.obj") para carregar o arquivo OBJ junto com suas definições de material MTL. Uma única chamada scene.save() com a extensão .gltf grava um arquivo JSON glTF 2.0, sem necessidade de registro de formato ou objeto conversor.

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

import com.aspose.threed.*;

// Carregar um arquivo OBJ (com materiais .mtl)
Scene scene = Scene.fromFile("model.obj");

// Exportar como glTF 2.0
scene.save("model.gltf");

Converta STL para glTF com GltfSaveOptions

Para gerar um arquivo glTF com ajustes no sistema de coordenadas, passe uma instância de GltfSaveOptions com setFlipCoordinateSystem(true). O mesmo padrão se aplica a todas as opções por formato — troque a classe de opções pelo formato que você está direcionando.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// Salvar como glTF com opções
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Perguntas Frequentes

O que é Aspose.3D FOSS para Java?

É uma biblioteca gratuita, licenciada sob MIT, pure-Java, para carregar, manipular e salvar cenas 3D sem instalar nenhum runtime nativo ou SDK externo.

Quais formatos 3D são suportados?

OBJ (com .mtl), STL (binário e ASCII), glTF 2.0, GLB (glTF binário) e FBX (apenas importação). Cada formato possui uma classe dedicada de opções de carregamento/salvamento.

Ele requer alguma dependência nativa?

Não. Aspose.3D FOSS para Java é puro Java sem extensões nativas. Ele roda no Windows, macOS e Linux sem nenhuma etapa de compilação.

Como instalá-lo?

Adicione a dependência Maven com.aspose:aspose-3d-foss:26.1.0 ao seu projeto. Nenhum pacote de sistema adicional ou extensões nativas são necessários.

Posso controlar a orientação do sistema de coordenadas?

Sim. Classes de opções por formato permitem inverter eixos, ajustar a escala e normalizar normais sem escrever nenhum código de análise específico de formato.

Quais versões do Java são suportadas?

Java 21 e posteriores são suportados. A biblioteca funciona identicamente em todos os principais sistemas operacionais.

O código-fonte está disponível?

Sim. A biblioteca é MIT-licensed e está hospedada no GitHub. Relatórios de bugs e pull requests são bem‑vindos.

  

Recursos de Suporte e Aprendizado

 Português