medieval-kit/my-registry/models/straw-broom/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

184 lines
7.6 KiB
TypeScript

/**
* @medieval-kit/straw-broom
*
* Süpürge: bir sopa, bir demet süpürge otu, iki tur ip. Dönemin süpürgesi
* gerçekten bu kadar basitti ve tam da bu yüzden her iç mekân sahnesinde
* bulunuyordu.
*
* Modelin bütün işi ALT UÇTA. Sap zaten kitin bildiği bir şey; asıl mesele
* demeti demet gibi göstermek. Üç kural çıktı:
*
* - Teller AYNI noktadan çıkmalı, aşağıda yelpaze gibi açılmalı. Paralel
* teller fırça olur, süpürge olmaz.
* - Uçları AYNI hizada bitmemeli. Eşit boy her zaman fabrikasyon okunuyor.
* - Bağ demeti gerçekten SIKMALI, yani tellerin bağ hizasındaki dağılımı
* bağın yarıçapıyla sınırlı olmalı. Üstüne çizilmiş bir ip işe yaramıyor.
*/
import type { BufferGeometry } from 'three'
import {
bandGeometry,
createKitModel,
createTinter,
jitter,
latheGeometry,
mergeColoured,
taperedBoxGeometry,
type Level,
} from '../core/index.ts'
export interface StrawBroomConfig {
/** Toplam boy (metre). */
readonly length: number
/** Sap yarıçapı (metre). */
readonly shaftRadius: number
/** Demetin boyu, toplam boyun oranı olarak. */
readonly headLength: number
/** Demetin alt uçta açılma miktarı. */
readonly flare: number
/** Tel sayısı. */
readonly bristles: number
/** Kaç tur bağ. */
readonly bindings: number
readonly seed: number
}
export const strawBroomDefaults: StrawBroomConfig = {
length: 1.24,
shaftRadius: 0.017,
headLength: 0.4,
flare: 0.34,
bristles: 52,
bindings: 2,
seed: 59,
}
export type StrawBroomParts = 'shaft' | 'bristles' | 'bindings'
export function createModel(overrides: Partial<StrawBroomConfig> = {}) {
return createKitModel<StrawBroomConfig, 'oak' | 'straw' | 'cloth', StrawBroomParts>({
id: 'straw-broom',
defaults: strawBroomDefaults,
slots: ['oak', 'straw', 'cloth'],
build: ({ config, random }) => {
const tint = createTinter(random)
const half = config.length / 2
const headLength = config.length * config.headLength
// Demetin tepesi: teller buradan çıkıp aşağı iniyor.
const headTop = -half + headLength
// --- Sap -------------------------------------------------------------
// Demetin İÇİNE giriyor: gerçek süpürgede sopa demetin ortasına saplanır
// ve ucu tellerin arasında kaybolur.
const shaftProfile: Level[] = [
{ y: -half + headLength * 0.35, radius: config.shaftRadius * 0.86 },
{ y: headTop, radius: config.shaftRadius },
{ y: half - config.length * 0.06, radius: config.shaftRadius * 1.02 },
{ y: half, radius: config.shaftRadius * 0.78 },
]
const shaft = mergeColoured([latheGeometry(shaftProfile, 6, [0, 0, 0],
tint('oak', -0.04), { colourTop: tint('oak', 0.04) })])
// --- Teller -----------------------------------------------------------
const count = Math.max(3, Math.round(config.bristles))
const bristles: BufferGeometry[] = []
const gather = config.shaftRadius * 2.6 // bağ hizasındaki yarıçap
// Demet İKİ ÖLÇEKTE kuruluyor ve bunun bir sebebi var: tek tek tel
// dizmek işe yaramadı. Elli iki ayrı çubuk bile bir koni yüzeyine
// dağılınca aralarındaki boşluk kapanmıyor, sonuç süpürge değil ÇIRPICI
// oluyordu. Yüzlerce tel dizmek ise lowpoly bütçesini yiyor.
//
// Çözüm gerçek süpürgenin kendi yapısı: süpürge otu tek tek değil KÜÇÜK
// DEMETLER hâlinde bağlanır. Yassı bir levha bir demeti temsil ediyor,
// ince çubuklar da o demetlerden fırlayan tek telleri. Kütle levhalardan,
// dağınıklık çubuklardan geliyor.
const sheaves = Math.max(5, Math.round(count * 0.28))
const stalks = Math.max(0, count - sheaves)
for (let i = 0; i < sheaves; i += 1) {
const angle = (i / sheaves) * Math.PI * 2 + jitter(random, 0.12)
const length = headLength * (0.9 + random() * 0.2)
const width = config.shaftRadius * (1.5 + random() * 0.5)
const depth = config.shaftRadius * (0.4 + random() * 0.2)
// Levha aşağı doğru YAYILIYOR: üstte dar (bağın içinde), altta geniş.
const sheaf = taperedBoxGeometry(
[width * 1.5, depth * 0.85],
[width * 0.45, depth],
length,
[0, -length / 2, 0], // üst ucu ORİJİNDE: demet oradan asılıyor
// Renk sırası TERS gibi görünüyor ama doğru olan bu: aşağıdaki uç
// sapın KESİLDİĞİ yer, yani en açık nokta. Koyu uçlu ilk hâlde
// süpürge zifte batırılmış gibi duruyordu.
tint('strawPale', 0.07, 1.5),
tint('straw', -0.08, 1.5),
)
// Açılma: dönüş orijin etrafında olduğu için üst uç yerinde kalıyor.
// Demetin tepeden toplanıp aşağı yayılmasının tamamı bu tek dönüşten.
// Küçük bir yan eğiklik: `flare` sıfırken bütün levhalar birbirine
// TAM PARALEL kalıyor ve komşu yüzleri aynı düzleme oturup titriyordu.
// Doğal olan da bu — elle bağlanmış bir demette hiçbir tel diğerine
// paralel değildir.
sheaf.rotateZ(jitter(random, 0.09))
sheaf.rotateX(config.flare * (0.85 + random() * 0.3) + jitter(random, 0.035))
sheaf.rotateY(angle)
sheaf.translate(
Math.sin(angle) * gather * 0.4,
headTop + jitter(random, headLength * 0.02),
Math.cos(angle) * gather * 0.4,
)
bristles.push(sheaf)
}
for (let i = 0; i < stalks; i += 1) {
// Altın oran açısı: ardışık teller birbirinin üstüne düşmüyor ve
// hiçbir yerde sıra oluşmuyor. Eşit aralık verseydim demet dilimli
// bir yelpaze gibi görünürdü.
const angle = i * 2.399963
const ring = 0.5 + Math.sqrt((i + 0.5) / stalks) * 0.5
const length = headLength * (0.82 + random() * 0.3)
const thickness = config.shaftRadius * (0.16 + random() * 0.14)
const bristle = taperedBoxGeometry(
[thickness * 1.3, thickness * 1.3],
[thickness * 0.7, thickness * 0.7],
length,
[0, -length / 2, 0],
tint('strawPale', 0.1, 1.5),
tint('straw', -0.02, 1.5),
)
bristle.rotateX(config.flare * ring * (0.8 + random() * 0.6))
bristle.rotateY(angle)
bristle.translate(
Math.sin(angle) * gather * ring * 0.5,
headTop + jitter(random, headLength * 0.03),
Math.cos(angle) * gather * ring * 0.5,
)
bristles.push(bristle)
}
// --- Bağlar ------------------------------------------------------------
const bindings: BufferGeometry[] = []
const turns = Math.max(0, Math.round(config.bindings))
for (let i = 0; i < turns; i += 1) {
const t = turns === 1 ? 0.18 : (i / (turns - 1)) * 0.3
const y = headTop - headLength * (0.05 + t)
// Bağın yarıçapı tellerin O YÜKSEKLİKTEKİ dağılımına oturuyor:
// yukarıda dar, aşağıda geniş.
const drop = (headTop - y) / headLength
const radius = gather * 0.6 + Math.tan(config.flare) * headLength * drop * 0.8
bindings.push(bandGeometry(radius, y, config.shaftRadius * 0.55,
config.shaftRadius * 0.22, 8, tint('cloth', -0.16, 0.9)))
}
return {
shaft: { slot: 'oak' as const, geometry: shaft },
bristles: { slot: 'straw' as const, geometry: mergeColoured(bristles) },
bindings: bindings.length > 0
? { slot: 'cloth' as const, geometry: mergeColoured(bindings) }
: undefined,
}
},
}, overrides)
}