SEBELUM DIGUNAKAN

Kompresi GLB dan kompatibilitas penampil

Ekstensi file GLB tidak menjamin bahwa setiap aplikasi dapat memuat isinya. Periksa ekstensi yang digunakan oleh output, lalu uji di aplikasi yang akan digunakan.

Sesuaikan pengaturan dengan pemuat

Persyaratan ini dapat berlaku bersamaan. Panel hasil melaporkan informasi kompatibilitas output. Pratinjau kami menyertakan dekoder, jadi keberhasilan pratinjau tidak membuktikan aplikasi Anda sudah mengonfigurasikannya.

Preset menggunakan kuantisasi geometri secara bawaan. Menonaktifkannya dapat menghapus persyaratan kuantisasi geometri, tetapi Meshopt atau tekstur yang dikonversi tetap memerlukan pemuat terkait. Periksa ekstensi yang dilaporkan untuk hasil sebenarnya.

Menggunakan Three.js

Untuk geometri yang dikompresi dengan Meshopt, daftarkan dekoder melalui GLTFLoader.setMeshoptDecoder(). Untuk tekstur KTX2, konfigurasikan KTX2Loader, deteksi dukungan renderer, lalu hubungkan melalui setKTX2Loader(). Sediakan file transcoder yang sesuai bersama aplikasi Anda dan gunakan dokumentasi untuk versi Three.js yang Anda pakai.

dokumentasi GLTFLoader · dokumentasi KTX2Loader

Contoh: versi asli bisa dimuat, tetapi ekspor File lebih kecil gagal

Pertahankan tekstur asli dan ekspor sumber yang sama dua kali: sekali dengan Konservatif dan sekali dengan File lebih kecil. Jika hanya file kedua yang gagal dalam aplikasi, periksa ekstensi yang dilaporkan dan galat pemuat sebelum mengubah geometri. Perbandingan ini mempersempit masalah ke perubahan persyaratan pemuatan; bukan membuktikan bahwa setiap kegagalan disebabkan dekoder yang hilang.

Untuk hasil EXT_meshopt_compression di Three.js, daftarkan MeshoptDecoder sebelum memuat. Lalu coba kembali file ekspor yang sama. Mengekspor ulang tanpa kompresi merupakan alternatif jika tujuan tidak dapat diubah, tetapi unduhannya berpotensi lebih besar.

Contoh: tekstur asli berfungsi, tetapi KTX2 gagal setelah penerapan

Pertahankan pengaturan geometri dan bandingkan tekstur asli dengan KTX2. Untuk aplikasi Three.js, pastikan KTX2Loader terhubung dan detectSupport sudah dijalankan. Periksa permintaan basis_transcoder.js dan basis_transcoder.wasm. Respons 404 atau halaman HTML aplikasi pada URL tersebut menunjukkan masalah penyajian aset, bukan kualitas tekstur.

Uji ulang output KTX2 yang sama setelah memperbaiki pemuat atau jalur aset, termasuk pada perangkat seluler tujuan. File yang dimuat dalam pratinjau situs ini telah lolos pada konfigurasi penampil ini; penampil produksi Anda tetap harus memenuhi persyaratan pemuatannya sendiri.

Nama, extras, dan perilaku scene

Ketiga opsi untuk mempertahankan data aktif secara bawaan. Biarkan aktif jika aplikasi mencari objek atau material berdasarkan nama atau membaca extras. Opsi ini tidak menjamin indeks node, hierarki, sampel animasi, atau atribut khusus tetap identik. Optimasi dapat menggabungkan atau menyusun ulang data dan mengubah presisi.

Uji pemilihan, pergantian material, pemutaran animasi, morph target, dan transformasi objek dalam aplikasi sebenarnya. Opsi Pertahankan extras bukan cara mempertahankan sembarang ekstensi khusus.

Batasan input

Layanan ini menolak input terkompresi Draco, sumber daya eksternal, dan ekstensi wajib yang tidak didukung. Ekstensi opsional yang tidak dikenal mungkin dihapus. Jika perlu, ekspor GLB tanpa kompresi dengan sumber daya tertanam dari aplikasi sumber.

Untuk daftar ekstensi mesin dan perilaku optimasi, lihat dokumentasi resmi gltfpack. Layanan web menerapkan validasi dan batas sumber daya tambahan.

Memuat model gltfpack di Three.js →