Format Load and Save Options
Package : @aspose/3d (v24.12.0)
Les classes d’options de format contrôlent comment @aspose/3d lisent et écrivent des formats de fichiers 3D spécifiques. Passez une instance d’options comme deuxième argument à scene.open() (load options) ou scene.save() (save options). Toutes les classes d’options étendent soit LoadOptions ou SaveOptions.
// Load with options
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
const opts = new ObjLoadOptions();
opts.enableMaterials = false;
scene.open('mesh.obj', opts);
// Save with options
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;
scene.save('output.glb', saveOpts);GltfSaveOptions
Options d’enregistrement pour glTF 2.0 JSON (.gltf) et GLB binaire (.glb) de sortie.
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
// or
import { GltfSaveOptions } from '@aspose/3d';ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
binaryMode | boolean | false | ColladaSaveOptions true, l’exportateur écrit un fichier binaire GLB autonome. Lorsque false, il écrit un JSON .gltf fichier avec un .bin tampon. |
flipTexCoordV | boolean | true | ColladaSaveOptions true, les coordonnées UV V sont inversées (v = 1 - v). La spécification glTF 2.0 utilise une origine UV en haut à gauche, donc ce drapeau est true activé par défaut pour correspondre à la plupart des conventions des outils DCC. |
ColladaSaveOptions
Exportez une scène au format GLB binaire avec les coordonnées UV conservées telles quelles.
import { Scene } from '@aspose/3d';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
const scene = new Scene();
scene.open('model.obj');
const opts = new GltfSaveOptions();
opts.binaryMode = true;
opts.flipTexCoordV = false;
scene.save('output.glb', opts);
console.log('Saved as binary GLB without UV flip.');GltfLoadOptions
Options de chargement pour le JSON glTF 2.0 (.gltf) et le GLB binaire (.glb) fichiers.
import { GltfLoadOptions } from '@aspose/3d/formats/gltf';GltfLoadOptions étend LoadOptions. Il n’expose pas de propriétés supplémentaires visibles par l’utilisateur dans la version actuelle ; passez une instance par défaut pour utiliser les valeurs recommandées.
ColladaSaveOptions
import { Scene } from '@aspose/3d';
import { GltfLoadOptions } from '@aspose/3d/formats/gltf';
const scene = new Scene();
scene.open('model.glb', new GltfLoadOptions());ObjLoadOptions
Charger les options pour Wavefront OBJ (.obj) fichiers.
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
// or
import { ObjLoadOptions } from '@aspose/3d';ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
enableMaterials | boolean | true | ColladaSaveOptions true, l’importateur lit le .mtl bibliothèque de matériaux référencée par le mtllib directive et remplit les propriétés des matériaux sur les nœuds du maillage. Définir à false pour ignorer le chargement des matériaux. |
flipCoordinateSystem | boolean | false | ColladaSaveOptions true, les axes Y et Z sont échangés lors de l’importation pour convertir entre les systèmes de coordonnées Y-up et Z-up. |
normalizeNormal | boolean | true | ColladaSaveOptions true, les normales de sommet lues depuis le fichier sont normalisées à une longueur unité lors de l’importation. |
scale | number | 1.0 | Facteur d’échelle uniforme appliqué à toute la géométrie lors de l’importation. |
ColladaSaveOptions
Chargez un fichier OBJ sans résoudre sa bibliothèque de matériaux.
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
const opts = new ObjLoadOptions();
opts.enableMaterials = false;
const scene = new Scene();
scene.open('mesh.obj', opts);
console.log(`Root children: ${scene.rootNode.childNodes.length}`);ObjSaveOptions
Enregistrer les options pour Wavefront OBJ (.obj) sortie.
import { ObjSaveOptions } from '@aspose/3d/formats/obj';Remarque : Export OBJ (canExport: false) n’est pas entièrement pris en charge dans cette version de la bibliothèque. Tenter d’enregistrer au format OBJ peut déclencher une erreur d’opération non prise en charge.
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
enableMaterials | boolean | true | ColladaSaveOptions true, un compagnon .mtl fichier de bibliothèque de matériaux est écrit à côté du .obj sortie. |
pointCloud | boolean | false | ColladaSaveOptions true, la géométrie est exportée sous forme de nuage de points (seulement les sommets, aucune définition de faces). |
verbose | boolean | false | ColladaSaveOptions true, des commentaires de diagnostic supplémentaires sont inclus dans la sortie OBJ. |
serializeW | boolean | false | ColladaSaveOptions true, le composant W des coordonnées homogènes des sommets est écrit dans le fichier. |
flipCoordinateSystem | boolean | false | ColladaSaveOptions true, les axes Y et Z sont inversés lors de l’exportation. |
applyUnitScale | boolean | false | ColladaSaveOptions true, l’échelle d’unité de la scène est appliquée à toutes les coordonnées de géométrie lors de l’exportation. |
StlSaveOptions
Options d’enregistrement pour STL (.stl) de sortie.
import { StlSaveOptions } from '@aspose/3d/formats/stl';
// or
import { StlSaveOptions } from '@aspose/3d';ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
binaryMode | boolean | false | ColladaSaveOptions true, la sortie est écrite au format STL binaire (compact, non lisible par l’homme). Lorsque false, le STL ASCII est écrit. |
flipCoordinateSystem | boolean | false | ColladaSaveOptions true, les axes Y et Z sont échangés lors de l’exportation. |
scale | number | 1.0 | Facteur d’échelle uniforme appliqué à toute la géométrie lors de l’exportation. |
ColladaSaveOptions
Enregistrez un maillage au format STL binaire.
import { Scene } from '@aspose/3d';
import { StlSaveOptions } from '@aspose/3d/formats/stl';
const scene = new Scene();
scene.open('model.obj');
const opts = new StlSaveOptions();
opts.binaryMode = true;
scene.save('output.stl', opts);
console.log('Saved binary STL.');StlLoadOptions
Options de chargement pour STL (.stl) fichiers. Les STL ASCII et binaires sont pris en charge automatiquement ; aucune propriété ne contrôle la détection.
import { StlLoadOptions } from '@aspose/3d/formats/stl';StlLoadOptions étend LoadOptions et n’expose pas de propriétés supplémentaires visibles par l’utilisateur dans la version actuelle.
FbxSaveOptions
Options d’enregistrement pour FBX (.fbx) sortie.
import { FbxSaveOptions } from '@aspose/3d/formats/fbx';
// or
import { FbxSaveOptions } from '@aspose/3d';ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
embedTextures | boolean | false | ColladaSaveOptions true, les images de texture référencées sont intégrées dans l’archive binaire FBX. Lorsque false, les chemins de texture sont écrits comme références externes. |
ColladaSaveOptions
Exportez un fichier FBX avec toutes les textures intégrées.
import { Scene } from '@aspose/3d';
import { FbxSaveOptions } from '@aspose/3d/formats/fbx';
const scene = new Scene();
scene.open('character.gltf');
const opts = new FbxSaveOptions();
opts.embedTextures = true;
scene.save('character-embedded.fbx', opts);
console.log('Saved FBX with embedded textures.');FbxLoadOptions
Options de chargement pour FBX (.fbx) fichiers. Prend en charge à la fois le FBX binaire et ASCII.
import { FbxLoadOptions } from '@aspose/3d/formats/fbx';FbxLoadOptions étend LoadOptions et n’expose pas de propriétés supplémentaires visibles par l’utilisateur dans la version actuelle.
Classes de base
LoadOptions
Classe de base pour tous les objets d’options de chargement.
import { LoadOptions } from '@aspose/3d';Passez un LoadOptions instance de sous-classe à scene.open(filePath, options) ou scene.openFromBuffer(buffer, options).
SaveOptions
Classe de base pour tous les objets d’options d’enregistrement.
import { SaveOptions } from '@aspose/3d';Passez un SaveOptions instance de sous‑classe à scene.save(filePath, options).