medieval-kit/my-registry/models/wooden-crate/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
8.9 KiB
TypeScript

/**
* @medieval-kit/wooden-crate
*
* Sandık, kutu değildir: dört köşe dikmesine çakılmış yatay tahta sıralarıdır.
* Aradaki ince boşluklar ve dikmelerin dışa taşması, siluete "monte edilmiş"
* okunuşunu veren şey. Bu model onu böyle kuruyor.
*
* Fıçıyla aynı core'u paylaşıyor: aynı meşe tonu, aynı deterministik
* rastgelelik, aynı vertex-renk tekniği. Yan yana koyduğunuzda aynı
* katalogdan gelmiş gibi durmalarının sebebi bu.
*/
import { Color, type BufferGeometry } from 'three'
import {
chamferedBoxGeometry,
createKitModel,
createRandom,
jitter,
MEDIEVAL_PALETTE,
mergeColoured,
type Vec3,
} from '../core/index.ts'
export interface WoodenCrateConfig {
/** Genişlik (X ekseni, metre). */
readonly width: number
/** Yükseklik (metre). */
readonly height: number
/** Derinlik (Z ekseni, metre). */
readonly depth: number
/** Her yüzdeki yatay tahta sırası sayısı. */
readonly plankRows: number
/** Demir kayış sayısı. 0 = sade ahşap sandık. */
readonly strapCount: number
/** Varyasyon tohumu. */
readonly seed: number
}
export const woodenCrateDefaults: WoodenCrateConfig = {
width: 0.66,
height: 0.52,
depth: 0.52,
plankRows: 3,
strapCount: 2,
seed: 3,
}
export type WoodenCrateParts = 'posts' | 'planks' | 'straps'
const SLOTS = ['oak', 'iron'] as const
type Slot = (typeof SLOTS)[number]
export function createModel(overrides: Partial<WoodenCrateConfig> = {}) {
return createKitModel<WoodenCrateConfig, 'oak' | 'iron', WoodenCrateParts>({
id: 'wooden-crate',
defaults: woodenCrateDefaults,
slots: SLOTS,
build: ({ config, random }) => {
/**
* Ölçü sözleşmesi.
*
* Z-FIGHTING KURALI: hiçbir iki yüzey aynı düzlemde, aynı yöne bakarak
* örtüşmemeli. Gerçek marangozlukta parçalar birbirine geçer; burada da öyle
* yapıyoruz. Dikmeler tahtalardan dışarı taşıyor, kapak ve taban çerçeveden
* biraz sarkıyor, tahtalar birbirine küt ekleniyor. Böylece her yüzey kendi
* düzleminde tek başına.
*/
const dims = () => {
const post = Math.min(config.width, config.depth) * 0.11
const board = post * 0.5
return {
post,
board,
/** Dikmelerin tahta yüzeyinden ne kadar dışarı taştığı. */
postProud: board * 0.45,
/** Kapak ve tabanın çerçeveden sarkması. */
overhang: board * 0.6,
half: config.height / 2,
}
}
function buildPosts(random: () => number): BufferGeometry {
const { post, board, half } = dims()
const tint = new Color()
const pieces: BufferGeometry[] = []
const x = config.width / 2 - post / 2
const z = config.depth / 2 - post / 2
// Dikmeler kapak ve tabanın İÇİNE giriyor; uçları o katı parçaların
// içinde kaldığı için görünmez ve hiçbir yüzeyle hizalanmaz.
const reach = half - board * 0.3
for (const [sx, sz] of [[-1, -1], [1, -1], [1, 1], [-1, 1]] as const) {
tint.copy(MEDIEVAL_PALETTE.oak)
// Dikmeler gövdeden biraz daha koyu: farklı kesim, daha çok yıpranma.
tint.offsetHSL(jitter(random, 0.01), jitter(random, 0.04), -0.045 + jitter(random, 0.02))
pieces.push(chamferedBoxGeometry(
[post, post], [post, post], reach * 2,
board * 0.16, [sx * x, 0, sz * z], tint,
))
}
return mergeColoured(pieces)
}
function buildPlanks(random: () => number): BufferGeometry {
const { board, postProud, overhang, half } = dims()
const tint = new Color()
const pieces: BufferGeometry[] = []
// Yan tahtalar dikmelerin ARKASINA çekili: dış yüzleri ±width/2 değil,
// ±(width/2 - postProud). Dikmelerle aynı düzleme oturmamalarının sebebi bu.
const faceX = config.width / 2 - postProud - board / 2
const faceZ = config.depth / 2 - postProud - board / 2
// Küt ek (butt joint): ön/arka tahtalar yan tahtaların iç yüzüne dayanır.
// Değiyorlar ama örtüşmüyorlar — kenar teması z-fighting üretmez.
const spanX = (config.width / 2 - postProud - board) * 2
const spanZ = (config.depth / 2 - postProud - board) * 2
// Sıralar kapak ve tabanın içine girecek kadar uzanıyor, ama dikmelerin
// uçlarından FARKLI bir yükseklikte bitiyor.
const wallTop = half - board * 0.65
const rows = Math.max(1, config.plankRows)
const gap = config.height * 0.012
const rowHeight = (wallTop * 2 - gap * (rows - 1)) / rows
for (let row = 0; row < rows; row += 1) {
const y = -wallTop + rowHeight / 2 + row * (rowHeight + gap)
for (const side of [-1, 1] as const) {
tint.copy(MEDIEVAL_PALETTE.oak)
tint.offsetHSL(jitter(random, 0.012), jitter(random, 0.05), jitter(random, 0.06))
pieces.push(chamferedBoxGeometry(
[spanX, board], [spanX, board], rowHeight,
board * 0.16, [0, y, side * faceZ], tint,
))
tint.copy(MEDIEVAL_PALETTE.oak)
tint.offsetHSL(jitter(random, 0.012), jitter(random, 0.05), jitter(random, 0.06))
pieces.push(chamferedBoxGeometry(
[board, spanZ], [board, spanZ], rowHeight,
board * 0.16, [side * faceX, y, 0], tint,
))
}
}
// Kapak ve taban: çerçevenin üstüne/altına oturan, biraz sarkan tahta
// levhalar. Sarkma sayesinde yan yüzleri dikmelerin yüzleriyle hizalanmıyor.
const slabWidth = config.width + overhang * 2
const slabDepth = config.depth + overhang * 2
const slabBoards = 3
const slabGap = slabDepth * 0.014
const boardDepth = (slabDepth - slabGap * (slabBoards - 1)) / slabBoards
for (const [y, shade] of [[half - board / 2, 0.03], [-half + board / 2, -0.05]] as const) {
for (let i = 0; i < slabBoards; i += 1) {
tint.copy(MEDIEVAL_PALETTE.oakEnd)
tint.offsetHSL(jitter(random, 0.01), jitter(random, 0.04), shade + jitter(random, 0.05))
pieces.push(chamferedBoxGeometry(
[slabWidth, boardDepth],
[slabWidth, boardDepth],
board,
board * 0.16,
[0, y, -slabDepth / 2 + boardDepth / 2 + i * (boardDepth + slabGap)],
tint,
))
}
}
return mergeColoured(pieces)
}
function buildStraps(random: () => number): BufferGeometry | undefined {
if (config.strapCount <= 0) return undefined
const { post } = dims()
const tint = new Color()
const pieces: BufferGeometry[] = []
const bandHeight = config.height * 0.07
const proud = post * 0.3
for (let i = 0; i < config.strapCount; i += 1) {
// Kayışlar üstten ve alttan içe doğru simetrik yerleşir.
const t = config.strapCount === 1
? 0
: 0.6 - (1.2 * i) / (config.strapCount - 1)
const y = (t * config.height) / 2
tint.copy(MEDIEVAL_PALETTE.iron)
tint.offsetHSL(0, jitter(random, 0.02), jitter(random, 0.06))
// Ön/arka kayışlar köşelerde dışa taşıyor; yan kayışlar onlara VARMADAN
// bitiyor. Böylece dört parçanın üst yüzleri köşede üst üste binmiyor.
pieces.push(
chamferedBoxGeometry([config.width + proud * 2, proud], [config.width + proud * 2, proud], bandHeight, proud * 0.22, [0, y, config.depth / 2], tint),
chamferedBoxGeometry([config.width + proud * 2, proud], [config.width + proud * 2, proud], bandHeight, proud * 0.22, [0, y, -config.depth / 2], tint),
chamferedBoxGeometry([proud, config.depth - proud], [proud, config.depth - proud], bandHeight, proud * 0.22, [config.width / 2, y, 0], tint),
chamferedBoxGeometry([proud, config.depth - proud], [proud, config.depth - proud], bandHeight, proud * 0.22, [-config.width / 2, y, 0], tint),
)
}
return mergeColoured(pieces)
}
// Çağrı SIRASI korunmalı: tohuma bağlı rastgelelik akış hâlinde
// ilerliyor, sıra değişirse geometri de değişir.
const postsPart = buildPosts(random)
const planksPart = buildPlanks(random)
const strapsPart = buildStraps(random)
return {
posts: { slot: 'oak' as const, geometry: postsPart },
planks: { slot: 'oak' as const, geometry: planksPart },
straps: strapsPart ? { slot: 'iron' as const, geometry: strapsPart } : undefined,
}
},
}, overrides)
}