Como fazer o download de modelos 3D em Java

Aspose.3D FOSS para Java fornece uma API simples para abrir arquivos 3D sem qualquer dependência nativa. Scene Objeto você pode andar a hierarquia de nódulos e ler dados geométricos crus para cada mesh na cena.

Guia passo a passo

Passo 1: Adicione a dependência de Maven

Adicione a dependência do Aspose.3D FOSS ao seu pom.xml.Não são necessárias bibliotecas nativas adicionais.

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

Passo 2: Importar as classes necessárias

O que Scene A classe é o contenedor de nível superior para todos os dados 3D. Importá-lo junto com a Node, Mesh, e quaisquer classes de carga específicas do formato que você precisa.

import com.aspose.threed.Scene;
import com.aspose.threed.Node;
import com.aspose.threed.Mesh;
import com.aspose.threed.Entity;
import com.aspose.threed.ObjLoadOptions;
import com.aspose.threed.GltfLoadOptions;
import com.aspose.threed.StlLoadOptions;

Todas as classes públicas vivem sob o com.aspose.threed em pacote.

Passo 3: Carregar um arquivo

Use o estático Scene.fromFile() método para abrir qualquer formato suportado.A biblioteca detecta o formato automaticamente da extensão de arquivo.

// Automatic format detection from the file extension
Scene scene = Scene.fromFile("model.obj");

Alternativamente, criar um Scene Instância e chamada open().Isso é útil quando você deseja passar as opções de carga ou lidar com erros explicitamente:

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

Ambos os métodos suportam OBJ, STL (binário e ASCII), glTF 2.0 / GLB, e arquivos FBX.

Passo 4: Traverse Scene Nodes

Uma cena carregada é uma árvore de Node Objetos que se enraizam em scene.getRootNode().Usando getChildNodes() para iterar recursivamente e visitar todos os nodos:

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

public class SceneWalker {
    public static void main(String[] args) throws Exception {
        Scene scene = Scene.fromFile("model.obj");
        walkNode(scene.getRootNode(), 0);
    }

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

Cada um Node Pode levar zero ou mais. Entity objetos (mesas, câmeras e luzes). node.getEntities() para inspeccionar cada entidade ligada a um nodo, ou usar node.getEntity() para recuperar a entidade primária.

Passo 5: Acesso a dados Vertex e Polygon

A entidade de um nodo é Mesh e chamando getControlPoints() para as posições vertex e getPolygons() Para lista de índices:

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

Scene scene = Scene.fromFile("model.obj");

for (Node node : scene.getRootNode().getChildNodes()) {
    Entity entity = node.getEntity();
    if (entity instanceof Mesh) {
        Mesh mesh = (Mesh) entity;
        System.out.printf("Mesh '%s': %d vertices, %d polygons%n",
            node.getName(),
            mesh.getControlPoints().size(),
            mesh.getPolygonCount());

        // First vertex position (Vector4: x, y, z, w)
        if (!mesh.getControlPoints().isEmpty()) {
            var v = mesh.getControlPoints().get(0);
            System.out.printf("  First vertex: (%.4f, %.4f, %.4f)%n", v.x, v.y, v.z);
        }

        // First polygon: array of control-point indices
        if (!mesh.getPolygons().isEmpty()) {
            int[] poly = mesh.getPolygons().get(0);
            System.out.println("  First polygon indices: " + java.util.Arrays.toString(poly));
        }
    }
}

mesh.getControlPoints() Retornando a List<Vector4> Onde x, y, z Levar a posição e w O coordenado é homogêneo (normalmente 1.0).

mesh.getPolygons() Retornando a List<int[]> onde cada array é o conjunto ordenado de índices do ponto de controle para uma face.

Passo 6: Aplique opções de carga específicas para o formato

Para controlar o modo como um arquivo é interpretado, passe uma opção de carga para Scene.fromFile() ou scene.open().

Ficheiros de OBJ - ObjLoadOptions:

import com.aspose.threed.Scene;
import com.aspose.threed.ObjLoadOptions;

ObjLoadOptions options = new ObjLoadOptions();
options.setFlipCoordinateSystem(true);  // Convert right-hand Y-up to Z-up
options.setScale(0.01);                  // Convert centimetres to metres
options.setEnableMaterials(true);        // Load the .mtl material file alongside
options.setNormalizeNormal(true);        // Normalize all normals to unit length

Scene scene = Scene.fromFile("model.obj", options);

Ficheiros GLTF / GLB - GltfLoadOptions:

import com.aspose.threed.Scene;
import com.aspose.threed.GltfLoadOptions;

GltfLoadOptions options = new GltfLoadOptions();
options.setFlipCoordinateSystem(true);  // Flip the coordinate system if needed

Scene scene = Scene.fromFile("model.glb", options);

Ficheiros de STL - StlLoadOptions:

import com.aspose.threed.Scene;
import com.aspose.threed.StlLoadOptions;

StlLoadOptions options = new StlLoadOptions();
options.setFlipCoordinateSystem(true);
options.setRecalculateNormal(true);  // Recompute normals from face geometry

Scene scene = Scene.fromFile("model.stl", options);

Formatos de importação suportados

Formato	Extensão	Notas
OBJ	`.obj`	Wavefront OBJ; opcional `.mtl` arquivo; permite-se a `ObjLoadOptions.setEnableMaterials(true)`
STL	`.stl`	ASCII e modos binários são auto-detectados
GSTF	`.gltf`, `.glb`	glTF 2.0; as variantes binárias GLB e JSON ambos suportados
FBX	`.fbx`	Fbx binário suportado

Problemas comuns e fixos

IOException Em carga Verifique o caminho do arquivo é correto e o arquivos existe. Use caminhos absolutos durante o desenvolvimento para eliminar a ambigüidade de trabalho-direcionamento.

NullPointerException Acesso à entidade Nem todos os nódulos têm geometria. sempre guardar com node.getEntity() instanceof Mesh antes de fazer o casting ou iterate node.getEntities() para lidar com nodos com vários objetos ligados.

Sistema de Coordenação MISMATCH — Se o modelo carregado aparecer flipped ou rotado, use setFlipCoordinateSystem(true) A partir da categoria de opções de carga (ObjLoadOptions, GltfLoadOptions,ou StlLoadOptions).

A cena carrega, mas getChildNodes() É vazio Alguns arquivos armazenam geometria em subescenas, em vez do nodo de raiz. scene.getSubScenes() e inspeccionar o nodo de raiz de cada subscena.

Perguntas frequentes (FAQ)

Quais formatos posso carregar?

OBJ, STL (binário e ASCII), glTF 2.0 / GLB, e FBX. Detecção de formato é automaticamente baseada na extensão do arquivo quando você chama Scene.fromFile().

Posso carregar de um fluxo?

Sim sim. scene.open(InputStream) e Scene.fromStream(InputStream) Ambos aceitam um Java. InputStream.Você também pode passar por um FileFormat Parâmetro quando o fluxo não leva uma extensão.

A biblioteca é segura?

Cada um Scene A instância é independente e não compartilha o estado mutável com outras instâncias.

Como posso ler os contos de poligônio sem iterar cada rosto?

Chamado mesh.getPolygonCount() para uma conta completa direta.