Format Load and Save Options

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

Formatalternativklasser kontrollerer hvordan @aspose/3d leser og skriver spesifikke 3D-filformater. Send en options-instans som det andre argumentet til scene.open() (load options) eller scene.save() (save options). Alle alternativklasser arver 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

Lagringsalternativer for glTF 2.0 JSON (.gltf) og binær GLB (.glb) utdata.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`binaryMode`	`boolean`	`false`	BoundingBoxExtent `true`, skriver eksportøren en selvstendig binær GLB-fil. Når `false`, skriver den en JSON `.gltf` fil med en ledsagende `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	BoundingBoxExtent `true`, UV V-koordinater blir vendt (`v = 1 - v`). glTF 2.0-spesifikasjonen bruker en UV-opprinnelse øverst til venstre, så dette flagget er `true` som standard for å samsvare med de fleste DCC-verktøykonvensjoner.

BoundingBoxExtent

Eksporter en scene som en binær GLB med UV‑koordinater bevart 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

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

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

GltfLoadOptions utvider LoadOptions. Den eksponerer ikke ekstra brukerrettede egenskaper i den nåværende versjonen; send inn en standardinstans for å bruke anbefalte standardverdier.

BoundingBoxExtent

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

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

ObjLoadOptions

Lastealternativer for Wavefront OBJ (.obj) filer.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`enableMaterials`	`boolean`	`true`	BoundingBoxExtent `true`, importøren leser `.mtl` materialbiblioteket som refereres av `mtllib` direktivet og fyller materialegenskaper på mesh-nodene. Sett til `false` for å hoppe over lasting av materialer.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, Y- og Z-aksene byttes om under import for å konvertere mellom Y‑opp og Z‑opp koordinatsystemer.
`normalizeNormal`	`boolean`	`true`	BoundingBoxExtent `true`, vertexnormals lest fra filen normaliseres til enhetslengde under import.
`scale`	`number`	`1.0`	Enhetlig skaleringsfaktor som brukes på all geometri under import.

BoundingBoxExtent

Last en OBJ‑fil uten å løse opp materialbiblioteket.

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

Lagringsalternativer for Wavefront OBJ (.obj) utdata.

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

Merk: OBJ-eksport (canExport: false) er ikke fullt støttet i denne versjonen av biblioteket. Å prøve å lagre til OBJ kan kaste en unsupported-operation error.

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`enableMaterials`	`boolean`	`true`	BoundingBoxExtent `true`, en følgesvenn `.mtl` materialbibliotekfilen skrives ved siden av `.obj` utdata.
`pointCloud`	`boolean`	`false`	BoundingBoxExtent `true`, geometri eksporteres som en punkt sky (kun vertexer, ingen flatedefinisjoner).
`verbose`	`boolean`	`false`	BoundingBoxExtent `true`, ekstra diagnostiske kommentarer er inkludert i OBJ-utdata.
`serializeW`	`boolean`	`false`	BoundingBoxExtent `true`, W-komponenten i homogene vertex-koordinater skrives til filen.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, Y- og Z-aksene byttes om under eksport.
`applyUnitScale`	`boolean`	`false`	BoundingBoxExtent `true`, scenens enhetsskala anvendes på alle geometrikoordinater under eksport.

StlSaveOptions

Lagringsalternativer for STL (.stl) utdata.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`binaryMode`	`boolean`	`false`	BoundingBoxExtent `true`, utdata skrives som binær STL (kompakt, ikke menneskelig lesbar). Når `false`, ASCII STL skrives.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, Y- og Z-aksene byttes om under eksport.
`scale`	`number`	`1.0`	Enhetlig skaleringsfaktor anvendt på all geometri under eksport.

BoundingBoxExtent

Lagre et nett 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

Lastealternativer for STL (.stl) filer. Både ASCII og binær STL støttes automatisk; ingen egenskap styrer deteksjonen.

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

StlLoadOptions utvider LoadOptions og eksponerer ikke ekstra brukerrettede egenskaper i den nåværende versjonen.

FbxSaveOptions

Lagringsalternativer for FBX (.fbx) utdata.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`embedTextures`	`boolean`	`false`	BoundingBoxExtent `true`, refererte teksturbilder er innebygd i FBX-binærarkivet. Når `false`, teksturbaner skrives som eksterne referanser.

BoundingBoxExtent

Eksporter en FBX-fil med alle teksturene innebygd.

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

Lastalternativer for FBX (.fbx) filer. Støtter både binær og ASCII FBX.

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

FbxLoadOptions utvider LoadOptions og eksponerer ikke ekstra brukerrettede egenskaper i den nåværende versjonen.

Baseklasser

LoadOptions

Baseklasse for alle lastalternativ-objekter.

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

Send en LoadOptions subklasse‑instans til scene.open(filePath, options) eller scene.openFromBuffer(buffer, options).

SaveOptions

Baseklasse for alle lagringsalternativ-objekter.

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

Send en SaveOptions subklasse‑instans til scene.save(filePath, options).