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
162 lines
6.4 KiB
TypeScript
162 lines
6.4 KiB
TypeScript
/**
|
|
* @medieval-kit/cart-wheel
|
|
*
|
|
* Fıçıdan sonra en ikonik ortaçağ nesnesi. Tek başına da kullanılır — duvara
|
|
* yaslanmış bir tekerlek bir sahneyi anında köy yapar.
|
|
*
|
|
* Gerçek yapımı dıştan içe dört katman: demir bandaj, ahşap ispit (felloe),
|
|
* parmaklar, göbek. İspit tek parça değil, düz parçalardan kurulur — yani
|
|
* lowpoly çokgen jant burada bir basitleştirme değil, doğru inşa.
|
|
*
|
|
* Tekerlek XY düzleminde duruyor; ekseni Z. Yatırmak isteyen `root.rotation.x`
|
|
* ile çevirir.
|
|
*/
|
|
import { Color, type BufferGeometry } from 'three'
|
|
|
|
import {
|
|
MEDIEVAL_PALETTE,
|
|
chamferedBoxGeometry,
|
|
createKitModel,
|
|
jitter,
|
|
latheGeometry,
|
|
mergeColoured,
|
|
type Level,
|
|
} from '../core/index.ts'
|
|
|
|
export interface CartWheelConfig {
|
|
/** Dış yarıçap, demir bandaj dâhil (metre). */
|
|
readonly radius: number
|
|
/** Parmak sayısı. İspit parça sayısı da buna bağlı. */
|
|
readonly spokeCount: number
|
|
/** Tekerlek kalınlığı (metre). */
|
|
readonly width: number
|
|
/** Göbeğin uzunluğu, kalınlığın katı olarak. */
|
|
readonly hubLength: number
|
|
/** Demir bandaj kalınlığı, yarıçapın oranı olarak. */
|
|
readonly tyre: number
|
|
readonly seed: number
|
|
}
|
|
|
|
export const cartWheelDefaults: CartWheelConfig = {
|
|
radius: 0.52,
|
|
spokeCount: 10,
|
|
width: 0.09,
|
|
hubLength: 2.1,
|
|
tyre: 0.045,
|
|
seed: 27,
|
|
}
|
|
|
|
export type CartWheelParts = 'hub' | 'spokes' | 'felloe' | 'tyre'
|
|
|
|
export function createModel(overrides: Partial<CartWheelConfig> = {}) {
|
|
return createKitModel<CartWheelConfig, 'oak' | 'iron', CartWheelParts>({
|
|
id: 'cart-wheel',
|
|
defaults: cartWheelDefaults,
|
|
slots: ['oak', 'iron'],
|
|
build: ({ config, random }) => {
|
|
const tint = new Color()
|
|
const oak = (lift = 0): Color => {
|
|
tint.copy(MEDIEVAL_PALETTE.oak)
|
|
tint.offsetHSL(jitter(random, 0.012), jitter(random, 0.05), lift + jitter(random, 0.05))
|
|
return tint
|
|
}
|
|
const iron = (lift = 0): Color => {
|
|
tint.copy(MEDIEVAL_PALETTE.iron)
|
|
tint.offsetHSL(0, jitter(random, 0.02), lift + jitter(random, 0.05))
|
|
return tint
|
|
}
|
|
|
|
const spokes = Math.max(4, config.spokeCount)
|
|
const tyreThickness = config.radius * config.tyre
|
|
const felloeOuter = config.radius - tyreThickness
|
|
const felloeInner = felloeOuter * 0.82
|
|
const hubRadius = config.radius * 0.17
|
|
const hubLength = config.width * config.hubLength
|
|
|
|
// --- göbek: iki ucu pahlı, ortası şişkin tornalanmış kütük ---
|
|
const hubProfile: Level[] = [
|
|
{ y: -hubLength / 2, radius: hubRadius * 0.68 },
|
|
{ y: -hubLength / 2 + hubLength * 0.1, radius: hubRadius * 0.92 },
|
|
{ y: -hubLength * 0.16, radius: hubRadius },
|
|
{ y: hubLength * 0.16, radius: hubRadius },
|
|
{ y: hubLength / 2 - hubLength * 0.1, radius: hubRadius * 0.92 },
|
|
{ y: hubLength / 2, radius: hubRadius * 0.68 },
|
|
]
|
|
const hub = latheGeometry(hubProfile, 8, [0, 0, 0], oak(-0.05), { colourTop: oak(-0.03) })
|
|
// Göbeğin ekseni Z olmalı: tekerlek dik duruyor.
|
|
hub.rotateX(Math.PI / 2)
|
|
|
|
// --- parmaklar: göbekten ispite, dışa doğru incelen ---
|
|
const spokePieces: BufferGeometry[] = []
|
|
const spokeLength = felloeInner - hubRadius * 0.6
|
|
for (let i = 0; i < spokes; i += 1) {
|
|
const angle = (i / spokes) * Math.PI * 2
|
|
const spoke = chamferedBoxGeometry(
|
|
[config.width * 0.42, config.width * 0.5],
|
|
[config.width * 0.3, config.width * 0.38],
|
|
spokeLength,
|
|
config.width * 0.07,
|
|
[0, spokeLength / 2 + hubRadius * 0.6, 0],
|
|
oak(),
|
|
)
|
|
// Elle yontulmuş parmak tam ortalanmaz; küçük bir sapma veriyoruz.
|
|
spoke.rotateZ(angle + jitter(random, 0.012))
|
|
spokePieces.push(spoke)
|
|
}
|
|
|
|
// --- ispit: düz ahşap parçalardan kurulu çokgen jant ---
|
|
const felloePieces: BufferGeometry[] = []
|
|
const segments = spokes
|
|
const step = (Math.PI * 2) / segments
|
|
// Kiriş uzunluğu: komşu iki köşe arasındaki mesafe. Parçalar birbirine
|
|
// GİRSİN diye biraz fazla uzun, uç uca değil.
|
|
const chord = 2 * felloeOuter * Math.sin(step / 2) * 1.03
|
|
const midRadius = (felloeOuter + felloeInner) / 2
|
|
for (let i = 0; i < segments; i += 1) {
|
|
const angle = (i + 0.5) * step
|
|
// Her parça kendi kalınlığında. Bu hem doğru (elle kesilmiş ispit
|
|
// parçaları eşit olmaz) hem de zorunlu: hepsi tam aynı kalınlıkta
|
|
// olsaydı yan yüzleri aynı düzlemde olur ve bindirdikleri yerde
|
|
// z-fighting yaparlardı.
|
|
const thickness = config.width * (1 + jitter(random, 0.07))
|
|
const piece = chamferedBoxGeometry(
|
|
[chord, thickness],
|
|
[chord, thickness],
|
|
felloeOuter - felloeInner,
|
|
config.width * 0.09,
|
|
[0, 0, 0],
|
|
oak(0.03),
|
|
)
|
|
// Parça origin'de kuruluyor: X = teğet (kiriş boyu), Y = radyal
|
|
// kalınlık, Z = tekerlek kalınlığı. Yani angle=0 için zaten doğru
|
|
// yönde. Yarıçapa taşıyıp tek bir dönüşle yerine götürmek yeterli —
|
|
// araya fazladan çevirme koymak parçaların bir kısmını birbirine
|
|
// paralel hâle getiriyor ve uç yüzleri çakışıyordu.
|
|
piece.translate(0, midRadius, 0)
|
|
piece.rotateZ(angle)
|
|
felloePieces.push(piece)
|
|
}
|
|
|
|
// --- demir bandaj: ispiti çevreleyen tek parça çember ---
|
|
const tyre = latheGeometry([
|
|
{ y: -config.width / 2, radius: config.radius },
|
|
{ y: -config.width / 2 + tyreThickness * 0.3, radius: config.radius + tyreThickness * 0.06 },
|
|
{ y: config.width / 2 - tyreThickness * 0.3, radius: config.radius + tyreThickness * 0.06 },
|
|
{ y: config.width / 2, radius: config.radius },
|
|
], segments, [0, 0, 0], iron(), { capTop: false, capBottom: false })
|
|
const tyreInner = latheGeometry([
|
|
{ y: -config.width / 2, radius: felloeOuter * 0.995 },
|
|
{ y: config.width / 2, radius: felloeOuter * 0.995 },
|
|
], segments, [0, 0, 0], iron(-0.04), { capTop: false, capBottom: false })
|
|
const tyreRings = mergeColoured([tyre, tyreInner])
|
|
tyreRings.rotateX(Math.PI / 2)
|
|
|
|
return {
|
|
hub: { slot: 'oak', geometry: hub },
|
|
spokes: { slot: 'oak', geometry: mergeColoured(spokePieces) },
|
|
felloe: { slot: 'oak', geometry: mergeColoured(felloePieces) },
|
|
tyre: { slot: 'iron', geometry: tyreRings },
|
|
}
|
|
},
|
|
}, overrides)
|
|
}
|