Començar

Començant amb Aspose.3D FOSS per a Java

Benvingut a aspose-3d-foss, una biblioteca gratuïta i de codi obert Java per a carregar, construir i exportar escenes 3D. Aquesta guia us porta d’un projecte nou a una escena funcional en minuts.


Requisits previs

RequisitDetall
JavaJDK 21 o posterior
Eina de construccióMaven o Gradle
OSWindows, macOS, o Linux

Instal·lació

Afegiu la dependència Maven al vostre pom.xml:

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

Verifica:

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.");
    }
}

Vegeu el Guia d’instal·lació per a la configuració de Gradle i els passos de verificació.


Què pots fer

Un cop instal·lat, pots immediatament:

  • Carrega Fitxers OBJ, STL, glTF 2.0 / GLB i FBX via scene.open()
  • Inspecciona jerarquies d’escena: recorre Node arbres, llegeix Mesh geometria, accedeix a les normals de vèrtex i a les UVs
  • Transforma nodes: estableix la translació, rotació i escala a través del Transform classe
  • Aplica materials: assigna Material o PbrMaterial a nodes
  • Exporta a qualsevol format compatible amb scene.save()
  • Construeix geometria: crea Mesh objectes programàticament amb punts de control i polígons

Inici ràpid

Carrega un fitxer 3D, imprimeix la jerarquia de l’escena i torna a desar-lo en 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");
    }
}

Propers passos

 Català