medieval-kit/my-registry/models/tavern-sign/model.ts
CRT a3300ff233 Kit'i 26 modele çıkar, doğrulamayı ve inceleyiciyi genişlet
Modeller (13 → 26): chest, bench, torch, lantern, bell, sign, hay bale,
sack, broom, tankard, book, phial, coin pouch. Kürek, çapa ve yaba
render'lara bakılarak yeniden yazıldı.

core:
- createKitModel artık tipli `actions` ve `update(dt)` taşıyor
- BuiltPart.extras: bir parça birden çok materyal yuvası kullanabiliyor
  (sandığın kapağı = meşe tahta + demir kayış, birlikte dönmek zorunda)
- BuiltPart.origin: parça başına dönme merkezi (menteşe, sarkaç)
- bendGeometry / roughenGeometry / mottleGeometry
- 5 yeni materyal yuvası: steel, brass, straw, cloth, leather, glass
- bandGeometry({ inner }) — serbest halkalar kapalı katı olabilsin

my-registry/meta.ts: katalog metadata'sı artık build.ts ve viewer için
tek kaynak. Doğrulama modelle metadata'nın uyuştuğunu denetliyor ve bu
eklendiği gün dört modelde gerçek bir sapma yakaladı.

Doğrulama (~500 kontrol):
- metadata uyumu, eylem semantiği, kare hızı bağımsızlığı
- scripts/render.ts: tarayıcısız yazılım rasterleyici. Bütün doğrulama
  geometrikti; "bu kürek küreğe benzemiyor" diyebilmek için modele
  bakmak gerekiyordu
- scripts/verify-glb.ts: dışa aktar → geri oku → karşılaştır

GLB dışa aktarımı: viewer düğmesi ve toplu CLI aynı kodu kullanıyor.

Viewer:
- parça paneli (solo/izole) ve materyal yuvası paneli (canlı renk override)
- kit görünümü: 26 model tek sahnede, ölçek ve ton tutarlılığı için
- configure() sonrası gölge bayraklarının düşmesi düzeltildi
2026-08-21 09:44:58 +07:00

215 lines
7.8 KiB
TypeScript

/**
* @medieval-kit/tavern-sign
*
* Duvara tutturulmuş dövme demir kolun ucunda sallanan tahta tabela.
*
* Okuma yazma nadir olduğu için dönemin tabelası YAZI değil RESİM taşırdı:
* çelenk şarapçıyı, çizme kunduracıyı, havan eczacıyı gösterirdi. Bu yüzden
* model panonun kendisini veriyor, üstündeki işareti değil — tüketici
* `parts.board.anchor`'a ne isterse takar. Protokolün semantik parça fikri
* tam olarak bu işe yarıyor.
*
* Sallanma çanınkinden farklı bir sarkaç: burada geri çağırma kuvveti yerçekimi
* değil, iki halkanın sürtünmesi. Yani duran bir tabela hep DÜZ durur ama
* itildiğinde uzun süre salınır. Çanın sert, hızlı sönümlemesinin yanına
* konduğunda ikisinin farkı hemen okunuyor.
*/
import type { BufferGeometry } from 'three'
import {
bandGeometry,
bendGeometry,
boxGeometry,
chamferedBoxGeometry,
createKitModel,
createTinter,
jitter,
mergeColoured,
} from '../core/index.ts'
export interface TavernSignConfig {
/** Pano genişliği (metre). */
readonly width: number
/** Pano yüksekliği (metre). */
readonly height: number
/** Kolun duvardan çıkıntısı (metre). */
readonly reach: number
/** Askı zincirinin boyu (metre). */
readonly drop: number
/** Tahta sayısı. */
readonly plankCount: number
/** Sallanmanın sönümlenme hızı. */
readonly damping: number
readonly seed: number
}
export const tavernSignDefaults: TavernSignConfig = {
width: 0.54,
height: 0.38,
reach: 0.62,
drop: 0.12,
plankCount: 3,
damping: 0.42,
seed: 73,
}
// Zincirler ayrı bir parça DEĞİL: panoyla birlikte sallanmak zorundalar,
// dolayısıyla onun `extras` gövdesi olarak yaşıyorlar.
export type TavernSignParts = 'bracket' | 'board'
export interface TavernSignActions {
/** Tabelayı iter: rüzgâr ya da kapıdan çıkan biri. */
push(strength?: number): void
still(): void
/** Anlık salınım açısı (radyan). */
lean(): number
}
export function createModel(overrides: Partial<TavernSignConfig> = {}) {
let angle = 0
let velocity = 0
return createKitModel<TavernSignConfig, 'oak' | 'iron', TavernSignParts, TavernSignActions>({
id: 'tavern-sign',
defaults: tavernSignDefaults,
slots: ['oak', 'iron'],
build: ({ config, random }) => {
const tint = createTinter(random)
const bar = config.reach * 0.035
// Dönme ekseni: zincirlerin koldan çıktığı hat. Pano ve zincirler bu
// noktaya GÖRE yazılıyor.
const pivotY = config.height * 0.5 + config.drop
const armY = pivotY
const hangX = config.width * 0.4
// --- Kol ---------------------------------------------------------------
// Duvara sıfır Z'de oturuyor, +Z yönüne uzanıyor.
const iron: BufferGeometry[] = []
iron.push(boxGeometry(
[bar * 4.4, config.height * 0.9, bar * 1.6],
[0, armY - config.height * 0.1, bar * 0.4],
tint('iron', -0.05, 0.7),
))
// Yatay kol.
iron.push(boxGeometry(
[bar * 1.5, bar * 1.7, config.reach],
[0, armY + bar * 0.5, config.reach / 2],
tint('iron', 0.02, 0.7),
))
// Payanda: kolu duvara bağlayan eğri destek. Onsuz kol havada duruyor
// gibi görünüyor ve gözün "bu nasıl taşınıyor" sorusu cevapsız kalıyor.
const braceLength = config.reach * 0.72
const brace = boxGeometry(
[bar * 1.1, braceLength, bar * 1.1],
[0, braceLength / 2, 0],
tint('iron', -0.02, 0.7),
)
bendGeometry(brace, -1.15 / braceLength)
brace.rotateX(Math.PI / 4)
brace.translate(0, armY - config.height * 0.42, bar)
iron.push(brace)
// Kolun ucundaki kıvrım: dövme demirin imzası.
const curl = boxGeometry(
[bar * 0.9, config.reach * 0.3, bar * 0.9],
[0, config.reach * 0.15, 0],
tint('iron', 0.06, 0.7),
)
bendGeometry(curl, 5.2 / (config.reach * 0.3))
curl.rotateX(Math.PI / 2)
curl.translate(0, armY + bar * 0.5, config.reach)
iron.push(curl)
// --- Zincirler ------------------------------------------------------------
// Panoyla BİRLİKTE sallanmak zorundalar, o yüzden panonun `extras`
// gövdesi. Ayrı parça olsalardı pano sallanırken zincir dimdik kalırdı.
const links: BufferGeometry[] = []
for (const side of [-1, 1]) {
const count = 3
for (let i = 0; i < count; i += 1) {
const y = -config.drop * ((i + 0.5) / count)
const ring = bandGeometry(config.drop * 0.16, 0, bar * 0.6, bar * 0.35, 6,
tint('iron', jitter(random, 0.05), 0.7), { inner: true })
// Ardışık halkalar dik açıyla geçmeli — zincir budur.
ring.rotateX(i % 2 === 0 ? Math.PI / 2 : 0)
ring.rotateZ(i % 2 === 0 ? 0 : Math.PI / 2)
ring.translate(side * hangX, y, config.reach * 0.86 * (side === 0 ? 1 : 1))
links.push(ring)
}
}
// --- Pano ------------------------------------------------------------------
const planks = Math.max(1, Math.round(config.plankCount))
const plankHeight = config.height / planks
const board: BufferGeometry[] = []
for (let i = 0; i < planks; i += 1) {
const y = -config.drop - config.height + plankHeight * (i + 0.5)
board.push(chamferedBoxGeometry(
[config.width, config.height * 0.055],
[config.width * 0.997, config.height * 0.05],
plankHeight * 0.94,
config.height * 0.012,
[0, y, config.reach * 0.86],
tint('oak', jitter(random, 0.05)),
))
}
// Arkadaki iki çıta: tahtaları birbirine bağlayan şey. Tahtaların İÇİNE
// giriyorlar ki hiçbir yüz aynı düzleme oturmasın.
for (const side of [-1, 1]) {
board.push(boxGeometry(
[config.width * 0.07, config.height * 0.94, config.height * 0.045],
[side * config.width * 0.36, -config.drop - config.height / 2, config.reach * 0.86 - config.height * 0.045],
tint('oak', -0.09),
))
}
// Panoyu zincire bağlayan iki demir kulak.
for (const side of [-1, 1]) {
links.push(boxGeometry(
[bar * 1.2, config.drop * 0.4, bar * 1.4],
[side * hangX, -config.drop - config.drop * 0.06, config.reach * 0.86],
tint('iron', 0.04, 0.7),
))
}
return {
bracket: { slot: 'iron' as const, geometry: mergeColoured(iron) },
board: {
slot: 'oak' as const,
geometry: mergeColoured(board),
origin: [0, pivotY, 0] as const,
extras: [{ slot: 'iron' as const, geometry: mergeColoured(links) }],
},
}
},
actions: ({ parts }) => {
parts.board.anchor.rotation.x = angle
return {
push: (strength = 1) => {
// Mevcut hareketi güçlendiriyor, sıfırlamıyor: art arda gelen
// itmeler gerçek bir rüzgâr gibi birikmeli.
velocity += (velocity >= 0 ? 1 : -1) * 1.6 * strength
},
still: () => { angle = 0; velocity = 0; parts.board.anchor.rotation.x = 0 },
lean: () => angle,
}
},
update: (dt, { parts, getConfig }) => {
const step = Math.min(0.05, Math.max(0, dt))
if (step === 0) return
if (Math.abs(angle) < 1e-5 && Math.abs(velocity) < 1e-5) return
// Çandan daha YUMUŞAK bir sarkaç: geri çağırma zayıf, sönümleme az.
// Ağır bir panonun uzun ve tembel salınımı böyle görünüyor.
velocity += -angle * 11 * step - velocity * getConfig().damping * step
angle += velocity * step
// Sınır: pano kola çarpmadan önce durmalı.
const limit = 0.55
if (Math.abs(angle) > limit) {
angle = Math.sign(angle) * limit
velocity *= -0.4
}
parts.board.anchor.rotation.x = angle
},
}, overrides)
}