medieval-kit/my-registry/models/wooden-stool/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

99 lines
3.1 KiB
TypeScript

/**
* @medieval-kit/wooden-stool
*
* Üç ayaklı tabure. Üç ayak tesadüf değil: düzgün olmayan zeminde üç ayak her
* zaman basar, dördüncüsü sallanır — köy mobilyası bu yüzden üç ayaklıdır.
*
* Sahnede işlevi: "burada biri oturuyor" demek. Tek başına bir prop değil,
* insan varlığının işareti.
*/
import { Color } from 'three'
import {
chamferedBoxGeometry,
createKitModel,
jitter,
MEDIEVAL_PALETTE,
mergeColoured,
prismGeometry,
} from '../core/index.ts'
export interface WoodenStoolConfig {
readonly height: number
/** Oturak yarıçapı (metre). */
readonly seatRadius: number
readonly legCount: number
/** Ayakların dışa açıklığı. 0 = dik. */
readonly splay: number
readonly seed: number
}
export const woodenStoolDefaults: WoodenStoolConfig = {
height: 0.46,
seatRadius: 0.17,
legCount: 3,
splay: 0.22,
seed: 17,
}
export type WoodenStoolParts = 'seat' | 'legs'
export function createModel(overrides: Partial<WoodenStoolConfig> = {}) {
return createKitModel<WoodenStoolConfig, 'oak', WoodenStoolParts>({
id: 'wooden-stool',
defaults: woodenStoolDefaults,
slots: ['oak'],
build: ({ config, random }) => {
const tint = new Color()
const half = config.height / 2
const seatThickness = config.seatRadius * 0.22
// Oturak: kalın bir ahşap disk — yani kısa bir silindir. Kenarı aşağı
// doğru hafif daralıyor, bu da kütükten yontulmuş izlenimi veriyor.
tint.copy(MEDIEVAL_PALETTE.oakEnd)
tint.offsetHSL(jitter(random, 0.01), jitter(random, 0.04), jitter(random, 0.04))
const seatTop = half
const seat = prismGeometry(
config.seatRadius * 0.94,
config.seatRadius,
seatThickness,
12,
[0, seatTop - seatThickness / 2, 0],
tint,
)
const legs = []
const count = Math.max(3, config.legCount)
const legLength = config.height - seatThickness
for (let i = 0; i < count; i += 1) {
const angle = (i / count) * Math.PI * 2 + jitter(random, 0.06)
tint.copy(MEDIEVAL_PALETTE.oak)
tint.offsetHSL(jitter(random, 0.012), jitter(random, 0.05), jitter(random, 0.06))
const thick = config.seatRadius * 0.2
// Ayak: origin'in altına sarkan, aşağı doğru incelen bir çubuk.
// Sıra kritik: önce eğ, sonra YARIÇAPA TAŞI, sonra döndür. Yarıçapa
// taşıma adımı olmadan splay=0 iken üç ayak da eksende üst üste biner.
const leg = chamferedBoxGeometry(
[thick * 0.72, thick * 0.72],
[thick, thick],
legLength,
thick * 0.16,
[0, -legLength / 2, 0],
tint,
)
leg.rotateZ(config.splay)
leg.translate(config.seatRadius * 0.6, 0, 0)
leg.rotateY(angle)
// Oturak diskinin İÇİNE gir: üst uç görünmez ve hiçbir düzlemle hizalanmaz.
leg.translate(0, seatTop - seatThickness * 0.35, 0)
legs.push(leg)
}
return {
seat: { slot: 'oak', geometry: seat },
legs: { slot: 'oak', geometry: mergeColoured(legs) },
}
},
}, overrides)
}