GLB vs glTF: Web'de Konteyner ve Dağıtım Seçimi

Yeni başlayanlarda en sık kavram karışıklığı şudur: «.gltf uzantısı glTF formatı, .glb başka format» sanmak. Holodepth terminolojisinde glTF 2.0 spesifikasyonu her iki paketi de kapsar; uzantı yalnızca sunum biçimini seçer. Export aracı «glTF Binary (.glb)» veya «glTF Separate (.gltf + .bin + textures)» der; ikisi de validator'dan geçebilir.

Organizasyon belgesinin şeması JSON Yapısı · GLB içinde JSON bölümünde sabitlenmiştir: GLB içindeki JSON chunk ile diskteki model.gltf aynı alanları taşır. Bu sayfa o şemayı tekrarlamaz; «paket seçimi sahne semantiğini değiştirir mi?» sorusuna hayır der ve dağıtım sonuçlarına odaklanır.

İki paket de aynı nodes, materials, animations grafiğini taşıyabilir. Fark, bu grafiğin ve binary yükünün tarayıcıya kaç HTTP cevabıyla ve hangi önbellek anahtarıyla ulaştığıdır.

GLB, web vitrininde en sık görülen pakettir çünkü operasyonel olarak basittir: bir URL, bir dosya, bir MIME tipi. CDN'e chair-v3.glb koyarsınız; loader tek fetch ile JSON ve binary buffer'ı birlikte alır. Chunk sınırları (JSON / BIN / isteğe bağlı ek chunk'lar) spesifikasyonda tanımlıdır; byte-level okuma File Structure'dadır.

GLB'nin dağıtım avantajları (stratejik, sayısız):

• Taşıma bütünlüğü: .bin veya doku dosyası «yanlışlıkla unutulmaz» (gömülü görüntü profilinde)
• Göreli URI kırılganlığı yok: tek dosya başka dizine taşınsa iç referanslar chunk offset ile çözülür
• CMS / DAM entegrasyonu: tek asset kaydı, tek versiyon hash'i
• Üçüncü parti viewer: model-viewer, Sketchfab benzeri akışlar GLB bekler

GLB'nin dağıtım maliyetleri:

• Kısmi güncelleme yok: yalnızca albedo değişse bile tüm GLB yeniden yayınlanır (hash değişir)
• Paralel indirme yok: mesh ve ağır 4K doku aynı pakette sırayla parse edilir (gömülü profilde)
• İnsan okunabilir diff yok: CI'da JSON satır diff'i doğrudan yapılamaz
• Chunk padding: çok küçük ekler bile hizalama nedeniyle birkaç byte ekleyebilir (boyut detayı Dosya Boyutu'nda)

Gömülü görsellerle tam GLB

«Tam GLB» profilinde görseller bufferView ile BIN chunk içinde veya ayrı chunk'ta taşınır; harici PNG isteği oluşmaz. E-ticaret vitrininde bu, «tek dosya garantisi» sağlar. Dezavantaj: aynı doku birden çok GLB'de tekrarlanırsa CDN deduplication çalışmaz; ortak doku kütüphanesi için modüler paket veya harici URI düşünülür ( Texture References · URI vs bufferView).

Modüler paket tipik olarak şunları içerir: model.gltf (JSON), model.bin (geometri / animasyon binary), textures/*.png veya *.ktx2. JSON'daki buffers[].uri ve images[].uri bu dosyalara göreli yollarla işaret eder. Paket bir klasör sözleşmesidir; yalnızca .gltf dosyasını kopyalamak yetmez.

product-chair/
  model.gltf          ← organizasyon (JSON)
  model.bin           ← buffer[0]
  textures/
    albedo.png
    normal.png
    orm.png

Modüler paketin dağıtım avantajları:

• Paralel fetch: HTTP/2 ile .bin ve dokular eşzamanlı iner
• Parça parça cache: mesh aynı kalırken yalnızca albedo.png güncellenebilir
• Paylaşılan doku: birden çok .gltf aynı shared/brick.png URI'sine gidebilir
• İnceleme: JSON metin diff, sanatçıya anlaşılır PR
• Progressive enhancement: önce düşük çözünürlük doku, sonra swap (ürün kodu + CDN yolu)

Modüler paketin riskleri:

• Yol kırılması: ../textures/foo.png deploy dizini değişince 404
• Eksik dosya: ZIP'ten yalnızca .gltf çıkarılırsa beyaz model
• CORS: .bin veya doku farklı origin'de ise header gerekir
• İstek sayısı: HTTP/1.1'de çoklu round-trip (Runtime Performans'ta ölçüm)

Data URI tuzağı

Modüler .gltf içinde görselleri veya küçük .bin'i base64 data URI olarak gömmek teknik olarak geçerlidir; dağıtım açısından çoğu zaman kötü fikirdir. JSON şişer, gzip verimsizleşir, diff imkânsızlaşır, tarayıcı belleğinde çift kopya oluşabilir. Holodepth kuralı: data URI yalnızca prototip; üretimde harici dosya veya GLB bufferView.

Konteyner seçimi doğrudan ağ davranışını şekillendirir. GLB tek istekte TTFB sonrası tüm paket akar; modüler paket önce küçük JSON alır, ardından URI listesinden kaynakları çeker. Loader bu ikinci aşamayı otomatik yapar; bu sayfa loader API'sini değil, ürünün beklediği istek desenini anlatır.

Holodepth perspektifi: «tek istek her zaman daha hızlı» yanlıştır. Küçük JSON + üç paralel doku, dev bir GLB'nin tamamının inmesini beklemekten mobilde daha hızlı ilk render verebilir (düşük LOD doku stratejisi). Kesin sayılar Runtime Performansı'nda ölçülür; burada desen seçilir.

MIME tipleri ve CORS

Sunucu model/gltf-binary (.glb) ve model/gltf+json (.gltf) döndürmelidir; yanlış Content-Type bazı ortamlarda loader uyarısı üretir. Modüler pakette .bin için application/octet-stream veya application/gltf-buffer yaygındır. Kaynaklar farklı CDN origin'inde ise CORS header'ları zorunludur; GLB tek origin'de bu riski azaltır.

Web dağıtımında konteyner seçimi cache politikasını belirler. GLB genelde içerik hash'i ile adlandırılır (chair-a8f2.glb) ve uzun süreli cache alır; dosya değişince URL değişir. Modüler pakette mesh ve doku ayrı cache anahtarına sahip olabilir: model.bin aylarca aynı kalır, albedo-v2.png haftalık güncellenir.

• GLB + hash: basit invalidation, tek atomik versiyon
• Modüler + hash per file: ince invalidation, daha fazla URL yönetimi
• Query string cache busting (?v=3): çalışır ama CDN config'e bağlı; hash dosya adı daha güvenilir

Service Worker kullanan PWA'larda GLB tek cache entry; modüler paket parça parça precache listesine girer. Yanlış precache «eski doku + yeni mesh» karışımı üretebilir; versiyon etiketini tüm paket dosyalarında senkron tutun.

CMS'te kısmi güncelleme senaryosu

Ürün konfigüratöründe yalnızca renk dokusu değişirken mesh sabitse modüler .gltf veya harici URI'li GLB mantıklıdır. Tüm varyantlar KHR_materials_variants ile tek GLB'de de kalabilir; o zaman cache tek hash'te kalır, runtime seçim yapılır. Konteyner seçimi ile variants uzantısı birlikte düşünülmelidir: «dosya mı çoğaltıyoruz, materyal eşlemesi mi?»

Konteyner kararı görüntülerin nerede yaşayacağını bağımsız olarak belirler. Spesifikasyon dört pratik profil sunar; alan detayları Texture References'ta kalır.

BasisU / KTX2 dokuları büyük olduğunda harici URI + ayrı cache anahtarı sık tercih edilir ( KHR_texture_basisu). Draco sıkıştırılmış geometri GLB BIN chunk içinde kalırken dokular modüler bırakılabilir; hibrit paket «en iyi iki dünya» arayışının sonucudur, spec ihlali değildir.

Konteyner seçimi yalnızca runtime'ı değil geliştirme hattını da etkiler. Modüler .gltf, git diff'te anlamlı satır değişiklikleri gösterir: «material 2 baseColorTexture index değişti» gibi. GLB binary diff okunaksızdır; CI'da genelde «byte değişti mi?» hash karşılaştırması yapılır.

• Sanatçı teslimi: klasör ZIP (modüler) veya tek GLB (basit handoff)
• Validator: her iki paket tipinde çalışır; hata mesajı aynı JSON şemasına referans verir
• Golden screenshot test: paket tipinden bağımsız; görsel regresyon aynı
• Acil debug: .gltf metin editörde açılır; GLB için glTF Inspector / dönüştürücü gerekir

Holodepth önerisi: repo'da modüler .gltf, CDN'de hash'li GLB üretim profili. Export pipeline otomatik GLB üretir; kaynak modüler kalır. İki artefakt aynı validator'dan geçer; dağıtım atomik GLB, inceleme modüler JSON olur. «Yalnızca GLB commit» teknik borç biriktirir.

Sıkıştırma uzantısı ve paket tipi

Draco export çoğu araçta GLB çıktısı verir; modüler .gltf + Draco da mümkündür. Paket tipi Draco'nun çalışıp çalışmadığını belirlemez; extension flag'i belirler ( Draco Mesh Compression). Ancak operasyonel olarak Draco'lu asset'ler web'de neredeyse her zaman GLB olarak servis edilir.

Matris kesin kural değil, başlangıç noktasıdır. Nihai seçim byte bütçesi ( Dosya Boyutu) ve ölçülen waterfall ( Runtime Performansı) ile doğrulanır.

«Her zaman GLB» ve «her zaman modüler» ikisi de yanlıştır. Holodepth üretim hattı çoğu ekipte hibrittir: modüler kaynak, GLB dağıtım, harici KTX2 istisna.

«GLB tek dosyadır, .gltf çok dosyadır» özeti yeterli değildir. Aşağıdaki tuzaklar üretim ekiplerinde haftalarca debug yemekten kurtarır.

CDN path rewrite ve göreli URI

Modüler .gltf'te textures/albedo.png yolu, .gltf dosyasının URL'sine göredir. CDN kökünü /assets/v2/chair/model.gltf yapıp dokuları /textures/global/ altına taşırsanız JSON'daki URI'leri de güncellemeniz gerekir. GLB bu sınıf hatayı azaltır; hibrit pakette harici URI mutlak CDN URL'si olmalıdır.

Çift fetch: hem .gltf hem .glb

Bazı ekipler «fallback» diye hem modüler hem GLB yayınlar; uygulama yanlışlıkla ikisini de yükler. Tek paket politikası belirleyin; diğerini build artefaktı olarak saklayın, public CDN'de ikisini birden expose etmeyin.

ZIP handoff ve eksik alt klasör

Sanatçıdan gelen ZIP'te textures/ gizli dosya veya yanlış büyük/küçük harf (Linux CDN vs Windows export) 404 üretir. GLB handoff bu sınıf sorunu azaltır; modüler pakette ZIP manifest checklist'i (gltf + bin + tüm URI'ler) CI kapısı olsun.

GLB sanılan ama harici URI'li dosya

Uzantısı .glb olsa bile JSON chunk içinde images[].uri harici URL olabilir. Tek dosya sanılıp CDN politikasını buna göre kurmak «yarım GLB» tuzağıdır. Validator ve glTF Inspector ile URI envanteri çıkarın.

Subresource Integrity (SRI)

Modüler pakette .bin ve dokulara SRI hash eklenebilir; GLB tek hash ile SRI uygulanır. Güvenlik odaklı sitelerde konteyner seçimi integrity modelini etkiler; çok parçalı paket daha fazla hash yönetimi ister.

Bölgesel CDN ve aynı GLB

Tek hash'li GLB tüm edge'lere replike edilir; modüler pakette yalnızca değişen doku bölgesel cache'te güncellenir. Global kampanya «yalnızca sticker doku değişti» senaryosunda modüler veya harici URI kazanır.

Sekiz soruluk paket teşhisi

GLB mi modüler .gltf mi sorusu yanıtlandı. Web İçin Kullanım hattının üçüncü ve dördüncü adımları sayısal analize iner:

1. Byte bütçesi Dosya Boyutu Analizi: padding, gömülü vs harici doku, Draco/Basis kazancı
2. Runtime maliyeti Runtime Performansı: parse, decode, GPU upload, waterfall süresi

Format sözleşmesi File Structure ve Materyal dallarında; stratejik «neden» Neden glTF sayfasında kalır. Loader sahne kurulumu glTF Pipeline (Three.js) ile tamamlanır.

Format okuyucusu özeti: GLB ve .gltf aynı glTF 2.0 belgesini farklı paketler. GLB tek istek ve bütünlük; modüler paralel fetch ve kısmi cache. Hibrit profiller geçerlidir; seçim ürün senaryosu, ölçüm ve ekip iş akışına göre yapılır.