Format Load and Save Options

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

Las clases de opciones de formato controlan cómo @aspose/3d lee y escribe formatos de archivo 3D específicos. Pase una instancia de opciones como segundo argumento a scene.open() (opciones de carga) o scene.save() (opciones de guardado). Todas las clases de opciones extienden ya sea LoadOptions o 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

Opciones de guardado para glTF 2.0 JSON (.gltf) y GLB binario (.glb).

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`binaryMode`	`boolean`	`false`	ReferenceMode `true`, el exportador escribe un archivo GLB binario autocontenido. Cuando `false`, escribe un JSON `.gltf` archivo con un `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	ReferenceMode `true`, las coordenadas UV V están invertidas (`v = 1 - v`). La especificación glTF 2.0 usa un origen UV en la esquina superior izquierda, por lo que esta bandera está `true` activada por defecto para coincidir con la mayoría de las convenciones de herramientas DCC.

ReferenceMode

Todas las enumeraciones en @aspose/3d: ProjectionType, LightType, TextureMapping, BooleanOperation, VertexElementType, MappingMode, ReferenceMode.

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

Opciones de carga para JSON glTF 2.0 (.gltf) y GLB binario (.glb) archivos.

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

GltfLoadOptions extiende LoadOptions. No expone propiedades adicionales visibles para el usuario en la versión actual; pase una instancia predeterminada para usar los valores recomendados por defecto.

ReferenceMode

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

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

ObjLoadOptions

Cargar opciones para Wavefront OBJ (.obj) archivos.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`enableMaterials`	`boolean`	`true`	ReferenceMode `true`, el importador lee el `.mtl` biblioteca de materiales referenciada por el `mtllib` directiva y rellena las propiedades del material en los nodos de malla. Establecer a `false` para omitir la carga de materiales.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, los ejes Y y Z se intercambian durante la importación para convertir entre sistemas de coordenadas Y-arriba y Z-arriba.
`normalizeNormal`	`boolean`	`true`	ReferenceMode `true`, las normales de vértice leídas del archivo se normalizan a longitud unitaria durante la importación.
`scale`	`number`	`1.0`	Factor de escala uniforme aplicado a toda la geometría durante la importación.

ReferenceMode

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

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

Guardar opciones para Wavefront OBJ (.obj) salida.

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

Nota: exportación OBJ (canExport: false) no está totalmente soportado en esta versión de la biblioteca. Intentar guardar en OBJ puede generar un error de operación no soportada.

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`enableMaterials`	`boolean`	`true`	ReferenceMode `true`, un archivo complementario `.mtl` archivo de biblioteca de materiales se escribe junto al `.obj` salida.
`pointCloud`	`boolean`	`false`	ReferenceMode `true`, la geometría se exporta como una nube de puntos (solo vértices, sin definiciones de caras).
`verbose`	`boolean`	`false`	ReferenceMode `true`, se incluyen comentarios diagnósticos adicionales en la salida OBJ.
`serializeW`	`boolean`	`false`	ReferenceMode `true`, el componente W de las coordenadas homogéneas de vértices se escribe en el archivo.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, los ejes Y y Z se intercambian durante la exportación.
`applyUnitScale`	`boolean`	`false`	ReferenceMode `true`, la escala de unidades de la escena se aplica a todas las coordenadas de la geometría durante la exportación.

StlSaveOptions

Opciones de guardado para STL (.stl) de salida.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`binaryMode`	`boolean`	`false`	ReferenceMode `true`, la salida se escribe como STL binario (compacto, no legible por humanos). Cuando `false`, se escribe STL ASCII.
`flipCoordinateSystem`	`boolean`	`false`	ReferenceMode `true`, los ejes Y y Z se intercambian durante la exportación.
`scale`	`number`	`1.0`	Factor de escala uniforme aplicado a toda la geometría durante la exportación.

ReferenceMode

ProjectionType.

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

Opciones de carga para STL (.stl) archivos. Tanto STL ASCII como binario son compatibles automáticamente; ninguna propiedad controla la detección.

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

StlLoadOptions extiende LoadOptions y no expone propiedades adicionales visibles para el usuario en la versión actual.

FbxSaveOptions

Opciones de guardado para FBX (.fbx) salida.

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

ReferenceMode

ReferenceMode	ReferenceMode	ReferenceMode	ReferenceMode
`embedTextures`	`boolean`	`false`	ReferenceMode `true`, las imágenes de textura referenciadas están incrustadas dentro del archivo binario FBX. Cuando `false`, las rutas de textura se escriben como referencias externas.

ReferenceMode

LightType.

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

Opciones de carga para FBX (.fbx) archivos. Soporta tanto FBX binario como ASCII.

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

FbxLoadOptions extiende LoadOptions y no expone propiedades adicionales visibles para el usuario en la versión actual.

TextureMapping

LoadOptions

Identifica el canal de textura al que está vinculado un elemento UV.

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

Pasa un LoadOptions instancia de subclase a scene.open(filePath, options) o scene.openFromBuffer(buffer, options).

SaveOptions

Clase base para todos los objetos de opciones de guardado.

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

Pasa un SaveOptions instancia de subclase a scene.save(filePath, options).