Format Load and Save Options

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

Klasy opcji formatu kontrolują, jak @aspose/3d odczytuje i zapisuje określone formaty plików 3D. Przekaż instancję opcji jako drugi argument do scene.open() (load options) lub scene.save() (save options). Wszystkie klasy opcji dziedziczą po jednej z LoadOptions lub 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

Opcje zapisu dla glTF 2.0 JSON (.gltf) oraz binarnego GLB (.glb).

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, eksporter zapisuje samodzielny binarny plik GLB. Kiedy `false`, zapisuje plik JSON `.gltf` plik z towarzyszącym `.bin` buforem.
`flipTexCoordV`	`boolean`	`true`	ColladaSaveOptions `true`, współrzędne UV V są odwrócone (`v = 1 - v`). Specyfikacja glTF 2.0 używa pochodzenia UV w lewym górnym rogu, więc ten znacznik jest `true` domyślnie, aby dopasować się do większości konwencji narzędzi DCC.

ColladaSaveOptions

Eksportuj scenę jako binarny GLB z zachowaniem współrzędnych UV w niezmienionej formie.

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

Opcje ładowania dla JSON glTF 2.0 (.gltf) oraz binarnego GLB (.glb) plików.

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

GltfLoadOptions rozszerza LoadOptions. Nie udostępnia dodatkowych właściwości widocznych dla użytkownika w bieżącej wersji; przekaż domyślną instancję, aby użyć zalecanych ustawień domyślnych.

ColladaSaveOptions

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

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

ObjLoadOptions

Opcje ładowania dla Wavefront OBJ (.obj) plików.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, importer odczytuje `.mtl` bibliotekę materiałów wskazaną przez `mtllib` dyrektywę i wypełnia właściwości materiałów w węzłach siatki. Ustaw na `false` aby pominąć ładowanie materiałów.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, osie Y i Z są zamieniane podczas importu w celu konwersji między układami współrzędnych Y-up i Z-up.
`normalizeNormal`	`boolean`	`true`	ColladaSaveOptions `true`, wektory normalne wierzchołków odczytane z pliku są normalizowane do jednostkowej długości podczas importu.
`scale`	`number`	`1.0`	Jednolity współczynnik skali stosowany do całej geometrii podczas importu.

ColladaSaveOptions

Wczytaj plik OBJ bez rozwiązywania jego biblioteki materiałów.

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

Opcje zapisu dla Wavefront OBJ (.obj) wyjście.

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

Uwaga: Eksport OBJ (canExport: false) nie jest w pełni obsługiwany w tej wersji biblioteki. Próba zapisu do OBJ może spowodować błąd nieobsługiwanej operacji.

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, towarzyszący `.mtl` plik biblioteki materiałów jest zapisywany obok `.obj` wyjścia.
`pointCloud`	`boolean`	`false`	ColladaSaveOptions `true`, geometria jest eksportowana jako chmura punktów (tylko wierzchołki, bez definicji ścian).
`verbose`	`boolean`	`false`	ColladaSaveOptions `true`, dodatkowe komentarze diagnostyczne są dołączane do wyjścia OBJ.
`serializeW`	`boolean`	`false`	ColladaSaveOptions `true`, komponent W jednorodnych współrzędnych wierzchołka jest zapisywany do pliku.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, osie Y i Z są zamieniane miejscami podczas eksportu.
`applyUnitScale`	`boolean`	`false`	ColladaSaveOptions `true`, skala jednostki sceny jest stosowana do wszystkich współrzędnych geometrii podczas eksportu.

StlSaveOptions

Opcje zapisu dla STL (.stl) wyjścia.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, wyjście jest zapisywane jako binarny STL (kompaktowy, nieczytelny dla człowieka). Gdy `false`, zapisywany jest ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, osie Y i Z są zamieniane miejscami podczas eksportu.
`scale`	`number`	`1.0`	Jednolity współczynnik skali stosowany do całej geometrii podczas eksportu.

ColladaSaveOptions

Zapisz siatkę jako binarny 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

Opcje wczytywania dla STL (.stl) plików. Zarówno ASCII, jak i binarny STL są obsługiwane automatycznie; żadna właściwość nie kontroluje wykrywania.

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

StlLoadOptions rozszerza LoadOptions i nie udostępnia dodatkowych właściwości widocznych dla użytkownika w bieżącej wersji.

FbxSaveOptions

Opcje zapisu dla FBX (.fbx) wyjścia.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`embedTextures`	`boolean`	`false`	ColladaSaveOptions `true`, odwołane obrazy tekstur są osadzone wewnątrz binarnego archiwum FBX. Gdy `false`, ścieżki tekstur są zapisywane jako zewnętrzne odwołania.

ColladaSaveOptions

Eksportuj plik FBX ze wszystkimi wbudowanymi teksturami.

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

Opcje ładowania dla FBX (.fbx) plików. Obsługuje zarówno binarne, jak i ASCII FBX.

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

FbxLoadOptions rozszerza LoadOptions i nie udostępnia dodatkowych właściwości widocznych dla użytkownika w bieżącej wersji.

Klasy bazowe

LoadOptions

Klasa bazowa dla wszystkich obiektów opcji ładowania.

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

Przekaż LoadOptions instancję podklasy do scene.open(filePath, options) lub scene.openFromBuffer(buffer, options).

SaveOptions

Klasa bazowa dla wszystkich obiektów opcji zapisu.

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

Przekaż SaveOptions instancję podklasy do scene.save(filePath, options).