Preguntas frecuentes

Licencia y Open Source

¿Cuál es el modelo de licencia para Aspose.3D FOSS para Java?

Aspose.3D FOSS para Java se libera bajo la Licencia MIT. Puedes utilizarla en proyectos personales, comerciales y de código abierto sin restricción. No se requiere clave de licencia o activación de tiempo de trabajo. El código fuente está disponible en GitHub.

¿Puedo usar Aspose.3D FOSS para Java en un producto comercial?

La Licencia MIT permite el uso ilimitado en productos comerciales.No se requiere pago de la royalidad, servidor de licencia o conexión a Internet en tiempo real.

Instalación y Requisitos

¿Cómo instalar Aspose.3D FOSS para Java?

Añade la dependencia de Maven a tu pom.xml:

<dependency>
  <groupId>org.aspose</groupId>
  <artifactId>aspose-3d-foss</artifactId>
  <version>26.5.0</version>
</dependency>

A continuación, importar el paquete en sus archivos de fuente:

import com.aspose.threed.*;

¿Qué versión Java es necesaria?

Aspose.3D FOSS para Java requiere JDK 21 o más tarde. es totalmente autónomo con ninguna dependencia nativa y no hay binarios específicos de plataforma.

Formato de apoyo

¿Qué formatos de archivo 3D pueden leer y escribir Aspose.3D FOSS para Java?

La versión actual soporta los siguientes formatos:

¿Cómo detectar automáticamente el formato de un archivo?

Uso FileFormat.getFormatByExtension(filePath) Para ver el formato por extensión de archivo:

FileFormat fmt = FileFormat.getFormatByExtension("model.gltf");
System.out.println(fmt.getCanImport()); // true
System.out.println(fmt.getCanExport()); // true

¿Cómo puedo usar las opciones de carga o almacenamiento para un formato específico?

Pasar una opción específica de formato a Scene.open() o Scene.save().Por ejemplo, para permitir que el sistema de coordenadas se flipe cuando carga glTF:

GltfLoadOptions opts = new GltfLoadOptions();
opts.setFlipCoordinateSystem(true);

Scene scene = new Scene();
scene.open("input.gltf", opts);

Para la exportación de glTF con JSON imprimado:

GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setPrettyPrint(true);
scene.save("output.gltf", saveOpts);

De igual manera, FbxLoadOptions Disponible para la configuración de importación FBX.

El uso de API

¿Cómo puedo cargar un modelo 3D de un archivo?

Utilice la fábrica estática Scene.fromFile(filePath) para una carga de un paso, o construir una Scene y llamar scene.open(filePath):

// Option 1 — static factory (recommended)
Scene scene = Scene.fromFile("model.obj");

// Option 2 — instance method
Scene scene2 = new Scene();
scene2.open("model.fbx");

¿Cómo puedo crear una nueva escena vacía y salvarla?

Construye a Scene, añade nódulos según sea necesario, luego llame scene.save(filePath):

Scene scene = new Scene();
Node child = scene.getRootNode().createChildNode("Box");
scene.save("output.glb");

¿Cómo puedo cruzar el gráfico de escena?

Acceso al nodo de raíz a través del scene.getRootNode() y iterate a sus hijos:

Scene scene = Scene.fromFile("model.gltf");
Node root = scene.getRootNode();

for (Node child : root.getChildNodes()) {
    System.out.println(child.getName());
}

¿Cómo puedo guardar una escena en un formato específico?

Pasar el camino de salida con la extensión del objetivo — Aspose.3D detecta el formato desde el para un control explícito, pasar a FileFormat O el objeto de las opciones:

// Auto-detect output format from extension
scene.save("output.stl");

// Explicit format (using options object)
GltfSaveOptions opts = new GltfSaveOptions();
opts.setBufferFilePrefix("buffer_");
scene.save("output.gltf", opts);

Conocidas limitaciones

¿Es la presentación 3D disponible en esta edición?

No. El Scene.render() Metodología de la lanza UnsupportedOperationException En el actual FOSS release. Rendering no se ha implementado todavía. Use esta biblioteca para la importación, procesamiento, Exporta solo datos de escena 3D.

¿Todas las funciones de FBX están apoyadas?

La importación de FBX se apoya para geometría y datos de gráficos de escena. implementado — llamando a salvar con el formato FBX lanza ExportException.Complejo FBX Importaciones como animaciones envueltas, restricciones y FBX propiedad Las extensiones no pueden ser totalmente conservadas.