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';

ColladaSaveOptions

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

ColladaSaveOptions

Экспортировать сцену в бинарный 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. Он не раскрывает дополнительных пользовательских свойств в текущей версии; передайте экземпляр по умолчанию, чтобы использовать рекомендованные значения по умолчанию.

ColladaSaveOptions

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';

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, импортёр читает `.mtl` библиотека материалов, на которую ссылается `mtllib` директива и заполняет свойства материалов на узлах сетки. Установить в `false` чтобы пропустить загрузку материалов.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, оси Y и Z меняются местами при импорте для преобразования между системами координат Y‑up и Z‑up.
`normalizeNormal`	`boolean`	`true`	ColladaSaveOptions `true`, нормали вершин, считанные из файла, нормализуются до единичной длины при импорте.
`scale`	`number`	`1.0`	Единый коэффициент масштабирования, применяемый ко всей геометрии при импорте.

ColladaSaveOptions

Загрузить файл 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 может вызвать ошибку неподдерживаемой операции.

ColladaSaveOptions

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

StlSaveOptions

Параметры сохранения для STL (.stl) вывод.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, вывод записывается в виде бинарного STL (компактный, не предназначен для чтения человеком). Когда `false`, записывается ASCII STL.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, оси Y и Z меняются местами при экспорте.
`scale`	`number`	`1.0`	Универсальный коэффициент масштабирования применяется ко всей геометрии при экспорте.

ColladaSaveOptions

Сохранить сетку в бинарный 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';

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`embedTextures`	`boolean`	`false`	ColladaSaveOptions `true`, ссылки на текстурные изображения встроены в бинарный архив FBX. Когда `false`, пути к текстурам записываются как внешние ссылки.

ColladaSaveOptions

Экспортировать файл 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

Параметры загрузки для файлов COLLADA (.dae).

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

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

SaveOptions

Параметры загрузки и сохранения для файлов 3MF (.3mf).

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

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