Format Load and Save Options

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

Formatalternativklasser styr hur @aspose/3d läser och skriver specifika 3D-filformat. Skicka en alternativinstans som det andra argumentet till scene.open() (load options) eller scene.save() (save options). Alla alternativklasser ärver antingen 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

Spara alternativ för glTF 2.0 JSON (.gltf) och binär GLB (.glb) utdata.

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`binaryMode`	`boolean`	`false`	ImageRenderOptions `true`, exportören skriver en fristående binär GLB-fil. När `false`, skriver den en JSON `.gltf` fil med en medföljande `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	ImageRenderOptions `true`, UV V-koordinater vänds (`v = 1 - v`). glTF 2.0-specifikationen använder ett UV‑ursprung i övre vänstra hörnet, så den här flaggan är `true` som standard för att matcha de flesta DCC-verktygskonventioner.

ImageRenderOptions

Exportera en scen som en binär GLB med UV-koordinater bevarade oförändrade.

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

Läsalternativ för glTF 2.0 JSON (.gltf) och binär GLB (.glb) filer.

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

GltfLoadOptions ärver LoadOptions. Det exponerar inte ytterligare användarorienterade egenskaper i den aktuella versionen; skicka en standardinstans för att använda rekommenderade standardvärden.

ImageRenderOptions

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

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

ObjLoadOptions

Läsalternativ för Wavefront OBJ (.obj) filer.

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`enableMaterials`	`boolean`	`true`	ImageRenderOptions `true`, importören läser `.mtl` materialbiblioteket som refereras av `mtllib` direktivet och fyller i materialegenskaper på mesh-noderna. Ställ in på `false` för att hoppa över materialinläsning.
`flipCoordinateSystem`	`boolean`	`false`	ImageRenderOptions `true`, Y- och Z-axlarna byts plats under import för att konvertera mellan Y-upp och Z-upp koordinatsystem.
`normalizeNormal`	`boolean`	`true`	ImageRenderOptions `true`, vertexnormaler som läses från filen normaliseras till enhetslängd under import.
`scale`	`number`	`1.0`	Enhetlig skalningsfaktor som tillämpas på all geometri under import.

ImageRenderOptions

Läs in en OBJ‑fil utan att lösa upp dess materialbibliotek.

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

Sparaalternativ för Wavefront OBJ (.obj) utdata.

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

Obs: OBJ-export (canExport: false) stöds inte fullt ut i den här versionen av biblioteket. Att försöka spara till OBJ kan kasta ett fel för en operation som inte stöds.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`enableMaterials`	`boolean`	`true`	ImageRenderOptions `true`, en följeslagare `.mtl` material library file skrivs bredvid den `.obj` utdata.
`pointCloud`	`boolean`	`false`	ImageRenderOptions `true`, geometri exporteras som ett punktmoln (endast vertexer, inga ansiktsdefinitioner).
`verbose`	`boolean`	`false`	ImageRenderOptions `true`, ytterligare diagnostiska kommentarer inkluderas i OBJ-utdata.
`serializeW`	`boolean`	`false`	ImageRenderOptions `true`, W-komponenten i homogena vertexkoordinater skrivs till filen.
`flipCoordinateSystem`	`boolean`	`false`	ImageRenderOptions `true`, Y- och Z-axlarna byts plats vid export.
`applyUnitScale`	`boolean`	`false`	ImageRenderOptions `true`, scenens enhetsskala tillämpas på alla geometrikoordinater vid export.

StlSaveOptions

Spara alternativ för STL (.stl) utdata.

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`binaryMode`	`boolean`	`false`	ImageRenderOptions `true`, utdata skrivs som binär STL (kompakt, inte läsbar för människor). När `false`, ASCII STL skrivs.
`flipCoordinateSystem`	`boolean`	`false`	ImageRenderOptions `true`, Y- och Z-axlarna byts plats vid export.
`scale`	`number`	`1.0`	Enhetlig skalningsfaktor tillämpas på all geometri vid export.

ImageRenderOptions

Spara ett 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

Läsalternativ för STL (.stl) filer. Både ASCII och binär STL stöds automatiskt; ingen egenskap styr detekteringen.

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

StlLoadOptions utökar LoadOptions och exponerar inte ytterligare användarorienterade egenskaper i den nuvarande versionen.

FbxSaveOptions

Spara alternativ för FBX (.fbx) utdata.

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`embedTextures`	`boolean`	`false`	ImageRenderOptions `true`, refererade texturbilder är inbäddade i FBX-binärarkivet. När `false`, texturvägar skrivs som externa referenser.

ImageRenderOptions

Exportera en FBX-fil med alla texturer inbäddade.

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

Läsalternativ för FBX (.fbx) filer. Stöder både binära och ASCII FBX.

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

FbxLoadOptions utökar LoadOptions och exponerar inte ytterligare användarorienterade egenskaper i den aktuella versionen.

Bas‑klasser

LoadOptions

Bas‑klass för alla läsalternativ‑objekt.

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

Skicka en LoadOptions instans av underklass till scene.open(filePath, options) eller scene.openFromBuffer(buffer, options).

SaveOptions

Bas‑klass för alla sparaalternativ‑objekt.

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

Skicka en SaveOptions instans av underklass till scene.save(filePath, options).