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
| Requisito | Detalle |
|---|---|
| Java | JDK 21 o posterior |
| Herramienta de compilación | Maven or Gradle |
| OS | Windows, 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, leerMeshgeometría, acceder a normales de vértices y UVs - Transformar nodos: establecer traslación, rotación y escala a través del
Transformclase - Aplicar materiales: asignar
MaterialoPbrMateriala nodos - Exportar a cualquier formato compatible con
scene.save() - Construir geometría: crear
Meshobjetos 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
- Guía de instalación: configuración y verificación de Maven/Gradle
- Guía del desarrollador: Soporte de formatos, operaciones de malla, materiales y transformaciones
- Características y funcionalidades: Análisis profundo de cada área de características con ejemplos Java