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
| Requisito | Detalhe |
|---|---|
| Java | JDK 21 ou posterior |
| Ferramenta de compilação | Maven ou Gradle |
| OS | Windows, 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, lerMeshgeometria, acessar normais de vértice e UVs - Transformar nós: definir translação, rotação e escala através do
Transformclasse - Aplicar materiais: atribuir
MaterialouPbrMateriala nós - Exportar para qualquer formato suportado com
scene.save() - Construir geometria: criar
Meshobjetos 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
- Guia de Instalação: configuração e verificação do Maven/Gradle
- Guia do Desenvolvedor: Suporte a formatos, operações de malha, materiais e transformações
- Recursos e Funcionalidades: Análise aprofundada de cada área de recurso com exemplos Java