Comment commencer avec Aspose.3D FOSS pour Java

Aspose.3D FOSS pour Java est une bibliothèque gratuite, certifiée par MIT pour le chargement, la manipulation et l’épargne de fichiers 3D - aucun binaire natif requis, pure Java de Maven Central.

Guide étape par étapes

Étape 1 : Ajouter la dépendance Maven

Ajoutez la dépendance suivante à votre pom.xml (Java 21 ou plus tard requis):

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

Vérifiez que l’installation est correctement chargée :

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

Étape 2 : Importation des classes requises

Importation des classes de base pour le chargement et la manipulation de scène:

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

Étape 3 : Remplissez un fichier 3D

Utiliser Scene.fromFile() pour télécharger tout format supporté. la bibliothèque détecte le format Automatikement de l’extension du fichier :

import com.aspose.threed.Scene;

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

Ou utiliser le open() Méthode de l’instance :

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

Étape 4 : Traversez le graphique de scène

Une scène chargée est un arbre de Node Les objets enracinés à 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);

Étape 5 : Enregistrer dans un format différent

Utiliser Scene.save() pour exporter à tout format de sortie supporté. la bibliothèque détecte le Formats de sortie du fichier extension :

import com.aspose.threed.Scene;

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

Problèmes communs et fixations

FileNotFoundException Quand on appelle Scene.fromFile() Le chemin que vous avez traversé n’existe pas ou utilisez le séparateur incorrect. java.nio.file.Paths.get() Pour que le fichier soit correct.

Erreur de format inconnu Assurez-vous que l’extension de fichier correspond au format réel.La bibliothèque détecte le format par Extension pour open() et fromFile().Passez un paramètre de format explicite pour surrider.

Scène vide après le chargement Certains formats binaires peuvent nécessiter des options de charge spécifiques. essayez d’utiliser un surcharge explicite avec les options de charge si le défaut produit une scène vide.

UnsupportedOperationException Pour certaines méthodes Certaines méthodes (rédaction de scène, marquage d’eau) ne sont pas disponibles dans l’édition FOSS. Vérifiez la documentation des limitations avant d’utiliser les fonctionnalités avancées.

Questions fréquemment posées

Aspose.3D FOSS nécessite-t-il des DLL indigènes ?

La bibliothèque est pure Java avec aucune dépendance native ou des binaires externes nécessaires.

Quelles versions Java sont-elles soutenues ?

La bibliothèque fonctionne sur les conteneurs Windows, macOS, Linux et Docker.

La bibliothèque est-elle gratuite pour une utilisation commerciale ?

Oui. Il est libéré sous la licence MIT. Vous pouvez l’utiliser, modifier et redistribuer à tout but, y compris les applications commerciales.

Quels sont les formats 3D que je peux lire et écrire ?

La bibliothèque prend en charge OBJ, STL, glTF 2.0 / GLB et FBX pour la lecture et l’écriture. Utilisez le Scene.save() API basée sur l’extension pour exporter à tout format supporté.

Puis-je créer une scène 3D à partir de la crème ?

Construire A Scene sans arguments, ajoutez les nodes de l’enfant à scene.getRootNode(),et Enregistrer dans le format souhaité.