Load and Save Options — Aspose.3D FOSS for Java
FbxSaveOptions
Toutes les opérations d’importation et d’exportation acceptent un objet d’options facultatif dérivé de LoadOptions ou SaveOptions. Passez la sous‑classe appropriée à Scene.open() ou Scene.save() pour contrôler le comportement spécifique au format.
FbxSaveOptions: com.aspose.threed
import com.aspose.threed.*;LoadOptions
Classe de base pour tous les objets d’option de chargement. Étend A3DObject.
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | Le format auquel cette configuration est associée (lecture seule) |
SaveOptions
Classe de base pour tous les objets d’option d’enregistrement. Étend A3DObject.
ObjLoadOptions
Options de chargement pour les fichiers 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` | Inverser le système de coordonnées lors de l'importation |
| `enableMaterials` | `boolean` | `getEnableMaterials()` | `setEnableMaterials(boolean)` | `true` | Charger le fichier joint `.mtl` fichier de matériau |
| `scale` | `double` | `getScale()` | `setScale(double)` | `1.0` | Échelle uniforme appliquée à toute la géométrie importée |
| `normalizeNormal` | `boolean` | `getNormalizeNormal()` | `setNormalizeNormal(boolean)` | `true` | Normaliser les vecteurs normaux importés à une longueur unitaire |
---
## ObjSaveOptions
Options d'enregistrement pour les fichiers 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 | Appliquer le facteur d’échelle d’unité de la scène aux coordonnées exportées |
pointCloud | boolean | getPointCloud() | setPointCloud(boolean) | false | Exporter uniquement les sommets (pas de faces polygonales) |
verbose | boolean | getVerbose() | setVerbose(boolean) | false | Inclure des commentaires OBJ supplémentaires dans la sortie |
serializeW | boolean | getSerializeW() | setSerializeW(boolean) | false | Écrire le composant W des points de contrôle |
enableMaterials | boolean | getEnableMaterials() | setEnableMaterials(boolean) | true | Écrivez un .mtl fichier de matériau et faites‑y référence depuis le .obj |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | Inversez le système de coordonnées lors de l’exportation |
GltfLoadOptions
Charger les options pour les fichiers glTF 2.0 et 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` | Inverser le système de coordonnées à l'importation |
| `prettyPrint` | `boolean` | `getPrettyPrint()` | `setPrettyPrint(boolean)` | `false` | Formater le JSON de sortie avec indentation pour une meilleure lisibilité |
---
## GltfSaveOptions
Options d'enregistrement pour la sortie glTF 2.0 et 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 | Définir sur FileContentType.BINARY pour produire un fichier GLB autonome; définir sur FileContentType.ASCII pour JSON .gltf avec un tampon externe |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | Inverser le système de coordonnées à l’exportation |
prettyPrint | boolean | getPrettyPrint() | setPrettyPrint(boolean) | false | Formatez le JSON de sortie avec une indentation pour la lisibilité |
bufferFilePrefix | String | getBufferFilePrefix() | setBufferFilePrefix(String) | null | Préfixe pour les noms de fichiers de buffers externes |
saveExtras | String | getSaveExtras() | setSaveExtras(String) | null | Données supplémentaires personnalisées à inclure dans la sortie glTF |
StlLoadOptions
Options de chargement pour les fichiers 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` | Inverser le système de coordonnées à l'importation |
| `recalculateNormal` | `boolean` | `getRecalculateNormal()` | `setRecalculateNormal(boolean)` | `false` | Recalculer les normales à partir de la géométrie lors de l'importation |
| `contentType` | `FileContentType` | `getContentType()` | `setContentType(FileContentType)` | -- | Indice pour la détection binaire/ASCII du STL |
---
## StlSaveOptions
Options d'enregistrement pour la sortie 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 | Inverser le système de coordonnées à l’exportation |
axisSystem | AxisSystem | getAxisSystem() | setAxisSystem(AxisSystem) | – | Remplacer le système d’axes cible à l’exportation |
contentType | FileContentType | getContentType() | setContentType(FileContentType) | FileContentType.BINARY | Définir sur BINARY ou ASCII pour contrôler le format de sortie |
FbxLoadOptions
Charger les options pour les fichiers 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` | Inverser le système de coordonnées lors de l'importation |
---
## FbxSaveOptions
**Remarque :** L'exportation FBX est **non disponible** dans l'édition Java FOSS. FBX n'est pris en charge que pour l'importation. Le `FbxSaveOptions` classe existe dans l'API mais générera une erreur si elle est utilisée pour enregistrer. Utilisez OBJ, STL, glTF ou GLB pour l'exportation à la place.
---
## Voir aussi
- [Référence de la classe FileFormat](/3d/java/file-format/)
- [Référence de la classe Scene](/3d/java/scene/)