KHR_texture_basisu glTF'de KTX2 Doku Sözleşmesi

PNG/JPEG core yolunda image byte'ları doğrudan decode edilir. BasisU yolunda byte'lar KTX2 dosya formatıdır; içinde Basis Universal süper sıkıştırma ve çoğu zaman mip zinciri vardır. glTF uzantısı bu yolu resmen ilan eder; aksi halde loader PNG sanıp KTX2 byte'larını çözemez.

Bu sayfa şunların hiçbiri değildir:

• Draco geometri değil mesh compression ayrı uzantı
• Materyal clearcoat/sheen değil materyal uzantıları Extension Sistemi'nde
• Basis codec matematiği değil Three.js Basis Universal sayfasında
• WebP/AVIF HTTP transport değil glTF image kaydı sözleşmesi

Texture Referansları «texture nereye bakar» der. BasisU «o görüntü KTX2 mi, ilan var mı» der. KTX2 runtime sayfası «transcode sonrası GPU ne görür» der.

Kök JSON ilanı ( Extension · Used/Required):

"extensionsUsed": ["KHR_texture_basisu"],
"extensionsRequired": ["KHR_texture_basisu"]

Holodepth üretim pratiği: KTX2-only paketlerde Required yazın. Core PNG fallback yoktur; Used-only + transcoder eksikliği «beyaz/mor texture» veya sessiz atlama üretebilir. Extension Sistemi örneğinde clearcoat Used yeterli iken BasisU sık Required'dır çünkü görüntü yorumu uzantıya bağlıdır.

BasisU'nun kalbi images dizisindedir. Tipik kayıt:

"images": [
  {
    "mimeType": "image/ktx2",
    "bufferView": 12
  },
  {
    "mimeType": "image/png",
    "bufferView": 13
  }
]

mimeType: "image/ktx2" zorunlu pratiktir; loader bu bayrağı görmeden KTX2 decode yoluna girmez. bufferView (GLB içi) veya uri (harici .ktx2) core image kurallarına tabidir ( Texture Referansları · images).

Karışık image paketi

Aynı dosyada bazı image'ler KTX2, bazıları PNG olabilir (ör. UI decal PNG, PBR seti KTX2). Holodepth envanter: image başına mimeType histogramı. «Tam KTX2 paket» varsayımı yanlıştır; Required yalnızca «en az bir KTX2 var» demek değil, «KTX2 olmadan dosya anlamsız» demektir.

Core PNG yolu yok

Required BasisU paketinde aynı texture için paralel PNG «yedek» taşımak zorunlu değildir ve genelde yapılmaz. Eski viewer desteği gerekiyorsa ayrı export hedefi (dual pipeline) ürün kararıdır; tek dosyada iki encoding nadirdir.

Core texture kaydı değişmez: sampler + source (image indeksi). BasisU uzantısı textures[i].extensions altında görünebilir:

"textures": [{
  "sampler": 0,
  "source": 0,
  "extensions": {
    "KHR_texture_basisu": {
      "source": 0
    }
  }
}]

Extension içindeki source, hangi image'in KTX2 kaynağı olduğunu açıkça işaret edebilir (çoğu export'ta üst source ile aynıdır). Holodepth okuma: texture → source image → mimeType ktx2 mi? → bufferView byteLength.

Materyal tarafında baseColorTexture.index, normalTexture.index vb. hâlâ texture tablosuna işaret eder ( PBR Yapısı). BasisU yalnızca image encoding'i değiştirir; slot anlamı (albedo linear/sRGB politikası runtime'da) aynı kalır.

BasisU, texture zincirini kırmaz; ortadaki halkayı «sıkıştırılmış» yapar:

materials[i].pbrMetallicRoughness.baseColorTexture.index
  → textures[j].source
  → images[k].mimeType === "image/ktx2"
  → images[k].bufferView
  → bufferViews[m] → buffers[0] (GLB BIN)

Holodepth debug sırası: materyal slot dolu mu ( Material Slots) → texture index geçerli mi → image mimeType → blob var mı. «Mor/pembe texture» çoğu zaman zincir kırığı değil, transcoder veya GPU format eksikliğidir (runtime); ama mimeType yanlışsa format katmanı da kırmızıdır.

Sampler aynı kalır

Wrap, filter, anisotropy samplers[] tablosundadır; BasisU bunları değiştirmez. KTX2 içinde mip seviyeleri gömülü olabilir; runtime minFilter seçimi yine sampler + texture policy ile birleşir (detay Three.js KTX2 dalında).

glTF dosyasında ASTC/BCn/DXT GPU texture yoktur. Dosya KTX2 + Basis süper sıkıştırma taşır; GPU'ya uygun format seçimi loader/transcoder'da ( Transcoding Process) gerçekleşir.

Holodepth trade-off: indirme MB ve VRAM kazancı (runtime) karşılığında transcoder bağımlılığı ve ilk yükleme maliyeti. Format sayfası süre vermez; süre Performance Analysis konusudur.

Üretimde ideal «çift sıkıştırma» sık görülür:

• Draco vertex/index baytı ( Draco)
• BasisU texture baytı (bu sayfa)
• Animasyon çoğu zaman sıkıştırılmaz (Keyframe sayfası)

Dosya boyutu raporunda üç kalem ayrı yazılmalıdır. Yalnızca Draco uygulayıp texture PNG bırakmak «hâlâ ağır GLB» üretir; tersine yalnızca BasisU ile ham geometri de büyük kalır. İki Required uzantı = iki decoder/transcoder bağımlılığı; ürün uyumluluk matrisi buna göre genişler.

Morph / skin Draco dışı kalabilir

BasisU morph delta veya IBM sıkıştırmaz. Tam karakter paketinde dört katman: Draco mesh, KTX2 materyal, ham morph (veya sparse), animasyon accessor'ları.

Format katmanında slot ismi değişmez; hangi image'in KTX2 olduğu export politikasıdır. Tipik web paketi:

Kanal paketleme (ORM tek texture) hâlâ materyal kartı tasarımıdır; BasisU yalnızca o kartın image byte'ını küçültür. UV semantiği ( UV Kanalları) değişmez.

«KTX2 = küçük texture» özeti üretimde yetersiz kalır.

mimeType unutulması

KTX2 byte'ları doğru bufferView'da ama image/png yazılıysa loader PNG decode dener ve başarısız olur. Envanterde her KTX2 blob için mimeType eşlemesi şarttır.

Alpha ve normal hassasiyeti

Agresif Basis sıkıştırma albedo alpha veya normal detayını yumuşatır; bu format hatası değil, encode kalite seçimidir. Master PNG/KTX source ile dağıtım KTX2'sini karşılaştırın (encode sayfası Three.js'te).

Harici .ktx2 URI

GLB gömülü değil, yan .ktx2 dosyaları geçerlidir. CORS ve cache politikası runtime CDN katmanıdır; format yalnızca uri + mimeType yazar.

Paylaşılan image

İki texture aynı KTX2 image'i paylaşabilir (farklı sampler). Bir image KTX2'ye çevrilince her iki slot da transcoder gerektirir; Required ilanı tüm paylaşımlı tüketiciler için geçerlidir.

Validator vs viewer

JSON şema geçerli, transcoder yok: viewer boş kalır. Holodepth: CI'da hem validator hem decoder'lı smoke load koşun.

Altı soruluk BasisU teşhisi

Doku sıkıştırması netleşince Uzantılar grubunda sıradaki konular:

1. EXT_mesh_gpu_instancing çoğaltma attribute'ları
2. KHR_materials_variants materyal varyant seçimi
3. Runtime KTX2 KTX2 nedir?

Format okuyucusu özeti: BasisU = KTX2 image + ilan; texture zinciri core ile aynı; transcoder runtime'dadır. Draco ile birlikte tam GLB diyeti yapılır; animasyon ayrı kalemdir.