Format Load and Save Options

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

Formato parinkčių klasės valdo, kaip @aspose/3d skaito ir rašo konkrečius 3D failų formatus. Perduokite parinkčių egzempliorių kaip antrąjį argumentą į scene.open() (load options) arba scene.save() (save options). Visos parinkčių klasės išplečia arba LoadOptions arba 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

Išsaugojimo parinktys glTF 2.0 JSON (.gltf).glb) išvestis.

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

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`binaryMode`	`boolean`	`false`	SaveOptions `true`, eksportuotojas įrašo savarankišką dvejetainį GLB failą. Kai `false`, jis įrašo JSON `.gltf` failą su gretimu `.bin` buferis.
`flipTexCoordV`	`boolean`	`true`	SaveOptions `true`, UV V koordinatės yra apverstos (`v = 1 - v`). glTF 2.0 specifikacija naudoja viršutinį kairį UV pradžios tašką, todėl ši žymė yra `true` numatyta, kad atitiktų daugumą DCC įrankių konvencijų.

SaveOptions

Eksportuokite sceną kaip binarinį GLB, išlaikant UV koordinates nepakitusias.

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

Įkėlimo parinktys glTF 2.0 JSON (.gltf) ir binarinis GLB (.glb) failai.

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

GltfLoadOptions plečia LoadOptions. Ši versija neatskleidžia papildomų vartotojui matomų savybių; perduokite numatytąją egzempliorių, kad naudotumėte rekomenduojamus numatytuosius nustatymus.

SaveOptions

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

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

ObjLoadOptions

Įkelti parinktis Wavefront OBJ (.obj) failai.

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

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`enableMaterials`	`boolean`	`true`	SaveOptions `true`, importuotojas skaito `.mtl` medžiagų biblioteką, į kurią nurodo `mtllib` direktyva ir užpildo medžiagos savybes tinklo mazguose. Nustatykite į `false` praleisti medžiagos įkėlimą.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, Y ir Z ašys yra sukeistos importuojant, kad būtų konvertuojama tarp Y‑aukščio ir Z‑aukščio koordinačių sistemų.
`normalizeNormal`	`boolean`	`true`	SaveOptions `true`, viršūnių normalės, perskaitytos iš failo, importuojant normalizuojamos iki vieneto ilgio.
`scale`	`number`	`1.0`	Uniformus mastelio koeficientas taikomas visai geometrijai importuojant.

SaveOptions

Įkelti OBJ failą nesprendžiant jo medžiagų bibliotekos.

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

Išsaugojimo parinktys Wavefront OBJ (.obj) išvestis.

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

Pastaba: OBJ eksportas (canExport: false) nėra visiškai palaikoma šioje bibliotekos versijoje. Bandymas įrašyti į OBJ gali sukelti nepalaikomos operacijos klaidą.

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`enableMaterials`	`boolean`	`true`	SaveOptions `true`, lydimas `.mtl` medžiagų bibliotekos failas yra rašomas šalia `.obj` išvesties.
`pointCloud`	`boolean`	`false`	SaveOptions `true`, geometrija eksportuojama kaip taškų debesis (tik viršūnės, be veidų apibrėžimų).
`verbose`	`boolean`	`false`	SaveOptions `true`, papildomi diagnostiniai komentarai įtraukti į OBJ išvestį.
`serializeW`	`boolean`	`false`	SaveOptions `true`, homogeniškų viršūnių koordinatų W komponentas įrašomas į failą.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, Y ir Z ašys perkeičiamos eksporto metu.
`applyUnitScale`	`boolean`	`false`	SaveOptions `true`, scenos vienetų mastelis taikomas visoms geometrijos koordinatėms eksporto metu.

StlSaveOptions

Išsaugojimo parinktys STL (.stl) išvestis.

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

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`binaryMode`	`boolean`	`false`	SaveOptions `true`, išvestis įrašoma kaip binarinis STL (kompaktiškas, ne žmonėms skaitomas). Kai `false`, rašomas ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	SaveOptions `true`, Y ir Z ašys perkeičiamos eksporto metu.
`scale`	`number`	`1.0`	Vienodas mastelio koeficientas, taikomas visai geometrijai eksporto metu.

SaveOptions

Išsaugoti tinklelį kaip binarinį 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

Įkėlimo parinktys STL (.stl) failams. Tiek ASCII, tiek binariniai STL palaikomi automatiškai; jokia savybė nekontroliuoja aptikimo.

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

StlLoadOptions plečia LoadOptions ir šioje versijoje neatskleidžia papildomų vartotojui matomų savybių.

FbxSaveOptions

Išsaugojimo parinktys FBX (.fbx) išvestis.

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

SaveOptions

SaveOptions	SaveOptions	SaveOptions	SaveOptions
`embedTextures`	`boolean`	`false`	SaveOptions `true`, nuorodų tekstūros atvaizdai įterpiami į FBX binarinį archyvą. Kai `false`, tekstūros keliai įrašomi kaip išorinės nuorodos.

SaveOptions

Eksportuokite FBX failą su visomis įterptomis tekstūromis.

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

Įkėlimo parinktys FBX (.fbx) failai. Palaiko tiek binarinį, tiek ASCII FBX.

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

FbxLoadOptions plečia LoadOptions ir neskelbia papildomų vartotojui matomų savybių dabartinėje versijoje.

Bazinės klasės

LoadOptions

Bazinė klasė visiems įkėlimo parinkčių objektams.

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

Perduokite LoadOptions pakaitinės klasės egzempliorių į scene.open(filePath, options) arba scene.openFromBuffer(buffer, options).

SaveOptions

Bazinė klasė visiems išsaugojimo parinkčių objektams.

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

Perduokite SaveOptions pakaitinės klasės egzempliorių į scene.save(filePath, options).