Comenzando

Comenzando con Aspose.3D FOSS para Java

Bienvenido a aspose-3d-foss, una biblioteca gratuita y de código abierto Java para cargar, construir y exportar escenas 3D. Esta guía te lleva desde un proyecto nuevo hasta una escena funcional en minutos.


Requisitos previos

RequisitoDetalle
JavaJDK 21 o posterior
Herramienta de compilaciónMaven or Gradle
OSWindows, macOS, or Linux

Instalación

Agrega la dependencia Maven a tu pom.xml:

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

Verifique:

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

Ver el Guía de instalación para la configuración de Gradle y los pasos de verificación.


Qué puede hacer

Una vez instalado, puede inmediatamente:

  • Cargar archivos OBJ, STL, glTF 2.0 / GLB y FBX a través de scene.open()
  • Inspeccionar jerarquías de escena: recorrer Node árboles, leer Mesh geometría, acceder a normales de vértices y UVs
  • Transformar nodos: establecer traslación, rotación y escala a través del Transform clase
  • Aplicar materiales: asignar Material o PbrMaterial a nodos
  • Exportar a cualquier formato compatible con scene.save()
  • Construir geometría: crear Mesh objetos programáticamente con puntos de control y polígonos

Inicio rápido

Cargue un archivo 3D, imprima la jerarquía de la escena y vuelva a guardarlo en formato 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");
    }
}

Próximos pasos

 Español