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 (.glb) 输出。.

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

Properties

Properties	Properties	Properties	Properties
`binaryMode`	`boolean`	`false`	Properties `true`, 导出器会写入一个自包含的二进制 GLB 文件。当 `false`, 它会写入一个 JSON `.gltf` 文件，带有伴随的 `.bin` 缓冲区。.
`flipTexCoordV`	`boolean`	`true`	Properties `true`, UV V 坐标被翻转 (`v = 1 - v`). glTF 2.0 规范使用左上角 UV 原点，因此此标志是 `true` 默认情况下，以匹配大多数 DCC 工具的约定。.

Properties

将场景导出为二进制 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. 它在当前版本中不暴露额外的面向用户的属性；传入一个默认实例以使用推荐的默认值。.

Properties

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

Properties

Properties	Properties	Properties	Properties
`enableMaterials`	`boolean`	`true`	Properties `true`,，导入器读取 `.mtl` 由该引用的材质库 `mtllib` 指令，并在网格节点上填充材质属性。设置为 `false` 跳过材质加载。.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, 在导入过程中 Y 轴和 Z 轴会互换，以在 Y‑up 和 Z‑up 坐标系之间转换。.
`normalizeNormal`	`boolean`	`true`	Properties `true`, 从文件读取的顶点法线在导入时会被归一化为单位长度。.
`scale`	`number`	`1.0`	在导入时对所有几何体应用统一的缩放因子。.

Properties

加载 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 可能会抛出不支持的操作错误。.

Properties

Properties	Properties	Properties	Properties
`enableMaterials`	`boolean`	`true`	Properties `true`, 一个伴随的 `.mtl` 材质库文件会与 `.obj` 输出。.
`pointCloud`	`boolean`	`false`	Properties `true`, 几何体会导出为点云（仅顶点，不包含面定义）。.
`verbose`	`boolean`	`false`	Properties `true`, 额外的诊断注释会包含在 OBJ 输出中。.
`serializeW`	`boolean`	`false`	Properties `true`, 同质顶点坐标的 W 分量被写入文件。.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, 导出时 Y 轴和 Z 轴会互换。.
`applyUnitScale`	`boolean`	`false`	Properties `true`, 导出时场景的单位比例会应用到所有几何坐标。.

StlSaveOptions

保存 STL 的选项 (.stl) 输出。.

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

Properties

Properties	Properties	Properties	Properties
`binaryMode`	`boolean`	`false`	Properties `true`, 输出以二进制 STL（紧凑，非人类可读）形式写入。当 `false`, 写入 ASCII STL。.
`flipCoordinateSystem`	`boolean`	`false`	Properties `true`, 在导出时 Y 轴和 Z 轴会互换。.
`scale`	`number`	`1.0`	在导出时，对所有几何体应用统一的缩放因子。.

Properties

将网格保存为二进制 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';

Properties

Properties	Properties	Properties	Properties
`embedTextures`	`boolean`	`false`	Properties `true`, 引用的纹理图像嵌入在 FBX 二进制归档中。当 `false`, 纹理路径被写为外部引用。.

Properties

导出一个所有纹理已嵌入的 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).