Format Load and Save Options

Пакет: @aspose/3d (v24.12.0)

Класовете за опции на формата контролират как @aspose/3d чете и записва конкретни 3D файлови формати. Предайте инстанция на опциите като втори аргумент на scene.open() (load options) или scene.save() (save options). Всички класове за опции наследяват или LoadOptions или 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

Запазване на опциите за glTF 2.0 JSON (.gltf).glb).

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, експортерът записва самостоятелен двоичен GLB файл. Когато `false`, той записва JSON `.gltf` файл с придружаващ `.bin` буфер.
`flipTexCoordV`	`boolean`	`true`	Enumerations `true`, UV V координатите са обърнати (`v = 1 - v`). Спецификацията glTF 2.0 използва UV произход в горния ляв ъгъл, така че този флаг е `true` по подразбиране, за да съответства на повечето конвенции на DCC инструментите.

Enumerations

Експортирайте сцена като бинарен GLB, като UV координатите се запазват непроменени.

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

Опции за зареждане за glTF 2.0 JSON (.gltf) и бинарен GLB (.glb) файлове.

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

GltfLoadOptions разширява LoadOptions. Той не излага допълнителни свойства към потребителя в текущата версия; предайте подразбиращ се екземпляр, за да използвате препоръчаните стойности по подразбиране.

Enumerations

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

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

ObjLoadOptions

Опции за зареждане за Wavefront OBJ (.obj) файлове.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, импортерът чете `.mtl` материалната библиотека, посочена от `mtllib` директива и попълва материалните свойства върху възлите на мрежата. Задайте на `false` за пропускане на зареждането на материалите.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, осите Y и Z се разменят по време на импортиране, за да се конвертират между координатни системи Y-up и Z-up.
`normalizeNormal`	`boolean`	`true`	Enumerations `true`, нормалите на върховете, прочетени от файла, се нормализират до единична дължина по време на импортиране.
`scale`	`number`	`1.0`	Униформен фактор за мащабиране, приложен към цялата геометрия по време на импортиране.

Enumerations

Заредете OBJ файл без да се разрешава неговата материална библиотека.

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

Опции за запазване за Wavefront OBJ (.obj) изход.

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

Бележка: Експорт на OBJ (canExport: false) не е напълно поддържан в тази версия на библиотеката. Опитът за запазване в OBJ може да предизвика грешка за неподдържана операция.

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`enableMaterials`	`boolean`	`true`	Enumerations `true`, съпътстващ `.mtl` файл с материална библиотека се записва заедно с `.obj` изхода.
`pointCloud`	`boolean`	`false`	Enumerations `true`, геометрията се експортира като облак от точки (само върхове, без дефиниции на лица).
`verbose`	`boolean`	`false`	Enumerations `true`, допълнителни диагностични коментари са включени в OBJ изхода.
`serializeW`	`boolean`	`false`	Enumerations `true`, компонентът W на хомогенните координати на върховете се записва във файла.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, осите Y и Z се разменят по време на експорта.
`applyUnitScale`	`boolean`	`false`	Enumerations `true`, единичната скала на сцената се прилага към всички координати на геометрията при експорта.

StlSaveOptions

Опции за запазване за STL (.stl) изход.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`binaryMode`	`boolean`	`false`	Enumerations `true`, изходът се записва като бинарен STL (компактен, нечетим за хора). Когато `false`, записва се ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	Enumerations `true`, осите Y и Z се разменят при експортиране.
`scale`	`number`	`1.0`	Еднороден фактор на мащабиране се прилага към цялата геометрия при експортиране.

Enumerations

Запишете мрежа като бинарен 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

Опции за зареждане за STL (.stl) файлове. И ASCII, и бинарен STL се поддържат автоматично; никой параметър не контролира откриването.

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

StlLoadOptions разширява LoadOptions и не разкрива допълнителни свойства, видими за потребителя, в текущата версия.

FbxSaveOptions

Опции за запазване за FBX (.fbx) изход.

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

Enumerations

Enumerations	Enumerations	Enumerations	Enumerations
`embedTextures`	`boolean`	`false`	Enumerations `true`, референтните текстурни изображения са вградени в бинарния архив на FBX. Когато `false`, пътеките към текстурите се записват като външни референции.

Enumerations

Експортирайте FBX файл с всички текстури вградени.

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

Опции за зареждане за FBX (.fbx) файлове. Поддържа както бинарен, така и ASCII FBX.

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

FbxLoadOptions разширява LoadOptions и не разкрива допълнителни свойства, видими за потребителя, в текущата версия.

Базови класове

LoadOptions

A3DObject.

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

Подайте LoadOptions екземпляр на подклас към scene.open(filePath, options) или scene.openFromBuffer(buffer, options).

SaveOptions

findProperty(propertyName).

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

Подайте SaveOptions екземпляр на подклас към scene.save(filePath, options).