Load and Save Options — Aspose.3D FOSS for Java
FbxSaveOptions
Todas las operaciones de importación y exportación aceptan un objeto de opciones opcional derivado de LoadOptions o SaveOptions. Pase la subclase apropiada a Scene.open() o Scene.save() para controlar el comportamiento específico del formato.
FbxSaveOptions: com.aspose.threed
import com.aspose.threed.*;LoadOptions
Clase base para todos los objetos de opciones de carga. Extiende A3DObject.
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | El formato con el que está asociada esta configuración (solo lectura) |
SaveOptions
Clase base para todos los objetos de opciones de guardado. Extiende A3DObject.
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | El formato con el que está asociada esta config (solo lectura) |
ObjLoadOptions
Opciones de carga para archivos Wavefront OBJ (.obj).
ObjLoadOptions opts = new ObjLoadOptions(); opts.setFlipCoordinateSystem(true); opts.setScale(0.01); Scene scene = new Scene(); scene.open(“model.obj”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | --------------------------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | Invertir el sistema de coordenadas al importar |
| `enableMaterials` | `boolean` | `getEnableMaterials()` | `setEnableMaterials(boolean)` | `true` | Cargar el archivo adjunto `.mtl` archivo de material |
| `scale` | `double` | `getScale()` | `setScale(double)` | `1.0` | Escala uniforme aplicada a toda la geometría importada |
| `normalizeNormal` | `boolean` | `getNormalizeNormal()` | `setNormalizeNormal(boolean)` | `true` | Normalizar los vectores normales importados a longitud unitaria |
---
## ObjSaveOptions
Opciones de guardado para archivos Wavefront OBJ.
ObjSaveOptions opts = new ObjSaveOptions();
opts.setEnableMaterials(false);
scene.save("output.obj", opts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
applyUnitScale | boolean | getApplyUnitScale() | setApplyUnitScale(boolean) | false | Aplicar el factor de escala de unidad de la escena a las coordenadas exportadas |
pointCloud | boolean | getPointCloud() | setPointCloud(boolean) | false | Exportar solo vértices (sin caras de polígonos) |
verbose | boolean | getVerbose() | setVerbose(boolean) | false | Incluir comentarios OBJ adicionales en la salida |
serializeW | boolean | getSerializeW() | setSerializeW(boolean) | false | Escribir el componente W de los puntos de control |
enableMaterials | boolean | getEnableMaterials() | setEnableMaterials(boolean) | true | Escribe un .mtl archivo de material y haz referencia a él desde el .obj |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | Invierte el sistema de coordenadas al exportar |
GltfLoadOptions
Cargar opciones para archivos glTF 2.0 y GLB (.gltf, .glb).
GltfLoadOptions opts = new GltfLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“model.gltf”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | -------------------------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | Invertir el sistema de coordenadas al importar |
| `prettyPrint` | `boolean` | `getPrettyPrint()` | `setPrettyPrint(boolean)` | `false` | Formatear el JSON de salida con sangría para mayor legibilidad |
---
## GltfSaveOptions
Opciones de guardado para la salida glTF 2.0 y GLB.
```java
import com.aspose.threed.*;
import com.aspose.threed.FileContentType;
// Save as glTF JSON
GltfSaveOptions opts = new GltfSaveOptions();
scene.save("output.gltf", opts);
// Save as GLB (binary glTF)
GltfSaveOptions glbOpts = new GltfSaveOptions();
glbOpts.setContentType(FileContentType.BINARY);
scene.save("output.glb", glbOpts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
contentType | FileContentType | getContentType() | setContentType(FileContentType) | FileContentType.ASCII | Establecer en FileContentType.BINARY para producir un archivo GLB autónomo; establecer en FileContentType.ASCII para JSON .gltf con un búfer externo |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | Invertir el sistema de coordenadas al exportar |
prettyPrint | boolean | getPrettyPrint() | setPrettyPrint(boolean) | false | Formatea el JSON de salida con sangría para mayor legibilidad |
bufferFilePrefix | String | getBufferFilePrefix() | setBufferFilePrefix(String) | null | Prefijo para los nombres de archivos de búfer externos |
saveExtras | String | getSaveExtras() | setSaveExtras(String) | null | Datos personalizados de extras para incluir en la salida glTF |
StlLoadOptions
Cargar opciones para archivos STL (.stl).
StlLoadOptions opts = new StlLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“part.stl”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | ----------------- | --------------------------- | ---------------------------------- | -------------- | -------------------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | Invertir el sistema de coordenadas al importar |
| `recalculateNormal` | `boolean` | `getRecalculateNormal()` | `setRecalculateNormal(boolean)` | `false` | Recalcular normales a partir de la geometría al importar |
| `contentType` | `FileContentType` | `getContentType()` | `setContentType(FileContentType)` | -- | Sugerencia para la detección de STL binario vs ASCII |
---
## StlSaveOptions
Opciones de guardado para la salida STL.
StlSaveOptions opts = new StlSaveOptions();
opts.setContentType(FileContentType.BINARY);
scene.save("output.stl", opts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | Invertir el sistema de coordenadas al exportar |
axisSystem | AxisSystem | getAxisSystem() | setAxisSystem(AxisSystem) | – | Sobrescribir el sistema de ejes de destino al exportar |
contentType | FileContentType | getContentType() | setContentType(FileContentType) | FileContentType.BINARY | Establecer en BINARY o ASCII para controlar el formato de salida |
FbxLoadOptions
Cargar opciones para archivos FBX (.fbx).
FbxLoadOptions opts = new FbxLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“animation.fbx”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | ---------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | Invertir el sistema de coordenadas al importar |
---
## FbxSaveOptions
**Nota:** La exportación FBX es **no disponible** en la edición Java FOSS. FBX solo es compatible para importación. El `FbxSaveOptions` La clase existe en la API pero producirá un error si se usa para guardar. Use OBJ, STL, glTF o GLB para exportar en su lugar.
---
## Ver también
- [Referencia de la clase FileFormat](/3d/java/file-format/)
- [Referencia de la clase Scene](/3d/java/scene/)