medieval-kit/my-registry/models/hay-bale/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

181 lines
7 KiB
TypeScript

/**
* @medieval-kit/hay-bale
*
* Bağlanmış saman demeti.
*
* Bir uyarı yerinde: bugün "balya" denince akla gelen dikdörtgen prizma
* makinenin işidir ve 19. yüzyıla aittir. Ortaçağda saman ya gevşek yığılır ya
* da elle bağlanıp demet yapılırdı. Bu model ikincisi.
*
* İKİNCİ deneme. İlki dilim dilim kutulardan kuruluydu ve render'a bakınca
* kararı verdiren şey netti: SOLGUN BİR TAHTA SANDIK gibi duruyordu. İki ayrı
* hata vardı ve ikisi de biçimle ilgiliydi, renkle değil:
*
* - Kesit dikdörtgendi. Keskin köşe + düz yüz = marangoz işi. Bağlanmış bir
* demetin kesiti yuvarlaktır, çünkü ipi çeken şey onu yuvarlatır.
* - Yüzeyler kusursuz düzdü. Saman hiçbir yerde düz değildir.
*
* Bu yüzden gövde artık bir dönel gövde — ipin sıktığı yerde daralan, sonra
* `roughenGeometry` ile bozulan bir silindir. O iki değişiklik renk hiç
* değişmeden modeli tanınır hâle getirdi.
*/
import type { BufferGeometry } from 'three'
import {
bandGeometry,
boxGeometry,
createKitModel,
createTinter,
jitter,
latheGeometry,
mergeColoured,
roughenGeometry,
type Level,
} from '../core/index.ts'
export interface HayBaleConfig {
/** Uzunluk (metre). */
readonly length: number
/** Yükseklik (metre). */
readonly height: number
/** Derinlik (metre). */
readonly depth: number
/** Kaç ip bağı. */
readonly ropeCount: number
/** Yüzeyden fırlayan gevşek sap sayısı. */
readonly wisps: number
/** Yüzey düzensizliği. 0 = pürüzsüz gövde. */
readonly rough: number
readonly seed: number
}
export const hayBaleDefaults: HayBaleConfig = {
length: 0.88,
height: 0.42,
depth: 0.46,
ropeCount: 2,
wisps: 34,
rough: 1,
seed: 47,
}
export type HayBaleParts = 'bale' | 'wisps' | 'ropes'
export function createModel(overrides: Partial<HayBaleConfig> = {}) {
return createKitModel<HayBaleConfig, 'straw' | 'cloth', HayBaleParts>({
id: 'hay-bale',
defaults: hayBaleDefaults,
slots: ['straw', 'cloth'],
build: ({ config, random }) => {
const tint = createTinter(random)
const ropes = Math.max(0, Math.round(config.ropeCount))
const halfLength = config.length / 2
// Gövde önce YARIÇAP 1 olan bir dönel gövde olarak kuruluyor, sonra
// gerçek en/boy oranına ezileceği için. Böylece ipin daralttığı miktar
// tek bir sayı — iki eksende ayrı ayrı hesaplamak gerekmiyor.
const ropeXs = Array.from({ length: ropes }, (_, i) =>
ropes === 1 ? 0 : (i / (ropes - 1) - 0.5) * config.length * 0.54)
const cinch = (x: number): number => {
let tightest = 1
for (const rx of ropeXs) {
const distance = Math.abs(x - rx) / (config.length * 0.19)
if (distance < 1) tightest = Math.min(tightest, 1 - 0.13 * (1 - distance * distance))
}
return tightest
}
// --- Gövde ---------------------------------------------------------
const rings = 11
const levels: Level[] = Array.from({ length: rings }, (_, i) => {
const t = i / (rings - 1)
const x = -halfLength + config.length * t
// Uçlar yuvarlanıyor: ilk ve son halka belirgin şekilde dar, yoksa
// demet iki ucundan kesilmiş bir boru gibi duruyor.
const endFade = 1 - Math.pow(Math.abs(t - 0.5) * 2, 6) * 0.34
return { y: x, radius: 0.5 * cinch(x) * endFade * (1 + jitter(random, 0.05)) }
})
const body = latheGeometry(levels, 7, [0, 0, 0], tint('straw', -0.06, 1.6), {
colourTop: tint('strawPale', 0.02, 1.6),
})
// Dikey kurulup yatırılıyor: dönel gövde yardımcısı Y ekseni etrafında
// çalışıyor, demet ise X boyunca uzanıyor.
body.rotateZ(Math.PI / 2)
body.scale(1, config.height, config.depth)
roughenGeometry(body, config.height * 0.045 * config.rough, { salt: 11 })
// --- Fırlayan saplar ------------------------------------------------
// Yüzeydeki gevşek saplar ve iki uçtan püsküren damar uçları. İkincisi
// önemli: bağlanmış bir demette sapların KESİLMİŞ uçları hep iki uçtadır
// ve demeti "kesilmiş bitki" olarak okutan tek işaret odur.
const wispPieces: BufferGeometry[] = []
const wispCount = Math.max(0, Math.round(config.wisps))
const thickness = config.height * 0.016
for (let i = 0; i < wispCount; i += 1) {
const fromEnd = i % 3 === 0
const length = config.height * (fromEnd ? 0.2 + random() * 0.24 : 0.13 + random() * 0.17)
const wisp = boxGeometry(
[length, thickness * (0.6 + random() * 0.9), thickness],
[length * 0.3, 0, 0], // kökü orijinin gerisinde: gövdeye gömülü
tint('strawPale', 0.05, 1.4),
)
if (fromEnd) {
// Uç sapları: X ekseni boyunca dışarı, hafif saçılarak.
const side = i % 6 === 0 ? 1 : -1
const angle = random() * Math.PI * 2
const radius = 0.5 * (0.15 + random() * 0.8)
wisp.rotateZ(jitter(random, 0.4))
wisp.rotateX(jitter(random, 0.4))
if (side < 0) wisp.rotateY(Math.PI)
wisp.translate(
side * halfLength * (0.86 + random() * 0.1),
Math.sin(angle) * radius * config.height,
Math.cos(angle) * radius * config.depth,
)
} else {
// Yüzey sapları: gövdenin yan yüzeyinden dışarı.
const x = (random() - 0.5) * config.length * 0.88
const angle = random() * Math.PI * 2
const shrink = cinch(x)
wisp.rotateZ(jitter(random, 0.9))
wisp.rotateY(angle + Math.PI / 2)
wisp.translate(
x,
Math.sin(angle) * 0.47 * config.height * shrink,
Math.cos(angle) * 0.47 * config.depth * shrink,
)
}
wispPieces.push(wisp)
}
// --- İpler ----------------------------------------------------------
// Gövde yuvarlak olduğu için ip artık dört çubuktan değil gerçek bir
// HALKADAN kuruluyor. Aynı ezme dönüşümünden geçiyor, dolayısıyla
// demetin kesitine tam oturuyor.
const ropePieces: BufferGeometry[] = []
const cord = config.height * 0.03
for (const x of ropeXs) {
// Serbest duran halka: iç yüzü de gerekli, yoksa kapalı katı olmuyor.
const ring = bandGeometry(0.5 * cinch(x) + cord * 0.35, 0, cord * 1.5, cord, 7,
tint('cloth', -0.07), { inner: true })
ring.rotateZ(Math.PI / 2)
ring.scale(1, config.height, config.depth)
ring.translate(x, 0, 0)
ropePieces.push(ring)
}
return {
bale: { slot: 'straw' as const, geometry: mergeColoured([body]) },
wisps: wispPieces.length > 0
? { slot: 'straw' as const, geometry: mergeColoured(wispPieces) }
: undefined,
ropes: ropePieces.length > 0
? { slot: 'cloth' as const, geometry: mergeColoured(ropePieces) }
: undefined,
}
},
}, overrides)
}