Com començar amb Aspose.3D FOSS per a Java

Aspose.3D FOSS per a Java és una biblioteca gratuïta, llicenciada pel MIT per carregar, manipular i salvar arxius 3D - no requereixen binaris nadius, pura Java de Maven Central.

Guia de pas a pas

Pas 1: Afegir la dependència de Maven

Afegeix la següent dependència a la teva pom.xml (Java 21 o posterior requereix):

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

Verifica la instal·lació carregada correctament:

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

Pas 2: Import de les classes necessàries

Importar les classes bàsicas per a la càrrega i manipulació de l’escena:

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

Pas 3: Carregar un fitxer 3D

Utilitzar Scene.fromFile() per carregar qualsevol format recolzat. la biblioteca detecta el format automàticament de l’extenssió del fitxer:

import com.aspose.threed.Scene;

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

o utilitzar el open() Mètode de la instància:

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

Pas 4: Travessar el gràfic de l’escena

Una escena carregada és un arbre de Node Els objectes que es corren a scene.getRootNode():

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);

Pas 5: Salvar a un format diferent

Utilitzar Scene.save() per exportar a qualsevol format de sortida suportat. la biblioteca detecta el Format de sortida de l’extenssió del fitxer:

import com.aspose.threed.Scene;

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

Problemes comuns i fixos

FileNotFoundException Quan crida Scene.fromFile() El camí que has passat no existeix o utilitza el separador equivocat. java.nio.file.Paths.get() Per assegurar-se que el camí de fitxer és correcte.

Error de format desconegut Assegureu-vos que l’extenssió de fitxer coincideix amb el format real. La biblioteca detecta el format per Extensions per open() i fromFile().Passar un paràmetre de format explícit per sobreridejar.

Escena buit després de la càrrega Alguns formats binaris poden requerir opcions de càrrega específiques.Trobem utilitzar una sobrecarga explícita amb opcions de càrrega si la configuració estàndard produeix una escena buida.

UnsupportedOperationException Per certes mètodes Alguns mètodes (rendering d’escena, marcatge d’aigua) no estan disponibles en l’edició FOSS. Consulteu la documentació de limitacions abans d’utilitzar característiques avançades.

Preguntes freqüents

Aspose.3D FOSS requereix qualsevol DLL nativa?

No. La biblioteca és pura Java amb cap dependència nativa o binàries externes necessàries.

Quines versions de Java estan compatibles?

La biblioteca funciona en els contenidors de Windows, macOS, Linux i Docker.

La biblioteca és lliure per a ús comercial?

Sí. Es publica sota la Llicència MIT. Pot utilitzar, modificar i redistribuir-la per a qualsevol propòsit, incloses les aplicacions comercials.

Quins formats 3D puc llegir i escriure?

La biblioteca dóna suport a OBJ, STL, glTF 2.0 / GLB i FBX per a la lectura i l’escriptura. Utilitza el Scene.save() API basada en extensió per exportar a qualsevol format recolzat.

Puc crear una escena 3D de la fusta?

Són: Construïm un Scene sense cap argument, afegir nodes infantils a scene.getRootNode(),i Es pot guardar al format desitjat.