Format Load and Save Options

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

Třídy možností formátu řídí, jak @aspose/3d čte a zapisuje konkrétní 3D souborové formáty. Předávejte instanci možností jako druhý argument do scene.open() (load options) nebo scene.save() (save options). Všechny třídy možností rozšiřují buď LoadOptions nebo 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žit možnosti pro glTF 2.0 JSON (.gltf) a binární GLB (.glb) výstup.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, exportér zapíše samostatný binární soubor GLB. Když `false`, zapíše JSON `.gltf` soubor s doprovodným `.bin` bufferem.
`flipTexCoordV`	`boolean`	`true`	Enumerations `true`, UV V souřadnice jsou převráceny (`v = 1 - v`). Specifikace glTF 2.0 používá počátek UV v levém horním rohu, takže tento příznak je `true` ve výchozím nastavení, aby odpovídal většině konvencí DCC nástrojů.

Enumerations

Exportujte scénu jako binární GLB se zachovanými UV souřadnicemi v původní podobě.

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čítání pro glTF 2.0 JSON (.gltf) a binární GLB (.glb) soubory.

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

GltfLoadOptions rozšiřuje LoadOptions. V aktuální verzi neodhaluje žádné další uživatelské vlastnosti; předávejte výchozí instanci pro použití doporučených výchozích hodnot.

Enumerations

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

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

ObjLoadOptions

Možnosti načítání pro Wavefront OBJ (.obj) soubory.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, importér čte `.mtl` knihovnu materiálů odkazovanou v `mtllib` direktivu a naplňuje vlastnosti materiálu na uzlech sítě. Nastavte na `false` pro přeskočení načítání materiálu.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, během importu jsou osy Y a Z prohozeny, aby se převedlo mezi souřadnicovými systémy Y-up a Z-up.
`normalizeNormal`	`boolean`	`true`	Enumerations `true`, normály vrcholů načtené ze souboru jsou během importu normalizovány na jednotkovou délku.
`scale`	`number`	`1.0`	Jednotný měřítkový faktor aplikovaný na veškerou geometrii během importu.

Enumerations

Načtěte soubor OBJ bez rozpoznání jeho knihovny materiálů.

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 ukládání pro Wavefront OBJ (.obj) výstup.

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

Poznámka: Export OBJ (canExport: false) není v této verzi knihovny plně podporováno. Pokus o uložení do OBJ může vyvolat chybu nepodporované operace.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, společník `.mtl` soubor knihovny materiálů je zapsán vedle `.obj` výstupu.
`pointCloud`	`boolean`	`false`	Enumerations `true`, geometrie je exportována jako bodový mrak (pouze vrcholy, žádné definice ploch).
`verbose`	`boolean`	`false`	Enumerations `true`, do výstupu OBJ jsou zahrnuty další diagnostické komentáře.
`serializeW`	`boolean`	`false`	Enumerations `true`, komponenta W homogenních souřadnic vrcholů je zapsána do souboru.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, během exportu jsou osy Y a Z prohozeny.
`applyUnitScale`	`boolean`	`false`	Enumerations `true`, během exportu se na všechny souřadnice geometrie použije jednotkové měřítko scény.

StlSaveOptions

Možnosti uložení pro STL (.stl) výstup.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, výstup je zapsán jako binární STL (kompaktní, nečitelné pro člověka). Když `false`, je zapsán ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, během exportu jsou osy Y a Z prohozeny.
`scale`	`number`	`1.0`	Jednotný měřítkový faktor aplikovaný na veškerou geometrii během exportu.

Enumerations

Uložte síť jako binární 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čtení pro STL (.stl) soubory. Jak ASCII, tak binární STL jsou automaticky podporovány; žádná vlastnost neovlivňuje detekci.

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

StlLoadOptions rozšiřuje LoadOptions a v současné verzi neodhaluje žádné další uživatelské vlastnosti.

FbxSaveOptions

Možnosti uložení pro FBX (.fbx) výstup.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`embedTextures`	`boolean`	`false`	Enumerations `true`, referencované textury jsou vloženy do binárního archivu FBX. Když `false`, cesty k texturám jsou zapsány jako externí odkazy.

Enumerations

Exportujte soubor FBX se všemi vloženými texturami.

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čtení pro FBX (.fbx) soubory. Podporuje jak binární, tak ASCII FBX.

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

FbxLoadOptions rozšiřuje LoadOptions a v aktuální verzi neodhaluje žádné další uživatelské vlastnosti.

Základní třídy

LoadOptions

A3DObject, SceneObject, Entity — kořenové základní třídy sdílené všemi objekty @aspose/3d.

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

Předat LoadOptions instanci podtřídy do scene.open(filePath, options) nebo scene.openFromBuffer(buffer, options).

SaveOptions

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

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

Předat SaveOptions instanci podtřídy do scene.save(filePath, options).