Load and Save Options

Load and Save Options — Aspose.3D FOSS for Java

FbxSaveOptions

Tutte le operazioni di importazione ed esportazione accettano un oggetto opzioni facoltativo derivato da LoadOptions oppure SaveOptions. Passa la sottoclasse appropriata a Scene.open() oppure Scene.save() per controllare il comportamento specifico del formato.

FbxSaveOptions: com.aspose.threed

import com.aspose.threed.*;

LoadOptions

Classe base per tutti gli oggetti di opzioni di caricamento. Estende A3DObject.

FbxSaveOptions	FbxSaveOptions	FbxSaveOptions	FbxSaveOptions
`fileFormat`	`FileFormat`	`getFileFormat()`	Il formato a cui questa configurazione è associata (sola lettura)

SaveOptions

Classe base per tutti gli oggetti di opzioni di salvataggio. Estende A3DObject.

ObjLoadOptions

Opzioni di caricamento per file 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`        | Inverti il sistema di coordinate durante l'importazione     |
| `enableMaterials`      | `boolean`      | `getEnableMaterials()`      | `setEnableMaterials(boolean)`      | `true`         | Carica il file associato `.mtl` file materiale              |
| `scale`                | `double`       | `getScale()`                | `setScale(double)`                 | `1.0`          | Scala uniforme applicata a tutta la geometria importata     |
| `normalizeNormal`      | `boolean`      | `getNormalizeNormal()`      | `setNormalizeNormal(boolean)`      | `true`         | Normalizza i vettori normali importati a lunghezza unitaria |

---

## ObjSaveOptions

Opzioni di salvataggio per i file 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`	Applica il fattore di scala unitario della scena alle coordinate esportate
`pointCloud`	`boolean`	`getPointCloud()`	`setPointCloud(boolean)`	`false`	Esporta solo i vertici (senza facce poligonali)
`verbose`	`boolean`	`getVerbose()`	`setVerbose(boolean)`	`false`	Includi commenti OBJ aggiuntivi nell’output
`serializeW`	`boolean`	`getSerializeW()`	`setSerializeW(boolean)`	`false`	Scrivi il componente W dei punti di controllo
`enableMaterials`	`boolean`	`getEnableMaterials()`	`setEnableMaterials(boolean)`	`true`	Scrivi un `.mtl` file di materiale e riferiscilo da `.obj`
`flipCoordinateSystem`	`boolean`	`getFlipCoordinateSystem()`	`setFlipCoordinateSystem(boolean)`	`false`	Capovolgi il sistema di coordinate all’esportazione

GltfLoadOptions

Opzioni di caricamento per file glTF 2.0 e 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`        | Capovolgi il sistema di coordinate all'importazione                 |
| `prettyPrint`          | `boolean`      | `getPrettyPrint()`          | `setPrettyPrint(boolean)`          | `false`        | Formatta il JSON di output con rientri per una migliore leggibilità |

---

## GltfSaveOptions

Opzioni di salvataggio per l'output glTF 2.0 e 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`	Imposta a `FileContentType.BINARY` per produrre un file GLB autonomo; imposta a `FileContentType.ASCII` per JSON `.gltf` con un buffer esterno
`flipCoordinateSystem`	`boolean`	`getFlipCoordinateSystem()`	`setFlipCoordinateSystem(boolean)`	`false`	Capovolgi il sistema di coordinate all’esportazione
`prettyPrint`	`boolean`	`getPrettyPrint()`	`setPrettyPrint(boolean)`	`false`	Formatta il JSON di output con indentazione per una migliore leggibilità
`bufferFilePrefix`	`String`	`getBufferFilePrefix()`	`setBufferFilePrefix(String)`	`null`	Prefisso per i nomi dei file buffer esterni
`saveExtras`	`String`	`getSaveExtras()`	`setSaveExtras(String)`	`null`	Dati extra personalizzati da includere nell’output glTF

StlLoadOptions

Opzioni di caricamento per i file 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`        | Capovolgi il sistema di coordinate all'importazione   |
| `recalculateNormal`    | `boolean`         | `getRecalculateNormal()`    | `setRecalculateNormal(boolean)`    | `false`        | Ricalcola le normali dalla geometria all'importazione |
| `contentType`          | `FileContentType` | `getContentType()`          | `setContentType(FileContentType)`  | --             | Suggerimento per il rilevamento STL binario vs ASCII  |

---

## StlSaveOptions

Salva le opzioni per l'output 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`	Capovolgi il sistema di coordinate all’esportazione
`axisSystem`	`AxisSystem`	`getAxisSystem()`	`setAxisSystem(AxisSystem)`	–	Sovrascrivi il sistema di assi di destinazione all’esportazione
`contentType`	`FileContentType`	`getContentType()`	`setContentType(FileContentType)`	`FileContentType.BINARY`	Imposta su `BINARY` oppure `ASCII` per controllare il formato di output

FbxLoadOptions

Carica opzioni per i file 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`        | Capovolgi il sistema di coordinate all'importazione |

---

## FbxSaveOptions

**Nota:** L'esportazione FBX è **non disponibile** nella versione FOSS di Java. FBX è supportato solo per l'importazione. Il `FbxSaveOptions` la classe esiste nell'API ma produrrà un errore se usata per salvare. Usa OBJ, STL, glTF o GLB per l'esportazione invece.

---

## Vedi anche

- [Riferimento della classe FileFormat](/3d/java/file-format/)
- [Riferimento della classe Scene](/3d/java/scene/)