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

Базовий клас для всіх об’єктів параметрів завантаження.

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

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

SaveOptions

Базовий клас для всіх об’єктів параметрів збереження.

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

Передати SaveOptions екземпляр підкласу до scene.save(filePath, options).