Format Load and Save Options

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

Formatindstillingsklasser styrer hvordan @aspose/3d læser og skriver specifikke 3D-filformater. Overgiv en options-instans som det andet argument til scene.open() (load options) eller scene.save() (save options). Alle options-klasser udvider enten LoadOptions eller 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

Gem-indstillinger for glTF 2.0 JSON (.gltf) og binær GLB (.glb) output.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, skriver eksportøren en selvstændig binær GLB-fil. Når `false`, skriver den en JSON `.gltf` fil med en ledsagende `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	Enumerations `true`, UV V-koordinater vendes (`v = 1 - v`). glTF 2.0-specifikationen bruger en UV‑oprindelse i øverste venstre hjørne, så dette flag er `true` som standard for at matche de fleste DCC‑værktøjskonventioner.

Enumerations

Eksporter en scene som en binær GLB med UV‑koordinater bevaret som de er.

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

Indlæsningsindstillinger for glTF 2.0 JSON (.gltf) og binær GLB (.glb) filer.

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

GltfLoadOptions udvider LoadOptions. Det eksponerer ikke yderligere brugerrettede egenskaber i den aktuelle version; videregiv en standardinstans for at bruge de anbefalede standardindstillinger.

Enumerations

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

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

ObjLoadOptions

Indlæsningsindstillinger for Wavefront OBJ (.obj) filer.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, importøren læser `.mtl` materialebiblioteket refereret af `mtllib` direktivet og udfylder materialegenskaber på mesh-noderne. Sæt til `false` for at springe materialelæsning over.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, Y- og Z-aksen byttes om under import for at konvertere mellem Y-op og Z-op koordinatsystemer.
`normalizeNormal`	`boolean`	`true`	Enumerations `true`, vertexnormaler læst fra filen normaliseres til enhedslængde under import.
`scale`	`number`	`1.0`	Ensartet skalafaktor anvendt på al geometri under import.

Enumerations

Indlæs en OBJ‑fil uden at løse dens materialebibliotek.

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

Gemmeindstillinger for Wavefront OBJ (.obj) output.

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

Bemærk: OBJ-eksport (canExport: false) understøttes ikke fuldt ud i denne version af biblioteket. Forsøg på at gemme til OBJ kan udløse en ikke‑understøttet‑operation‑fejl.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, en ledsager `.mtl` materialebiblioteksfilen skrives ved siden af den `.obj` output.
`pointCloud`	`boolean`	`false`	Enumerations `true`, geometri eksporteres som en punkt-sky (kun vertexer, ingen flade-definitioner).
`verbose`	`boolean`	`false`	Enumerations `true`, yderligere diagnostiske kommentarer er inkluderet i OBJ-outputtet.
`serializeW`	`boolean`	`false`	Enumerations `true`, W-komponenten af homogene vertex-koordinater skrives til filen.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, Y- og Z-aksen byttes om under eksport.
`applyUnitScale`	`boolean`	`false`	Enumerations `true`, scenens enhedsskala anvendes på alle geometrikoordinater under eksport.

StlSaveOptions

Gem indstillinger for STL (.stl) output.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, outputtet skrives som binær STL (kompakt, ikke menneskevenlig). Når `false`, ASCII STL skrives.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, Y- og Z-aksen byttes om under eksport.
`scale`	`number`	`1.0`	Ensartet skalafaktor anvendt på al geometri under eksport.

Enumerations

Gem et mesh som binær 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

Indlæsningsindstillinger for STL (.stl) filer. Både ASCII og binær STL understøttes automatisk; ingen egenskab styrer detekteringen.

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

StlLoadOptions udvider LoadOptions og afslører ikke yderligere brugerrettede egenskaber i den aktuelle version.

FbxSaveOptions

Gem indstillinger for FBX (.fbx) output.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`embedTextures`	`boolean`	`false`	Enumerations `true`, refererede teksturbilleder er indlejret i FBX-binærarkivet. Når `false`, teksturstier skrives som eksterne referencer.

Enumerations

Eksporter en FBX‑fil med alle teksturer indlejret.

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

Indlæsningsindstillinger for FBX (.fbx) filer. Understøtter både binær og ASCII FBX.

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

FbxLoadOptions udvider LoadOptions og afslører ikke yderligere brugerrettede egenskaber i den aktuelle version.

Basisklasser

LoadOptions

Basisklasse for alle load option-objekter.

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

Videregiv en LoadOptions subklasseinstans til scene.open(filePath, options) eller scene.openFromBuffer(buffer, options).

SaveOptions

Basisklasse for alle save option-objekter.

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

Videregiv en SaveOptions subklasseinstans til scene.save(filePath, options).