Premiers pas

Premiers pas avec Aspose.3D FOSS pour Java

Bienvenue à aspose-3d-foss, une bibliothèque Java gratuite et open-source pour charger, construire et exporter des scènes 3D. Ce guide vous fait passer d’un projet vierge à une scène fonctionnelle en quelques minutes.

Prérequis

ExigenceDétail
JavaJDK 21 ou version ultérieure
Outil de constructionMaven ou Gradle
OSWindows, macOS ou Linux

Installation

Ajoutez la dépendance Maven à votre pom.xml:

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

Vérifiez :

import com.aspose.threed.Scene;

public class Main {
    public static void main(String[] args) {
        Scene scene = new Scene();
        System.out.println("aspose-3d-foss loaded successfully.");
    }
}

Voir le Guide d’installation pour la configuration de Gradle et les étapes de vérification.

Ce que vous pouvez faire

Une fois installé, vous pouvez immédiatement :

  • Charger Fichiers OBJ, STL, glTF 2.0 / GLB et FBX via scene.open()
  • Inspecter hiérarchies de scène : parcourir Node arbres, lire Mesh géométrie, accéder aux normales de sommet et aux UV
  • Transformer nœuds : définir la translation, la rotation et l’échelle via le Transform classe
  • Appliquer les matériaux: assigner Material ou PbrMaterial aux nœuds
  • Exporter vers n’importe quel format pris en charge avec scene.save()
  • Construire la géométrie: créer Mesh des objets programmatiquement avec des points de contrôle et des polygones

Démarrage rapide

Chargez un fichier 3D, affichez la hiérarchie de la scène et réenregistrez au format GLB :

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

public class QuickStart {
    public static void main(String[] args) throws Exception {
        Scene scene = new Scene();
        scene.open("input.obj");

        System.out.println("Root children: " + scene.getRootNode().getChildNodes().size());
        for (Node node : scene.getRootNode().getChildNodes()) {
            String entityType = node.getEntity() != null
                ? node.getEntity().getClass().getSimpleName()
                : "no entity";
            System.out.println("  " + node.getName() + " [" + entityType + "]");
        }

        scene.save("output.glb");
        System.out.println("Saved output.glb");
    }
}

Étapes suivantes

 Français