Format Load and Save Options

Pacchetto: @aspose/3d (v24.12.0)

Le classi di opzioni di formato controllano come @aspose/3d legge e scrive formati di file 3D specifici. Passa un’istanza di opzioni come secondo argomento a scene.open() (load options) o scene.save() (save options). Tutte le classi di opzioni estendono o LoadOptions o 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

Opzioni di salvataggio per glTF 2.0 JSON (.gltf) e binario GLB (.glb) output.

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
// or
import { GltfSaveOptions } from '@aspose/3d';

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`binaryMode`	`boolean`	`false`	SaveOptions `true`, l’esportatore scrive un file GLB binario autonomo. Quando `false`, scrive un JSON `.gltf` file con un buffer di accompagnamento `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	SaveOptions `true`, le coordinate UV V sono invertite (`v = 1 - v`). La specifica glTF 2.0 utilizza un’origine UV in alto a sinistra, quindi questo flag è `true` per impostazione predefinita per corrispondere alla maggior parte delle convenzioni degli strumenti DCC.

SaveOptions

Esporta una scena come GLB binario mantenendo inalterate le coordinate UV.

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

Opzioni di caricamento per JSON glTF 2.0 (.gltf) e GLB binario (.glb) file.

import { GltfLoadOptions } from '@aspose/3d/formats/gltf';

GltfLoadOptions estende LoadOptions. Non espone proprietà aggiuntive rivolte all’utente nella versione corrente; passa un’istanza predefinita per utilizzare le impostazioni consigliate.

SaveOptions

import { Scene } from '@aspose/3d';
import { GltfLoadOptions } from '@aspose/3d/formats/gltf';

const scene = new Scene();
scene.open('model.glb', new GltfLoadOptions());

ObjLoadOptions

Opzioni di caricamento per Wavefront OBJ (.obj) file.

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
// or
import { ObjLoadOptions } from '@aspose/3d';

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`enableMaterials`	`boolean`	`true`	SaveOptions `true`, l’importatore legge il `.mtl` libreria dei materiali referenziata da `mtllib` direttiva e popola le proprietà dei materiali sui nodi della mesh. Imposta su `false` per saltare il caricamento dei materiali.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, gli assi Y e Z vengono scambiati durante l’importazione per convertire tra sistemi di coordinate Y-up e Z-up.
`normalizeNormal`	`boolean`	`true`	SaveOptions `true`, le normali dei vertici lette dal file vengono normalizzate a lunghezza unitaria durante l’importazione.
`scale`	`number`	`1.0`	Fattore di scala uniforme applicato a tutta la geometria durante l’importazione.

SaveOptions

Carica un file OBJ senza risolvere la sua libreria dei materiali.

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

Opzioni di salvataggio per Wavefront OBJ (.obj) output.

import { ObjSaveOptions } from '@aspose/3d/formats/obj';

Nota: Esportazione OBJ (canExport: false) non è completamente supportato in questa versione della libreria. Tentare di salvare in OBJ potrebbe generare un errore di operazione non supportata.

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`enableMaterials`	`boolean`	`true`	SaveOptions `true`, un compagno `.mtl` il file della libreria dei materiali viene scritto accanto al `.obj` output.
`pointCloud`	`boolean`	`false`	SaveOptions `true`, la geometria viene esportata come nuvola di punti (solo vertici, nessuna definizione di facce).
`verbose`	`boolean`	`false`	SaveOptions `true`, vengono inclusi commenti diagnostici aggiuntivi nell’output OBJ.
`serializeW`	`boolean`	`false`	SaveOptions `true`, la componente W delle coordinate omogenee dei vertici viene scritta nel file.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, gli assi Y e Z vengono scambiati durante l’esportazione.
`applyUnitScale`	`boolean`	`false`	SaveOptions `true`, la scala unità della scena viene applicata a tutte le coordinate della geometria durante l’esportazione.

StlSaveOptions

Opzioni di salvataggio per STL (.stl) output.

import { StlSaveOptions } from '@aspose/3d/formats/stl';
// or
import { StlSaveOptions } from '@aspose/3d';

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`binaryMode`	`boolean`	`false`	SaveOptions `true`, l’output viene scritto come STL binario (compatto, non leggibile dall’uomo). Quando `false`, viene scritto STL ASCII.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, gli assi Y e Z vengono scambiati durante l’esportazione.
`scale`	`number`	`1.0`	Fattore di scala uniforme applicato a tutta la geometria durante l’esportazione.

SaveOptions

Salva una mesh in formato STL binario.

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

Opzioni di caricamento per STL (.stl) file. Sia STL ASCII che binario sono supportati automaticamente; nessuna proprietà controlla il rilevamento.

import { StlLoadOptions } from '@aspose/3d/formats/stl';

StlLoadOptions estende LoadOptions e non espone proprietà aggiuntive visibili all’utente nella versione corrente.

FbxSaveOptions

Opzioni di salvataggio per FBX (.fbx) output.

import { FbxSaveOptions } from '@aspose/3d/formats/fbx';
// or
import { FbxSaveOptions } from '@aspose/3d';

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`embedTextures`	`boolean`	`false`	SaveOptions `true`, le immagini texture di riferimento sono incorporate all’interno dell’archivio binario FBX. Quando `false`, i percorsi delle texture sono scritti come riferimenti esterni.

SaveOptions

Esporta un file FBX con tutte le texture incorporate.

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

Opzioni di caricamento per FBX (.fbx) file. Supporta sia FBX binario che ASCII.

import { FbxLoadOptions } from '@aspose/3d/formats/fbx';

FbxLoadOptions estende LoadOptions e non espone proprietà aggiuntive visibili all’utente nella versione corrente.

Classi base

LoadOptions

Classe base per tutti gli oggetti di opzioni di caricamento.

import { LoadOptions } from '@aspose/3d';

Passa un LoadOptions istanza della sottoclasse a scene.open(filePath, options) o scene.openFromBuffer(buffer, options).

SaveOptions

Classe base per tutti gli oggetti di opzioni di salvataggio.

import { SaveOptions } from '@aspose/3d';

Passa un SaveOptions istanza della sottoclasse a scene.save(filePath, options).