Skinning glTF'de Kemik–Köşe Deform Sözleşmesi

DCC'de skinning «paint weight + bind» sürecidir. glTF'de süreç bitmiş sonuçtur: hangi köşenin hangi joint slotuna hangi ağırlıkla bağlı olduğu binary'de durur; paint brush yoktur. Bu yüzden web'de weight düzeltemezsiniz; yeniden export gerekir.

Skinning şunların hiçbiri değildir:

• Keyframe tablosu değil hareket örnekleri Keyframe sayfasında
• Channel path değil «rotation'a yaz» Channels sayfasında
• Morph shape değil delta pozisyon Morph Targets'ta
• SkinnedMesh API değil Three.js Skinning System sayfasında
• Physics / cloth sim değil format dışı

Channel «kemik nereye gitti?» der. Skin «köşe o kemiği ne kadar dinliyor?» der. İkisi olmadan karakter ya boş hiyerarşi döner ya da donuk mesh kalır.

Kök JSON'daki skins dizisinin her elemanı bir iskelet tanımıdır. Tipik alanlar:

"skins": [{
  "name": "Character_Armature",
  "joints": [2, 3, 4, 5, 6, …],
  "inverseBindMatrices": 42,
  "skeleton": 1
}]

• joints: nodes[] indekslerinin sıralı listesi (joint slot sırası)
• inverseBindMatrices: MAT4 accessor indeksi; uzunluk = joints uzunluğu
• skeleton (isteğe bağlı): ortak kök node indeksi (armature root)

Holodepth kritik ayrım: joint slot indeksi (0…N−1, joints dizisindeki konum) ile node indeksi (nodes[] içindeki gerçek numara) aynı şey değildir. JOINTS_0 attribute'u joint slot yazar; channel target.node ise node indeksidir. Karıştırmak «yanlış kemik dönüyor» semptomunun bir numaralı nedenidir.

Skinsiz dosya geçerlidir

Statik prop'larda skins yoktur. Skin «zorunlu katman» değil; karakter / organik deform ihtiyacında gelir. «Animasyon var = skin var» da yanlıştır: root node translation animate edilebilir, skin olmadan mesh katı taşınır.

Bind pose, mesh'in «giydirildiği» referans pozudur. Her joint için bir inverse bind matrix (IBM), o joint'in bind anındaki dünya (veya skin uzayı) transformunun tersidir. Deform formülünün özü:

// Kavramsal (runtime uygular; dosya matrisi taşır)
skinned = Σ (weight_i × jointMatrix_i × IBM_i × bindPosition)

Dosya yalnızca IBM accessor'ını taşır; canlı jointMatrix her karede node hiyerarşisinden hesaplanır. IBM yanlışsa (yanlış uzay, yanlış sıra, eksik joint) mesh «patlar», «içe çöker» veya bind'den asla çıkmaz. Bu semptomlar channel keyframe'inden bağımsızdır: Idle clip bile bozuk IBM ile çöker.

Count uyumu

inverseBindMatrices accessor count = joints.length olmalıdır. Eksik veya fazla IBM bozuk dosyadır. Accessor tipi MAT4, bileşen tipi tipik FLOAT'tur. Accessor Mantığı okuma kurallarını verir; bu sayfa «neden MAT4 dizisi?» sorusunu sorar.

Bind vs rest vs t0

Bind pose export anındaki skin referansıdır. Rest pose node'ların statik TRS'idir. Clip'in t=0 keyframe'i üçüncü bir poz olabilir. Üçü hizasızsa oynatma başında «bir kare snap» görülür ( Keyframe · rest pose). Skinning teşhisinde önce IBM bütünlüğüne, sonra rest/t0 hizasına bakın.

Skinned primitive'in attributes haritasında en az bir çift bulunur:

Genel attribute sözlüğü Vertex Verileri'ndedir; burada semantik netleşir: JOINTS değeri skin.joints dizisindeki sıra numarasıdır, node indeksi değildir. WEIGHTS_0.x, JOINTS_0.x slotuna aittir; bileşen hizası bozulursa yanlış kemik «yağlanır».

Ağırlık toplamı

Pratikte köşe başına ağırlıklar normalize edilir (toplam 1). Spec her validator'un aynı sıkılığı uygulamaz; 0.97…1.03 aralığı yaygındır. Sıfır toplamlı köşe «hiçbir kemiğe bağlı değil» demektir: o köşe bind'de donar veya orijine çöker. Holodepth envanter: WEIGHTS sum histogramı (pipeline tool) bozuk paint'i erken yakalar.

4-bone (VEC4) limiti

Core pratikte köşe başına 4 joint etkisi (JOINTS_0) standarttır. Daha fazla etki için JOINTS_1 gerekir; birçok runtime yalnızca _0'ı garanti eder. Export «8 influence» DCC ayarı web'de sessizce 4'e kırpılabilir: omuz/kalça kırışması artar. Bu, Three.js kemik limiti anlatımının (Skinning System · kemik limiti) format yüzüdür: dosyada kaç set attribute var?

Skin'i mesh'e bağlayan tipik yol: bir nodes[i] hem mesh hem skin indeksi taşır. Skin indeksi skins[] elemanına işaret eder. Primitive attributes JOINTS/WEIGHTS taşımazsa skin indeksi anlamsızlaşır; JOINTS varsa ama node.skin yoksa loader skinned mesh üretemeyebilir.

"nodes": [{
  "name": "Body",
  "mesh": 0,
  "skin": 0
}]

Bir dosyada birden fazla skin olabilir (ayrı ekipman, ayrı karakter). Aynı skin'i paylaşan birden fazla mesh de mümkündür (LOD, giysi katmanı). Holodepth: «kaç skin?» ile «kaç skinned mesh node?» sayılarını ayrı raporlayın.

skeleton alanı

İsteğe bağlı skeleton, joint hiyerarşisinin ortak köküne işaret eder. Runtime iskeleti bu kökten gezinebilir. Eksikliği her zaman hata değildir; joints listesi yeterlidir. Yanlış skeleton kökü helper çiziminde veya pose reset'te sapma üretir; deform formülünün kendisi joints + IBM + weights üçlüsüne dayanır.

Animasyon channel'ı joint node'unun TRS'ini yazar. Skin, köşeleri joint slot'larına bağlar. Aynı fiziksel kemik iki dilde yaşar:

Holodepth teşhis cümlesi: «SkeletonHelper dönüyor, yüzey duruyor» → skin / weights sorunu. «Yüzey de helper da duruyor» → channel / clip sorunu. «Yüzey patlıyor» → IBM / slot indeksi sorunu.

DCC'deki IK, constraint ve control bone'lar glTF'e çoğu zaman bake edilmiş joint TRS + sabit skin weights olarak düşer ( Keyframe · bake). Skin weights bake edilmez: paint sonucu olduğu gibi taşınır (veya influence limiti ile kırpılır).

• Apply bind atlanursa IBM ile mesh uzayı uyuşmaz
• Non-deformer bone joints listesine girerse boş slot şişer
• Mirror / negatif scale IBM ve normal/tangent ile birleşir ( Tangent notu)
• Çoklu armature yanlış skin indeksine bağlanırsa yanlış iskelet giydirilir

FBX→glTF dönüşümünde joint sırası değişebilir; JOINTS indeksleri eski sıraya göre kaldıysa patlama görülür. Holodepth: dönüşüm sonrası joints sırası + IBM count + max(JOINTS) < joints.length üçlüsünü doğrulayın.

GLTFLoader skins + JOINTS/WEIGHTS + node.skin üçlüsünü SkinnedMesh + Skeleton + Bone ağacına çevirir. Bu çevirinin API yüzü Skinning System sayfasındadır. Format okuyucusu için yeterli soru: dosyada skin var mı, attributes tam mı, IBM count uyumlu mu, joint slot aralığı geçerli mi?

«Skinning = weights» özeti üretim teşhisini yarım bırakır. Aşağıdakiler sık, az yerde derin işlenir.

Root motion vs skinned walk

Karakter «yürüyor» sanılır ama yalnızca root node kayıyorsa ayaklar kayar (slide). Skin + bacak joint channel'ları yoksa bu beklenen davranıştır. Keyframe sayfasındaki «mesh animate olmuyor» notunun tamamlayıcısı: skin var mı, bacak joint'leri channel hedeflerinde mi?

Joint slot taşması

JOINTS değeri ≥ joints.length ise tanımsız erişimdir. Export hatası veya joints listesi kısaltması sonrası artığından kalır. Validator kaçırabilir; max(JOINTS) taraması Holodepth envanterinin parçası olmalıdır.

Paylaşılan skin, farklı mesh

Giysi ve beden aynı skin'i paylaşırsa tek iskelet iki yüzeyi eğer. Ayrı skin + ayrı armature ise iki iskelet senkronu gerekir (çift clip veya retarget). Format ikisini de destekler; ürün senkron politikası runtime'dadır.

JOINTS var, skin yok

Bazı bozuk export'lar attribute bırakıp node.skin yazmaz. Dosya «skinned gibi» görünür ama loader static mesh üretir. Tersine skin var, JOINTS yok: boş deform. İki yönlü tutarlılık şarttır.

TBN + skin

Skinning pozisyonu eğer; normal/tangent de joint matrisleriyle dönmelidir. Yalnızca POSITION skinlenip TBN sabit kalırsa ışık «yüzeyde kayar». Format attribute seti tam olsa bile runtime shader yolu eksik olabilir; teşhiste format mı shader mı ayırın ( Tangent Verileri ).

Altı soruluk skin teşhisi

Kemik–köşe bağı netleşince sıradaki format sorusu şekil anahtarlarıdır:

1. Morph Targets delta geometri, weights channel
2. Runtime deform Skinning System
3. Oynatma AnimationMixer

Format okuyucusu özeti: skin = joint kataloğu + IBM; köşe = JOINTS/WEIGHTS; node.skin = giydirme bağı. Channel askıyı döndürür, skin kumaşı tutturur.