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

Aspose.3D FOSS for Java

Carga, crea, transforma y exporta escenas 3D desde Java — gratuito y de código abierto.

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

Documentación GitHub

Biblioteca Java de código abierto para el procesamiento de archivos 3D

Aspose.3D FOSS para Java es una biblioteca con licencia MIT, pure-Java, para trabajar con formatos de archivo 3D. Añade una única dependencia Maven y comienza inmediatamente a leer, construir y escribir escenas 3D sin instalar ningún runtime nativo, SDK externo o renderizador de terceros.

La biblioteca expone una API de grafo de escena limpia construida alrededor de Scene, Node, Mesh, Camera y Transform, el mismo modelo conceptual usado por herramientas 3D profesionales. El soporte de formatos incluye OBJ (con carga de materiales .mtl), STL (binario y ASCII, verificado en ida y vuelta), glTF 2.0 (materiales PBR), GLB (glTF binario) y FBX (solo importación). Las opciones de carga y guardado por formato le permiten controlar la inversión de coordenadas, escala, normalización de normales y carga de materiales sin escribir código de análisis específico de cada formato.

Aspose.3D FOSS requiere Java 21 o posterior y se ejecuta idénticamente en Windows, macOS y Linux CI runners, contenedores Docker y entornos serverless. No hay ninguna extensión nativa que compilar ni paquete del sistema que instalar.

Compatibilidad con formatos 3D y API de grafo de escena

  • OBJ / MTL: Carga archivos Wavefront OBJ con sus definiciones de material adjuntas.
  • STL: Lee y escribe STL tanto binario como ASCII con verificación completa de ida y vuelta.
  • glTF 2.0 / GLB: Carga de materiales PBR y exportación mediante GltfSaveOptions. Usa setContentType(FileContentType.BINARY) para la salida GLB.
  • FBX: Soporte de importación para cargar archivos FBX (exportación no disponible).
  • API de grafo de escena: Scene, Node, Mesh, Camera, Transform.

Dónde se puede usar Aspose.3D FOSS

  • Canales de validación de activos: Verifica, reorienta y vuelve a exportar activos 3D en CI.
  • Herramientas de desarrollo de juegos: Procesa por lotes mallas OBJ y STL sin un motor nativo.
  • Flujos de trabajo de impresión 3D: Lee, valida y vuelve a exportar archivos STL.
  • Web backends: Sirve puntos finales de conversión 3D en Docker o funciones sin servidor.
  • Content migration: Convierte entre familias de formatos a gran escala.

Opciones por formato y control de coordenadas

  • Orientación del sistema de coordenadas: Invierte ejes y ajusta la escala por formato sin código personalizado.
  • Normalización de normales: Normaliza automáticamente las normales de vértices al cargar o guardar.
  • Control de carga de materiales: Habilita o deshabilita la carga de MTL/texturas para un análisis más rápido.
  • Salida con formato legible: Elige JSON glTF compacto o legible para humanos mediante opciones.
  • Fidelidad de ida y vuelta: Los nodos desconocidos del grafo de escena se conservan literalmente al volver a guardar.

Experiencia del desarrollador

Aspose.3D FOSS para instalaciones Java con una única dependencia Maven (com.aspose:aspose-3d-foss:26.1.0). La biblioteca es puro Java, sin extensiones nativas que compilar y sin paquetes del sistema que instalar.

La API de grafo de escena refleja el modelo conceptual de las herramientas 3D profesionales, por lo que la curva de aprendizaje es corta para cualquiera familiarizado con el modelo de datos de Three.js o Blender. La biblioteca tiene licencia MIT, es de código abierto y acepta informes de errores y contribuciones en GitHub.

Cargar una escena OBJ y exportar como glTF

Agrega la dependencia Maven, luego llama a Scene.fromFile("model.obj") para cargar el archivo OBJ junto con sus definiciones de material MTL. Una única llamada a scene.save() con la extensión .gltf escribe un archivo JSON glTF 2.0, sin necesidad de un registro de formatos ni de un objeto convertidor.

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

import com.aspose.threed.*;

// Cargar un archivo OBJ (con materiales .mtl)
Scene scene = Scene.fromFile("model.obj");

// Exportar como glTF 2.0
scene.save("model.gltf");

Convertir STL a glTF con GltfSaveOptions

Para generar un archivo glTF con ajustes del sistema de coordenadas, pase una instancia de GltfSaveOptions con setFlipCoordinateSystem(true). El mismo patrón se aplica a todas las opciones por formato — reemplace la clase de opciones por el formato que está apuntando.

import com.aspose.threed.*;

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

// Guardar como glTF con opciones
GltfSaveOptions opts = new GltfSaveOptions();
opts.setFlipCoordinateSystem(true);
opts.setPrettyPrint(true);
scene.save("mesh.gltf", opts);

Preguntas frecuentes

¿Qué es Aspose.3D FOSS para Java?

Es una biblioteca gratuita, bajo licencia MIT, pure-Java para cargar, manipular y guardar escenas 3D sin instalar ningún runtime nativo ni SDK externo.

¿Qué formatos 3D son compatibles?

OBJ (con .mtl), STL (binario y ASCII), glTF 2.0, GLB (glTF binario) y FBX (solo importación). Cada formato tiene una clase dedicada de opciones de carga/guardado.

¿Requiere alguna dependencia nativa?

No. Aspose.3D FOSS para Java es pure Java sin extensiones nativas. Se ejecuta en Windows, macOS y Linux sin ningún paso de compilación.

¿Cómo lo instalo?

Agrega la dependencia Maven com.aspose:aspose-3d-foss:26.1.0 a tu proyecto. No se requieren paquetes del sistema adicionales ni extensiones nativas.

¿Puedo controlar la orientación del sistema de coordenadas?

Sí. Las clases de opciones por formato te permiten invertir ejes, ajustar la escala y normalizar normales sin escribir código de análisis específico de cada formato.

¿Qué versiones de Java son compatibles?

Java 21 y posteriores son compatibles. La biblioteca se ejecuta idénticamente en todos los principales sistemas operativos.

¿Está disponible el código fuente?

Sí. La biblioteca tiene licencia MIT y está alojada en GitHub. Los informes de errores y las solicitudes de extracción son bienvenidos.

  

Recursos de soporte y aprendizaje

 Español