Format Load and Save Options

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

Classes de opções de formato controlam como @aspose/3d lê e grava formatos de arquivo 3D específicos. Passe uma instância de opções como o segundo argumento para scene.open() (opções de carregamento) ou scene.save() (opções de salvamento). Todas as classes de opções estendem ou LoadOptions ou 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

Opções de salvamento para glTF 2.0 JSON (.gltf) e GLB binário (.glb).

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, o exportador grava um arquivo binário GLB autocontido. Quando `false`, ele grava um JSON `.gltf` arquivo com um companheiro `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	ColladaSaveOptions `true`, as coordenadas UV V são invertidas (`v = 1 - v`). A especificação glTF 2.0 usa uma origem UV no canto superior esquerdo, portanto este sinalizador está `true` ativado por padrão para corresponder à maioria das convenções de ferramentas DCC.

ColladaSaveOptions

Exporte uma cena como GLB binário com coordenadas UV preservadas como estão.

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

Opções de carregamento para JSON glTF 2.0 (.gltf) e GLB binário (.glb) arquivos.

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

GltfLoadOptions estende LoadOptions. Não expõe propriedades adicionais voltadas ao usuário na versão atual; passe uma instância padrão para usar os valores recomendados.

ColladaSaveOptions

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

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

ObjLoadOptions

Carregar opções para Wavefront OBJ (.obj) arquivos.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, o importador lê o `.mtl` biblioteca de materiais referenciada pelo `mtllib` diretiva e preenche as propriedades de material nos nós da malha. Defina como `false` para ignorar o carregamento de material.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, os eixos Y e Z são trocados durante a importação para converter entre sistemas de coordenadas Y-up e Z-up.
`normalizeNormal`	`boolean`	`true`	ColladaSaveOptions `true`, as normais dos vértices lidas do arquivo são normalizadas para comprimento unitário durante a importação.
`scale`	`number`	`1.0`	Fator de escala uniforme aplicado a toda a geometria durante a importação.

ColladaSaveOptions

Carregue um arquivo OBJ sem resolver sua biblioteca de materiais.

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

Salvar opções para Wavefront OBJ (.obj) saída.

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

Nota: Exportação OBJ (canExport: false) não é totalmente suportado nesta versão da biblioteca. Tentar salvar em OBJ pode gerar um erro de operação não suportada.

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, um companheiro `.mtl` arquivo de biblioteca de material é escrito ao lado do `.obj` saída.
`pointCloud`	`boolean`	`false`	ColladaSaveOptions `true`, a geometria é exportada como nuvem de pontos (apenas vértices, sem definições de faces).
`verbose`	`boolean`	`false`	ColladaSaveOptions `true`, comentários diagnósticos adicionais são incluídos na saída OBJ.
`serializeW`	`boolean`	`false`	ColladaSaveOptions `true`, o componente W das coordenadas homogêneas dos vértices é escrito no arquivo.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, os eixos Y e Z são trocados durante a exportação.
`applyUnitScale`	`boolean`	`false`	ColladaSaveOptions `true`, a escala de unidades da cena é aplicada a todas as coordenadas da geometria durante a exportação.

StlSaveOptions

Opções de salvamento para STL (.stl) de saída.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, a saída é gravada como STL binário (compacto, não legível por humanos). Quando `false`, STL ASCII é gravado.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, os eixos Y e Z são trocados durante a exportação.
`scale`	`number`	`1.0`	Fator de escala uniforme aplicado a toda a geometria durante a exportação.

ColladaSaveOptions

Salve uma malha como STL binário.

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

Opções de carregamento para STL (.stl) arquivos. Tanto STL ASCII quanto binário são suportados automaticamente; nenhuma propriedade controla a detecção.

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

StlLoadOptions estende LoadOptions e não expõe propriedades adicionais voltadas ao usuário na versão atual.

FbxSaveOptions

Opções de salvamento para FBX (.fbx) de saída.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`embedTextures`	`boolean`	`false`	ColladaSaveOptions `true`, as imagens de textura referenciadas são incorporadas dentro do arquivo binário FBX. Quando `false`, os caminhos de textura são gravados como referências externas.

ColladaSaveOptions

Exporte um arquivo FBX com todas as texturas incorporadas.

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

Opções de carregamento para FBX (.fbx) arquivos. Suporta tanto FBX binário quanto ASCII.

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

FbxLoadOptions estende LoadOptions e não expõe propriedades adicionais voltadas ao usuário na versão atual.

Classes Base

LoadOptions

Classe base para todos os objetos de opções de carregamento.

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

Passe um LoadOptions instância de subclasse para scene.open(filePath, options) ou scene.openFromBuffer(buffer, options).

SaveOptions

Classe base para todos os objetos de opções de salvamento.

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

Passe um SaveOptions instância de subclasse para scene.save(filePath, options).