Format Load and Save Options

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

Kelas pilihan format mengawal bagaimana @aspose/3d membaca dan menulis format fail 3D tertentu. Hantar contoh pilihan sebagai argumen kedua kepada scene.open() (pilihan muat) atau scene.save() (pilihan simpan). Semua kelas pilihan melanjutkan sama ada LoadOptions atau 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

Pilihan simpan untuk glTF 2.0 JSON (.gltf) dan GLB binari (.glb) output.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, pengeksport menulis fail GLB binari yang berdiri sendiri. Apabila `false`, ia menulis JSON `.gltf` fail dengan rakan `.bin` penimbal.
`flipTexCoordV`	`boolean`	`true`	ColladaSaveOptions `true`, koordinat UV V dibalik (`v = 1 - v`). Spesifikasi glTF 2.0 menggunakan asal UV kiri-atas, jadi bendera ini adalah `true` secara lalai untuk menyesuaikan kebanyakan konvensyen alat DCC.

ColladaSaveOptions

Eksportkan adegan sebagai GLB binari dengan koordinat UV dipelihara apa adanya.

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

Pilihan muat untuk JSON glTF 2.0 (.gltf) dan GLB binari (.glb) fail.

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

GltfLoadOptions memperluas LoadOptions. Ia tidak mendedahkan sifat tambahan yang berhadapan dengan pengguna dalam versi semasa; berikan contoh lalai untuk menggunakan nilai lalai yang disyorkan.

ColladaSaveOptions

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

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

ObjLoadOptions

Pilihan muat untuk Wavefront OBJ (.obj) fail.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, pengimport membaca `.mtl` perpustakaan bahan yang dirujuk oleh `mtllib` arahan dan mengisi sifat bahan pada nod mesh. Tetapkan kepada `false` untuk melangkau pemuatan bahan.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, paksi Y dan Z ditukar semasa import untuk menukar antara sistem koordinat Y-up dan Z-up.
`normalizeNormal`	`boolean`	`true`	ColladaSaveOptions `true`, normal vertex yang dibaca dari fail dinormalisasikan kepada panjang unit semasa import.
`scale`	`number`	`1.0`	Faktor skala seragam yang diterapkan pada semua geometri semasa import.

ColladaSaveOptions

Muat fail OBJ tanpa menyelesaikan perpustakaan bahanannya.

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

Pilihan simpan untuk Wavefront OBJ (.obj) output.

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

Nota: Eksport OBJ (canExport: false) tidak disokong sepenuhnya dalam versi perpustakaan ini. Mencuba menyimpan ke OBJ mungkin akan menghasilkan ralat operasi tidak disokong.

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`enableMaterials`	`boolean`	`true`	ColladaSaveOptions `true`, seorang pendamping `.mtl` fail perpustakaan bahan ditulis bersama-sama dengan `.obj` output.
`pointCloud`	`boolean`	`false`	ColladaSaveOptions `true`, geometri dieksport sebagai awan titik (hanya titik, tiada definisi muka).
`verbose`	`boolean`	`false`	ColladaSaveOptions `true`, komen diagnostik tambahan disertakan dalam output OBJ.
`serializeW`	`boolean`	`false`	ColladaSaveOptions `true`, komponen W koordinat verteks homogen ditulis ke dalam fail.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, paksi Y dan Z ditukar semasa eksport.
`applyUnitScale`	`boolean`	`false`	ColladaSaveOptions `true`, skala unit adegan diterapkan kepada semua koordinat geometri semasa eksport.

StlSaveOptions

Simpan pilihan untuk STL (.stl) output.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binaryMode`	`boolean`	`false`	ColladaSaveOptions `true`, output ditulis sebagai binary STL (padat, tidak boleh dibaca manusia). Apabila `false`, STL ASCII ditulis.
`flipCoordinateSystem`	`boolean`	`false`	ColladaSaveOptions `true`, paksi Y dan Z ditukar semasa eksport.
`scale`	`number`	`1.0`	Faktor skala seragam yang diterapkan pada semua geometri semasa eksport.

ColladaSaveOptions

Simpan mesh sebagai STL binari.

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

Pilihan muat untuk STL (.stl) fail. Kedua-dua STL ASCII dan binari disokong secara automatik; tiada sifat yang mengawal pengesanan.

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

StlLoadOptions meluaskan LoadOptions dan tidak mendedahkan sifat tambahan yang berhadapan dengan pengguna dalam versi semasa.

FbxSaveOptions

Pilihan simpan untuk FBX (.fbx) output.

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

ColladaSaveOptions

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`embedTextures`	`boolean`	`false`	ColladaSaveOptions `true`, imej tekstur yang dirujuk dimasukkan ke dalam arkib binari FBX. Apabila `false`, laluan tekstur ditulis sebagai rujukan luaran.

ColladaSaveOptions

Eksportkan fail FBX dengan semua tekstur terbenam.

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

Pilihan muat untuk FBX (.fbx) fail. Menyokong kedua-dua FBX binari dan ASCII.

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

FbxLoadOptions memperluas LoadOptions dan tidak mendedahkan sifat tambahan yang berhadapan dengan pengguna dalam versi semasa.

Kelas Asas

LoadOptions

Kelas asas untuk semua objek pilihan pemuatan.

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

Hantar satu LoadOptions instans subkelas kepada scene.open(filePath, options) atau scene.openFromBuffer(buffer, options).

SaveOptions

Kelas asas untuk semua objek pilihan simpan.

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

Hantar satu SaveOptions instans subkelas kepada scene.save(filePath, options).