Bekerja dengan glTF dan GLB

Gambaran Umum

Aspose.3D untuk .NET mendukung membaca dan menulis glTF 2.0 (.gltf dengan aset terpisah) dan GLB (binary glTF satu berkas). Gunakan GltfLoadOptions untuk mengonfigurasi perilaku pemuatan dan GltfSaveOptions untuk mengendalikan output ekspor.

Memuat File glTF

Muat berkas .gltf atau .glb secara langsung dengan Scene.Open. Sediakan GltfLoadOptions untuk kontrol yang lebih halus:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

// Basic load
var scene = Scene.FromFile("model.gltf");

// Load with options
var opts = new GltfLoadOptions();
var sceneWithOpts = new Scene();
sceneWithOpts.Open("model.gltf", opts);

File glTF merujuk ke buffer dan tekstur .bin eksternal dengan path relatif. Simpan semua aset yang dirujuk di direktori yang sama dengan file .gltf saat memuat.

Menyimpan sebagai glTF atau GLB

Simpan setiap adegan sebagai glTF atau format GLB biner yang kompak:

using Aspose.ThreeD;
using Aspose.ThreeD.Formats;

var scene = new Scene();
scene.RootNode.CreateChildNode("box", new Aspose.ThreeD.Entities.Box());

// Save as glTF (separate JSON + .bin buffer)
scene.Save("output.gltf", FileFormat.GLTF2);

// Save as GLB (single binary file)
scene.Save("output.glb", FileFormat.GLTF2_Binary);

// Save with custom options — embed the binary buffer inside the JSON
var saveOpts = new GltfSaveOptions(FileFormat.GLTF2);
saveOpts.EmbedAssets = true;
scene.Save("output_embedded.gltf", saveOpts);

Mengontrol Format Gambar yang Disematkan

Ketika tekstur disematkan, kontrol bagaimana data gambar disimpan dengan GltfEmbeddedImageFormat:

var saveOpts = new GltfSaveOptions(FileFormat.GLTF2_Binary);
saveOpts.ImageFormat = GltfEmbeddedImageFormat.Jpeg;
scene.Save("output.glb", saveOpts);

`GltfEmbeddedImageFormat` nilai	Deskripsi
`Jpeg`	Enkode ulang tekstur yang disematkan sebagai JPEG (lossy, lebih kecil)
`Png`	Enkode ulang tekstur yang disematkan sebagai PNG (lossless)
`NoChange`	Pertahankan encoding asli (default)

API Quick Reference

Member	Deskripsi
`new GltfLoadOptions()`	Konfigurasikan glTF import
`new GltfSaveOptions(format)`	Konfigurasikan glTF/GLB export
`saveOpts.EmbedAssets`	Sisipkan buffer biner di dalam `.gltf` JSON
`saveOpts.ImageFormat`	Pengodean tekstur tersemat (`GltfEmbeddedImageFormat`)
`FileFormat.GLTF2`	Format target: terpisah `.gltf` + `.bin`
`FileFormat.GLTF2_Binary`	Format target: tunggal `.glb`

Lihat Juga

Aspose.3D for .NET — Enterprise Documentation
Dukungan Format — daftar lengkap format 3D yang didukung