Format Load and Save Options

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

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
binaryModebooleanfalseColladaSaveOptions true, l’exportateur écrit un fichier binaire GLB autonome. Lorsque false, il écrit un JSON .gltf fichier avec un .bin tampon.
flipTexCoordVbooleantrueColladaSaveOptions 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

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
enableMaterialsbooleantrueColladaSaveOptions 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.
flipCoordinateSystembooleanfalseColladaSaveOptions 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.
normalizeNormalbooleantrueColladaSaveOptions true, les normales de sommet lues depuis le fichier sont normalisées à une longueur unité lors de l’importation.
scalenumber1.0Facteur 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

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
enableMaterialsbooleantrueColladaSaveOptions true, un compagnon .mtl fichier de bibliothèque de matériaux est écrit à côté du .obj sortie.
pointCloudbooleanfalseColladaSaveOptions true, la géométrie est exportée sous forme de nuage de points (seulement les sommets, aucune définition de faces).
verbosebooleanfalseColladaSaveOptions true, des commentaires de diagnostic supplémentaires sont inclus dans la sortie OBJ.
serializeWbooleanfalseColladaSaveOptions true, le composant W des coordonnées homogènes des sommets est écrit dans le fichier.
flipCoordinateSystembooleanfalseColladaSaveOptions true, les axes Y et Z sont inversés lors de l’exportation.
applyUnitScalebooleanfalseColladaSaveOptions 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

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
binaryModebooleanfalseColladaSaveOptions true, la sortie est écrite au format STL binaire (compact, non lisible par l’homme). Lorsque false, le STL ASCII est écrit.
flipCoordinateSystembooleanfalseColladaSaveOptions true, les axes Y et Z sont échangés lors de l’exportation.
scalenumber1.0Facteur 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

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
embedTexturesbooleanfalseColladaSaveOptions 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).

 Français