Stüdyo Adlandırma: Runtime Sözlüğü Sözleşmesi

Birçok stüdyo adlandırma konusunu «temiz Outliner» estetiğine indirger. Web hattında isim başka bir şeydir: loader sonrası kod, QA script'i, animasyon sözlüğü ve asset kartı aynı string'e güvenir. Holodepth modeli: isim, DCC'ler arası taşınabilir kimliktir. Outliner'da güzel görünen ama export'ta değişen veya boşluk / parantez taşıyan adlar runtime'ı bozar.

Sözleşme üç tarafa hizmet eder: sanatçı (ne ürettiğini bilir), teknik sanatçı (export checklist'inde arar), geliştirici (sahneyi isimle bağlar). Üçünden biri farklı dil konuşursa «model geldi ama bağlanmadı» ticket'ı açılır; kök neden çoğu zaman materyal veya mesh değil, isim sapmasıdır.

Güzel isim opsiyoneldir; kararlı isim zorunludur.

Tek «asset adı» her şeyi çözmez. Holodepth beş katmanı ayırır; karıştırmak klasik cinayettir:

1. Dosya / paket kimliği: diskteki hero_chair.glb veya klasör adı. CDN ve cache buradan okur.
2. Kök / scene kimliği: glTF veya DCC'de export kökü; asset kartındaki «resmi ad» ile aynı olmalıdır.
3. Mesh / node kimliği: parçalar, LOD'lar, socket'ler; kod getObjectByName ile buraya tutunur.
4. Materyal kimliği: DCC materyal adı ile texture set öneki hizalıdır; «Material.001» web'e gitmez.
5. Clip / animasyon kimliği: Idle, Walk, Open gibi runtime sözlüğü; Action / take adı ile aynı token.

Texture dosya adları (BaseColor, ORM…) Painter yaprağının slot sözlüğüne aittir; stüdyo sözleşmesi onları önek + sonek kuralına bağlar: önek asset/kök ile aynı aile, sonek slot sözlüğü. Bu sayfa önek ve katman disiplinini yazar; sonek anlamını Painter'a bırakır.

Blender Collection adı export'a her zaman düğüm adı olarak düşmez. Graf üyeliği Collections / Empty yaprağındadır; burada «hangi string'in kimlik sayıldığı» yazılıdır.

Holodepth önerilen dilbilgisi (stüdyo kendi kelime dağarcığını seçer; sıra ve anlam sabit kalır):

{asset}_{role}_{variant?}_{lod?} · örnek: hero_chair_wood_lod1, avatar_head_skin, kit_socket_hand_l.

• asset: ürün veya karakter ailesi (kısa, tekil, ticket'taki adla aynı)
• role: mesh parçası, socket, collider, helper ayrımı (col, socket, mesh)
• variant: renk / malzeme / sezon (opsiyonel; «v2» değil semantik)
• lod: lod0… veya stüdyo LOD sözlüğü; sayısal sıra ticket'ta tanımlı

Clip'lerde ayrı ama akraba dil: {asset}_{clip} veya yalnızca {clip} (tek karakter paketinde). Holodepth: clip sözlüğü ürün wiki'sinde sabit liste; sanatçı yeni clip eklerken listeyi günceller, rastgele «Anim1» üretmez.

Ayırıcı seçimi (underscore vs camelCase) tek seferde yazılır ve tüm DCC'lere yayılır. Holodepth web hattında underscore'u tercih eder: dosya sistemi, URL ve çoğu DCC export'u boşluksuz underscore ile daha az sürpriz yaşar. CamelCase yasak değildir; karışık kullanım yasaktır.

Outliner Türkçe karakter, boşluk, noktalı virgül veya emoji kabul edebilir; CDN yolu ve bazı loader yolları etmez. Holodepth web teslim kimlikleri için dar set önerir:

• ASCII harf + rakam + underscore (ve gerekirse tek tire)
• Boşluk, parantez, köşeli parantez, «copy», «final» yok
• Başta rakam yok (bazı script / GLSL benzeri kurallar ve eski araçlar kırılır)
• Büyük/küçük harf politikası tek: ya hep küçük, ya Pascal; Windows case-insensitive / Linux case-sensitive tuzağı ticket notunda

Yerel dil tuzakları: Türkçe ı / ş / ğ DCC'de okunur, CI Linux runner'da dosya bulunamaz. Holodepth: kimlik katmanı ASCII; insan okunur etiket (UI label) ayrı alan olabilir ama export adı değildir.

Outliner'da okunan her karakter runtime'a gitmek zorunda değildir.

İki mesh'in aynı adı taşıması DCC'de «Cube.001» üretimiyle maskelenir; glTF'te iki node.name aynı string olduğunda getObjectByName ilkini alır, ikincisi sessizce kaybolur. Holodepth politikası:

• Export kökü altında her kodun aradığı isim benzersizdir
• Yalnızca görsel kalan dekoratif parçalar önek + numara ile bilinçli aile kurar (hero_chair_bolt_01…) veya kod aramaz
• «.tmp», «.bake», «.high» sonekleri teslim setine girmez; Deliver koleksiyonu / export set daraltır

Instance / linked kopyalar çoğalan isim üretir. Graf davranışı Collections yaprağındadır; adlandırma kuralı: instance'lar ya tek kaynak adına saygı duyar (runtime instance id ayrı) ya da export öncesi tekilleştirilmiş benzersiz ad alır. «Aynı isim, üç kopya» web'de üç kimlik sanılmaz.

LOD ve variant semantik token'dır; sürüm numarası değildir. _lod0 / _lod1 ticket'ta polygon / mesafe politikasına bağlanır. _red / _winter variant ailesidir. Buna karşılık _v3, _final, _final_really, _new kimlik değildir: tarihçe gürültüsüdür.

Holodepth: DCC içinde çalışma kopyası serbest olabilir; teslim kökü her zaman sözleşme adını taşır. «Chair_Final2» export edilecekse rename export set'inde veya Deliver öncesi yapılır. QA script'i final geçen adı kırmızı bayrak sayabilir.

Variant ile material swap karıştırılmamalıdır: bazen tek GLB içinde iki mesh variant, bazen tek mesh + texture set variant. Karar asset kartında yazılıdır; isim her iki durumda da hangi ailenin seçildiğini söyler.

Web cache stratejileri dosya adına içerik hash'i ekler (hero_chair-a8f2.glb). Bu, yayın katmanıdır; DCC kök adı ve runtime sözlüğü hash taşımaz. Holodepth ayrımı:

• Kimlik adı: stüdyo sözleşmesi (hero_chair)
• Yayın adı: build pipeline hash / sürüm soneki
• Kaynak kontrolü: git commit / DCC dosya hero_chair_wip.blend gibi çalışma adları teslim kimliğinden ayrı tutulabilir

Sanatçı WIP adını export köküne yapıştırırsa her build'de kod kırılır. Tersine, her texture'a hash koymak Painter slot eşlemesini de bozar. Hash'i build'e bırakın; sözleşmeyi DCC'de sabitleyin.

glTF/GLB cache ve paket tartışması format izleğindeki web kullanım sayfalarındadır; burada yalnızca «kimlik ≠ yayın dosya adı» diplomasi vardır.

Maya namespace, Max Layer, C4D Object Manager, Blender Outliner farklı ağaçlar gösterir; sözleşme string'i aynı kalır. Holodepth pratikleri:

• Export öncesi «isim scrub» checklist: kök = asset kartı, clip listesi = wiki, texture önek = asset
• Interchange (FBX ara) kullanılıyorsa ara dosya da aynı kök adını taşır; «maya_export_temp» ara istasyonu teslim adı olmaz
• Painter proje / texture öneki stüdyo asset token'ı ile başlar; slot sonekleri Painter sözlüğünde

Maya → glTF, C4D/Max interchange ve Blender exporter yaprakları «nasıl çıkarılır»ı anlatır; bu yaprak «çıktıdaki string ne olmalı»yı yazar. İkisini karıştırmak tutorial tekrarına düşer.

Ticket diline yapışan üç sözleşme yoğunluğu:

• 01 · Name

  Tek kök vitrin

  Kapsam

  Tek asset · az node

  Kural

  Kök = dosya gövdesi · clip yok veya az

  Risk

  Final / copy sonekleri

• 02 · Name

  Avatar / kit sözlük

  Kapsam

  Socket · LOD · clip listesi

  Kural

  Token dilbilgisi zorunlu · benzersiz aranan adlar

  Risk

  Instance çarpışması · clip sapması

• 03 · Name

  Çok-DCC stüdyo

  Kapsam

  Maya+Blender+Painter aynı token

  Kural

  Wiki sözlük · export scrub checklist

  Risk

  Lehçe konforu kimliği ezer

İsim bir API yüzeyidir

Kod ve QA string karşılaştırır. Estetik ikincildir; kararlılık birincildir.

Katmanları karıştırma

Dosya hash'i, kök kimliği ve mesh adı aynı cümlede eritilmez. Her katmanın kendi muhatabı vardır.

Yerel karakter = gizli borç

DCC'de «doğru görünen» Unicode, CI ve CDN'de kırılır. Kimlik ASCII'dir.

Teşhis maddeleri

1. Adlandırma profili ticket'ta mı?
2. Beş katmandan hangileri bu asset'te var ve yazılı mı?
3. Token dilbilgisi (asset/role/variant/lod) tutuluyor mu?
4. Karakter seti web-safe mi (boşluk / Türkçe / parantez yok)?
5. Kodun aradığı isimler benzersiz mi?
6. LOD/variant semantik; final/vN yok mu?
7. Yayın hash'i DCC köküne bulaşmamış mı?
8. Clip listesi wiki ile aynı mı?
9. Texture önekleri asset token'ı ile hizalı mı?
10. DCC'siz viewer'da isim scrub yapıldı mı?

CAD dünyası parça numarası, montaj ve NURBS mirası taşır; web DCC'si ise bu sözleşmeye oturan mesh kimliği ister. Sonraki sayfa CAD → DCC → web el değiştirme mühendislik kimliğini vitrin kimliğine nasıl çevirdiğinizi anlatır.