Format Load and Save Options

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

Les classes d’opcions de format controlen com @aspose/3d llegeix i escriu formats de fitxer 3D específics. Passeu una instància d’opcions com a segon argument a scene.open() (load options) o scene.save() (save options). Totes les classes d’opcions amplien o bé 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

Opcions de desament per a glTF 2.0 JSON (.gltf) i GLB binari (.glb) de sortida.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, l’exportador escriu un fitxer binari GLB autònom. Quan `false`, escriu un JSON `.gltf` fitxer amb un complement `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	Enumerations `true`, les coordenades UV V s’inverteixen (`v = 1 - v`). L’especificació glTF 2.0 utilitza un origen UV a dalt a l’esquerra, de manera que aquest senyal és `true` per defecte per coincidir amb la majoria de les convencions d’eines DCC.

Enumerations

Exporta una escena com a GLB binari amb les coordenades UV preservades tal com són.

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

Opcions de càrrega per a JSON glTF 2.0 (.gltf) i binari GLB (.glb) fitxers.

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

GltfLoadOptions amplia LoadOptions. No exposa propietats addicionals visibles per a l’usuari a la versió actual; passa una instància per defecte per utilitzar els valors recomanats per defecte.

Enumerations

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

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

ObjLoadOptions

Carrega opcions per a Wavefront OBJ (.obj) fitxers.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, l’importador llegeix la `.mtl` biblioteca de materials referenciada per la `mtllib` directiva i omple les propietats del material als nodes de la malla. Estableix a `false` per ometre la càrrega del material.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, els eixos Y i Z s’intercanvien durant la importació per convertir entre sistemes de coordenades Y-up i Z-up.
`normalizeNormal`	`boolean`	`true`	Enumerations `true`, les normals de vèrtex llegides del fitxer es normalitzen a una longitud unitària durant la importació.
`scale`	`number`	`1.0`	Factor d’escala uniforme aplicat a tota la geometria durant la importació.

Enumerations

Carrega un fitxer OBJ sense resoldre la seva biblioteca de materials.

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

Desa opcions per a Wavefront OBJ (.obj) sortida.

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

Nota: Exportació OBJ (canExport: false) no està totalment suportada en aquesta versió de la biblioteca. Intentar desar a OBJ pot generar un error d’operació no suportada.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, un companion `.mtl` el fitxer de biblioteca de materials s’escriu al costat del `.obj` sortida.
`pointCloud`	`boolean`	`false`	Enumerations `true`, la geometria s’exporta com a núvol de punts (només vèrtexs, sense definicions de cares).
`verbose`	`boolean`	`false`	Enumerations `true`, s’inclouen comentaris diagnòstics addicionals a la sortida OBJ.
`serializeW`	`boolean`	`false`	Enumerations `true`, el component W de les coordenades homogènies del vèrtex s’escriu al fitxer.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, els eixos Y i Z s’intercanvien durant l’exportació.
`applyUnitScale`	`boolean`	`false`	Enumerations `true`, l’escala d’unitats de l’escena s’aplica a totes les coordenades de la geometria durant l’exportació.

StlSaveOptions

Opcions de desament per a STL (.stl) de sortida.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, la sortida s’escriu com a STL binari (compacte, no llegible per humans). Quan `false`, s’escriu STL ASCII.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, els eixos Y i Z s’intercanvien durant l’exportació.
`scale`	`number`	`1.0`	Factor d’escala uniforme aplicat a tota la geometria durant l’exportació.

Enumerations

Desa una malla com a STL binari.

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

Opcions de càrrega per a STL (.stl) fitxers. Tant STL ASCII com binari són compatibles automàticament; cap propietat controla la detecció.

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

StlLoadOptions estèn LoadOptions i no exposa propietats addicionals visibles per a l’usuari en la versió actual.

FbxSaveOptions

Opcions de desament per a FBX (.fbx) de sortida.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`embedTextures`	`boolean`	`false`	Enumerations `true`, les imatges de textura referenciades s’incorporen dins l’arxiu binari FBX. Quan `false`, els camins de textura s’escriuen com a referències externes.

Enumerations

Exporta un fitxer FBX amb totes les textures incrustades.

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

Opcions de càrrega per a FBX (.fbx) fitxers. Admet tant FBX binari com ASCII.

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

FbxLoadOptions extends LoadOptions i no exposa propietats addicionals visibles per a l’usuari a la versió actual.

Classes base

LoadOptions

findProperty(propertyName).

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

Passa un LoadOptions instància de subclasse a scene.open(filePath, options) o scene.openFromBuffer(buffer, options).

SaveOptions

A3DObject, SceneObject, Entity — les classes base arrel compartides per a tots els objectes @aspose/3d.

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

Passa un SaveOptions instància de subclasse a scene.save(filePath, options).