Format Load and Save Options

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

Kelas opsi format mengontrol cara @aspose/3d membaca dan menulis format file 3D tertentu. Berikan sebuah instance opsi sebagai argumen kedua ke scene.open() (load options) atau scene.save() (save options). Semua kelas opsi memperluas salah satu 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

Opsi penyimpanan untuk glTF 2.0 JSON (.gltf) dan GLB biner (.glb) output.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`binaryMode`	`boolean`	`false`	BoundingBoxExtent `true`, pengekspor menulis file GLB biner yang berdiri sendiri. Ketika `false`, ia menulis JSON `.gltf` file dengan buffer pendamping `.bin` buffer.
`flipTexCoordV`	`boolean`	`true`	BoundingBoxExtent `true`, koordinat UV V dibalik (`v = 1 - v`). Spesifikasi glTF 2.0 menggunakan asal UV kiri‑atas, sehingga flag ini `true` secara default untuk menyesuaikan dengan kebanyakan konvensi alat DCC.

BoundingBoxExtent

Ekspor sebuah scene sebagai GLB biner dengan koordinat UV dipertahankan 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

Opsi pemuatan untuk glTF 2.0 JSON (.gltf) dan GLB biner (.glb) file.

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

GltfLoadOptions memperluas LoadOptions. Tidak menampilkan properti tambahan yang terlihat oleh pengguna pada versi saat ini; berikan instance default untuk menggunakan nilai default yang direkomendasikan.

BoundingBoxExtent

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

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

ObjLoadOptions

Opsi muat untuk Wavefront OBJ (.obj) file.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`enableMaterials`	`boolean`	`true`	BoundingBoxExtent `true`, pengimpor membaca `.mtl` pustaka material yang direferensikan oleh `mtllib` direktif dan mengisi properti material pada node mesh. Atur ke `false` untuk melewatkan pemuatan material.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, sumbu Y dan Z ditukar selama impor untuk mengonversi antara sistem koordinat Y-up dan Z-up.
`normalizeNormal`	`boolean`	`true`	BoundingBoxExtent `true`, normal vertex yang dibaca dari file dinormalisasi ke panjang satu selama impor.
`scale`	`number`	`1.0`	Faktor skala seragam yang diterapkan pada semua geometri selama impor.

BoundingBoxExtent

Muat file OBJ tanpa menyelesaikan perpustakaan materialnya.

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

Opsi simpan untuk Wavefront OBJ (.obj) output.

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

Catatan: Ekspor OBJ (canExport: false) tidak sepenuhnya didukung dalam versi perpustakaan ini. Mencoba menyimpan ke OBJ dapat menyebabkan kesalahan operasi tidak didukung.

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`enableMaterials`	`boolean`	`true`	BoundingBoxExtent `true`, sebuah pendamping `.mtl` file perpustakaan material ditulis bersamaan dengan `.obj` output.
`pointCloud`	`boolean`	`false`	BoundingBoxExtent `true`, geometri diekspor sebagai point cloud (hanya vertex, tidak ada definisi face).
`verbose`	`boolean`	`false`	BoundingBoxExtent `true`, komentar diagnostik tambahan disertakan dalam output OBJ.
`serializeW`	`boolean`	`false`	BoundingBoxExtent `true`, komponen W dari koordinat vertex homogen ditulis ke dalam file.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, sumbu Y dan Z ditukar selama proses ekspor.
`applyUnitScale`	`boolean`	`false`	BoundingBoxExtent `true`, skala unit adegan diterapkan pada semua koordinat geometri selama proses ekspor.

StlSaveOptions

Simpan opsi untuk STL (.stl) output.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`binaryMode`	`boolean`	`false`	BoundingBoxExtent `true`, output ditulis sebagai binary STL (kompak, tidak dapat dibaca manusia). Ketika `false`, STL ASCII ditulis.
`flipCoordinateSystem`	`boolean`	`false`	BoundingBoxExtent `true`, sumbu Y dan Z ditukar selama ekspor.
`scale`	`number`	`1.0`	Faktor skala seragam yang diterapkan pada semua geometri selama ekspor.

BoundingBoxExtent

Simpan sebuah mesh sebagai STL biner.

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

Opsi pemuatan untuk STL (.stl) file. Baik STL ASCII maupun biner didukung secara otomatis; tidak ada properti yang mengendalikan deteksi.

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

StlLoadOptions memperluas LoadOptions dan tidak menampilkan properti tambahan yang terlihat oleh pengguna pada versi saat ini.

FbxSaveOptions

Opsi penyimpanan untuk FBX (.fbx) output.

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

BoundingBoxExtent

BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent	BoundingBoxExtent
`embedTextures`	`boolean`	`false`	BoundingBoxExtent `true`, gambar tekstur yang direferensikan disematkan di dalam arsip biner FBX. Ketika `false`, jalur tekstur ditulis sebagai referensi eksternal.

BoundingBoxExtent

Ekspor file FBX dengan semua tekstur tersemat.

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

Opsi pemuatan untuk FBX (.fbx) file. Mendukung baik FBX biner maupun ASCII.

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

FbxLoadOptions memperluas LoadOptions dan tidak mengekspos properti tambahan yang terlihat oleh pengguna pada versi saat ini.

Kelas Dasar

LoadOptions

Kelas dasar untuk semua objek opsi muat.

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

Berikan sebuah LoadOptions instansi subclass ke scene.open(filePath, options) atau scene.openFromBuffer(buffer, options).

SaveOptions

Kelas dasar untuk semua objek opsi simpan.

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

Berikan sebuah SaveOptions instansi subclass ke scene.save(filePath, options).