Format Load and Save Options

Balík: @aspose/3d (v24.12.0)

Triedy možností formátu riadia, ako @aspose/3d čítajú a zapisujú konkrétne 3D formáty súborov. Prejdite inštanciu možností ako druhý argument do scene.open() (load options) alebo scene.save() (save options). Všetky triedy možností rozširujú buď LoadOptions alebo 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

Uložiť možnosti pre glTF 2.0 JSON (.gltf) a binárny GLB (.glb) výstup.

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

Properties

Properties	Properties	Properties	Properties
`binaryMode`	`boolean`	`false`	Properties `true`, exportér zapíše samostatný binárny GLB súbor. Keď `false`, zapíše JSON `.gltf` súbor s doprovodným `.bin` bufferom.
`flipTexCoordV`	`boolean`	`true`	Properties `true`, UV V súradnice sú prevrátené (`v = 1 - v`). Špecifikácia glTF 2.0 používa UV pôvod vľavo hore, takže tento príznak je `true` štandardne, aby zodpovedal väčšine konvencií DCC nástrojov.

Properties

Exportujte scénu ako binárny GLB s UV súradnicami zachovanými v pôvodnej podobe.

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

Možnosti načítania pre glTF 2.0 JSON (.gltf) a binárny GLB (.glb) súbory.

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

GltfLoadOptions rozširuje LoadOptions. Neodhaľuje ďalšie používateľské vlastnosti v aktuálnej verzii; odovzdajte predvolenú inštanciu na použitie odporúčaných predvolených hodnôt.

Properties

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

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

ObjLoadOptions

Načítanie možností pre Wavefront OBJ (.obj) súbory.

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

Properties

Properties	Properties	Properties	Properties
`enableMaterials`	`boolean`	`true`	Properties `true`, importér číta `.mtl` knižnicu materiálov odkazovanú `mtllib` direktíva a naplní vlastnosti materiálu na uzloch siete. Nastavte na `false` na preskočenie načítania materiálu.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, osi Y a Z sa počas importu prehodia, aby sa previedli medzi súradnicovými systémami Y-up a Z-up.
`normalizeNormal`	`boolean`	`true`	Properties `true`, normály vrcholov načítané zo súboru sa počas importu normalizujú na jednotkovú dĺžku.
`scale`	`number`	`1.0`	Jednotný škálovací faktor aplikovaný na všetku geometriu počas importu.

Properties

Načítajte OBJ súbor bez rozpoznania jeho knižnice materiálov.

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

Možnosti ukladania pre Wavefront OBJ (.obj) výstup.

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

Poznámka: OBJ export (canExport: false) nie je v tejto verzii knižnice plne podporovaný. Pokus o uloženie do OBJ môže vyvolať chybu nepodporovanej operácie.

Properties

Properties	Properties	Properties	Properties
`enableMaterials`	`boolean`	`true`	Properties `true`, spoločník `.mtl` súbor knižnice materiálov sa zapíše vedľa `.obj` výstupu.
`pointCloud`	`boolean`	`false`	Properties `true`, geometria sa exportuje ako bodový oblak (iba vrcholy, žiadne definície plôch).
`verbose`	`boolean`	`false`	Properties `true`, do OBJ výstupu sú zahrnuté ďalšie diagnostické komentáre.
`serializeW`	`boolean`	`false`	Properties `true`, komponenta W homogénnych súradníc vrcholov sa zapíše do súboru.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, osi Y a Z sa pri exporte prehodia.
`applyUnitScale`	`boolean`	`false`	Properties `true`, jednotková mierka scény sa pri exporte použije na všetky súradnice geometrie.

StlSaveOptions

Možnosti ukladania pre STL (.stl) výstup.

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

Properties

Properties	Properties	Properties	Properties
`binaryMode`	`boolean`	`false`	Properties `true`, výstup sa zapíše ako binárny STL (kompaktný, nečitateľný pre človeka). Keď `false`, zapíše sa ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, osi Y a Z sa pri exporte prehodia.
`scale`	`number`	`1.0`	Jednotný mierkový faktor sa pri exporte použije na celú geometriu.

Properties

Uložte sieť ako binárny STL.

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

Možnosti načítania pre STL (.stl) súbory. ASCII aj binárny STL sú automaticky podporované; žiadna vlastnosť neovláda detekciu.

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

StlLoadOptions rozširuje LoadOptions a v aktuálnej verzii neodhaľuje ďalšie používateľom prístupné vlastnosti.

FbxSaveOptions

Možnosti ukladania pre FBX (.fbx) výstup.

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

Properties

Properties	Properties	Properties	Properties
`embedTextures`	`boolean`	`false`	Properties `true`, referencované textúrové obrázky sú vložené do binárneho archívu FBX. Keď `false`, cesty k textúram sú zapísané ako externé odkazy.

Properties

Exportujte FBX súbor so všetkými vloženými textúrami.

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

Možnosti načítania pre FBX (.fbx) súbory. Podporuje binárny aj ASCII FBX.

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

FbxLoadOptions rozširuje LoadOptions a v aktuálnej verzii neodhaľuje ďalšie používateľské vlastnosti.

Základné triedy

LoadOptions

Základná trieda pre všetky objekty možností načítania.

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

Predajte a LoadOptions inštanciu podtriedy do scene.open(filePath, options) alebo scene.openFromBuffer(buffer, options).

SaveOptions

Základná trieda pre všetky objekty možností ukladania.

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

Predajte a SaveOptions inštanciu podtriedy do scene.save(filePath, options).