1. Produits
  2.   Aspose.3D
  3.   Aspose.3D FOSS for Java

Aspose.3D FOSS pour Java

Chargez, créez, transformez et exportez des scènes 3D depuis Java — gratuit et open source.

Aspose.3D FOSS for Java Aspose.3D FOSS
for Java

Documentation GitHub

Bibliothèque Java open source pour le traitement de fichiers 3D

Aspose.3D FOSS pour Java est une bibliothèque sous licence MIT, pure-Java, pour travailler avec les formats de fichiers 3D. Ajoutez une seule dépendance Maven et commencez immédiatement à lire, construire et écrire des scènes 3D sans installer aucun runtime natif, SDK externe ou moteur de rendu tiers.

La bibliothèque expose une API de graphe de scène propre, construite autour de Scene, Node, Mesh, Camera et Transform, le même modèle conceptuel utilisé par les outils 3D professionnels. La prise en charge des formats comprend OBJ (avec chargement des matériaux .mtl), STL (binaire et ASCII, vérifié en aller‑retour), glTF 2.0 (matériaux PBR), GLB (glTF binaire) et FBX (import uniquement). Les options de chargement et d’enregistrement par format vous permettent de contrôler le retournement des coordonnées, l’échelle, la normalisation des normales et le chargement des matériaux sans écrire de code d’analyse spécifique à un format.

Aspose.3D FOSS nécessite Java 21 ou ultérieur et s’exécute de façon identique sur les runners CI Windows, macOS et Linux, les conteneurs Docker et les environnements serverless. Il n’y a aucune extension native à compiler et aucun paquet système à installer.

Prise en charge des formats 3D et API de graphe de scène

  • OBJ / MTL : Chargez les fichiers Wavefront OBJ avec les définitions de matériaux associées.
  • STL : Lisez et écrivez les fichiers STL binaires et ASCII avec une vérification complète en aller‑retour.
  • glTF 2.0 / GLB : Chargement de matériaux PBR et exportation via GltfSaveOptions. Utilisez setContentType(FileContentType.BINARY) pour la sortie GLB.
  • FBX : Prise en charge de l’importation pour charger les fichiers FBX (exportation non disponible).
  • API du graphe de scène : Scene, Node, Mesh, Camera, Transform.

Où Aspose.3D FOSS peut être utilisé

  • Pipelines de validation des actifs : Vérifier, réorienter et réexporter les actifs 3D en CI.
  • Outils de développement de jeux : Traiter par lots les maillages OBJ et STL sans moteur natif.
  • Flux de travail d’impression 3D : Lire, valider et réexporter les fichiers STL.
  • Web backends: Servir des points de terminaison de conversion 3D dans Docker ou des fonctions serverless.
  • Content migration: Convertir entre des familles de formats à grande échelle.

Options par format et contrôle des coordonnées

  • Orientation du système de coordonnées : Inverser les axes et ajuster l’échelle selon le format sans code personnalisé.
  • Normalisation des normales : Normaliser automatiquement les normales des sommets lors du chargement ou de l’enregistrement.
  • Contrôle du chargement des matériaux : Activer ou désactiver le chargement des fichiers MTL/texture pour une analyse plus rapide.
  • Sortie formatée : Choisir un JSON glTF compact ou lisible par l’homme via les options.
  • Fidélité en aller-retour : Les nœuds inconnus du graphe de scène sont conservés mot pour mot lors du réenregistrement.

Expérience développeur

Aspose.3D FOSS pour les installations Java avec une seule dépendance Maven (com.aspose:aspose-3d-foss:26.1.0). La bibliothèque est pure Java, sans extensions natives à compiler et sans paquets système à installer.

L’API de graphe de scène reflète le modèle conceptuel des outils 3D professionnels, de sorte que la courbe d’apprentissage est courte pour quiconque familier avec le modèle de données de Three.js ou de Blender. La bibliothèque est sous licence MIT, open-source, et accueille les rapports de bugs et les contributions sur GitHub.

Charger une scène OBJ et l’exporter en glTF

Ajoutez la dépendance Maven, puis appelez Scene.fromFile("model.obj") pour charger le fichier OBJ ainsi que ses définitions de matériaux MTL. Un seul appel scene.save() avec l’extension .gltf écrit un fichier JSON glTF 2.0, sans registre de formats ni objet convertisseur requis.

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

import com.aspose.threed.*;

// Charger un fichier OBJ (avec des matériaux .mtl)
Scene scene = Scene.fromFile("model.obj");

// Exporter en glTF 2.0
scene.save("model.gltf");

Convertir STL en glTF avec GltfSaveOptions

Pour produire un fichier glTF avec des ajustements du système de coordonnées, transmettez une instance de GltfSaveOptions avec setFlipCoordinateSystem(true). Le même schéma s’applique à toutes les options spécifiques à chaque format — remplacez la classe d’options par le format que vous ciblez.

import com.aspose.threed.*;

Scene scene = new Scene();
scene.open("mesh.stl");

// Enregistrer en glTF avec options
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Foire aux questions

Qu’est-ce que Aspose.3D FOSS pour Java ?

C’est une bibliothèque pure-Java gratuite, MIT-licensed, pour charger, manipuler et enregistrer des scènes 3D sans installer de runtime natif ni de SDK externe.

Quels formats 3D sont pris en charge ?

OBJ (avec .mtl), STL (binaire et ASCII), glTF 2.0, GLB (glTF binaire) et FBX (import uniquement). Chaque format possède une classe d’options de chargement/enregistrement dédiée.

Cela nécessite-t-il des dépendances natives ?

Non. Aspose.3D FOSS pour Java est pure Java sans aucune extension native. Il fonctionne sous Windows, macOS et Linux sans aucune étape de compilation.

Comment l’installer ?

Ajoutez la dépendance Maven com.aspose:aspose-3d-foss:26.1.0 à votre projet. Aucun paquet système supplémentaire ni extension native n’est requis.

Puis-je contrôler l’orientation du système de coordonnées ?

Oui. Les classes d’options par format vous permettent d’inverser les axes, d’ajuster l’échelle et de normaliser les normales sans écrire de code d’analyse propre à chaque format.

Quelles versions de Java sont prises en charge ?

Java 21 et versions ultérieures sont pris en charge. La bibliothèque s’exécute de manière identique sur tous les principaux systèmes d’exploitation.

Le code source est-il disponible ?

Oui. La bibliothèque est sous licence MIT et hébergée sur GitHub. Les rapports de bugs et les pull requests sont les bienvenus.

  

Ressources de support et d'apprentissage

 Français