Questions fréquemment posées

Licence & Source ouverte

Quel est le modèle de licence pour Aspose.3D FOSS pour Java?

Aspose.3D FOSS pour Java est sorti sous la licence MIT. Vous pouvez l’utiliser dans des projets personnels, commerciaux et open-source sans restriction. Aucune clé de licence ou activation n’est requise. Le code source est disponible sur GitHub.

Puis-je utiliser Aspose.3D FOSS pour Java dans un produit commercial?

Oui. La licence MIT permet un usage illimité dans les produits commerciaux. Aucun paiement de royalty, serveur de licence ou connexion internet n’est requis à temps utile.

Installation & Exigences

Comment installer Aspose.3D FOSS pour Java ?

Ajoutez la dépendance à votre pom.xml:

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

Importer le package dans vos fichiers source :

import com.aspose.threed.*;

Quelle version Java est nécessaire ?

Aspose.3D FOSS pour Java nécessite JDK 21 ou plus tard. Il est entièrement autonome avec aucune dépendance native et aucun binaire spécifique à la plateforme.

Formats de soutien

Quels formats de fichier 3D peuvent Aspose.3D FOSS pour Java lire et écrire?

La version actuelle prend en charge les formats suivants :

Comment détecter automatiquement le format d’un fichier ?

Utiliser FileFormat.getFormatByExtension(filePath) Pour voir le format par extension de fichier :

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

Comment puis-je utiliser les options de chargement ou d’économie pour un format spécifique?

Passez un objet de format-specifique à Scene.open() ou Scene.save().Par exemple, Pour permettre le coordonnées de système à fléchir lors du chargement de la glTF :

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

Pour l’exportation de glTF avec JSON imprimé :

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

De même, FbxLoadOptions Il est disponible pour la configuration d’importation FBX.

Utilisation de l’API

Comment puis-je télécharger un modèle 3D d’un fichier ?

Utilisez la usine statique Scene.fromFile(filePath) pour un chargement d’un pas, ou construire une Scene et appeler scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

Comment créer une nouvelle scène vide et la sauver ?

Construire A Scene,Ajouter des nœuds comme nécessaire, puis appeler scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

Comment puis-je traverser le graphique de scène ?

Accès au node de la racine par le biais scene.getRootNode() Et il a dit à ses enfants :

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

Comment puis-je enregistrer une scène dans un format spécifique?

Passez la voie de sortie avec l’extension cible — Aspose.3D détecte le format du pour un contrôle explicite, passez une FileFormat ou des options de sauvegarde :

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

Les limites connues

Est-ce que la 3D est disponible dans cette version ?

Non, le Scene.render() Méthodes de jeter UnsupportedOperationException Dans le présent FOSS. Rendering n’est pas encore mis en œuvre. Utilisez cette bibliothèque pour l’importation, le traitement, la, et exporter les données de scène 3D uniquement.

Toutes les fonctionnalités FBX sont-elles soutenues ?

FBX importation est soutenue pour les données de géométrie et scène graphique. mise en œuvre — appeler sauvegarder avec le format FBX jets ExportException.Complex FBX Importer des fonctionnalités telles que les animations intégrées, les restrictions et le FBX propriétaire Les extensions ne peuvent pas être complètement conservées.