From a19148a56b0ab1309543a9f5853b96a9529892b9 Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 00:30:41 +0100 Subject: [PATCH 1/7] trailview: the modelling kit, animal breed files with poses and two tiers, the showroom Co-Authored-By: Claude Opus 5.5 --- .../src/lib/trailview/dressing/dressing.ts | 53 +++++++- .../src/lib/trailview/dressing/dressing.wgsl | 36 ++++- .../web/src/lib/trailview/models/animals.ts | 79 ++--------- .../trailview/models/animals/brown-cattle.ts | 30 ++++ builder/web/src/lib/trailview/models/bake.ts | 13 +- builder/web/src/lib/trailview/models/flat.ts | 9 ++ .../src/lib/trailview/models/model-file.ts | 4 +- .../web/src/lib/trailview/models/sculpt.ts | 128 ++++++++++++++++++ 8 files changed, 270 insertions(+), 82 deletions(-) create mode 100644 builder/web/src/lib/trailview/models/animals/brown-cattle.ts create mode 100644 builder/web/src/lib/trailview/models/sculpt.ts diff --git a/builder/web/src/lib/trailview/dressing/dressing.ts b/builder/web/src/lib/trailview/dressing/dressing.ts index a6e75437bd..d4d8a6ce21 100644 --- a/builder/web/src/lib/trailview/dressing/dressing.ts +++ b/builder/web/src/lib/trailview/dressing/dressing.ts @@ -10,10 +10,28 @@ import { bits, named, type Rules } from '../rules/regions'; /** Herds stand within this many metres, rocks within this many; as HERDS of dressing.wgsl and ROCK_REACH_M of rocks.wgsl. */ const HERD_REACH_M = 1500, ROCK_REACH_M = 1000, HERDS = 4; +/** An animal draws its near tier to this many metres (specs/trailview-models.md). */ +const ANIMAL_NEAR_M = 150; /** Units along a herd cell and a rock point's cell, as HERD_SHIFT of dressing.wgsl and ROCK_SHIFT of rocks.wgsl. */ const HERD_CELL = 2 ** 14, ROCK_CELL = 2 ** 7; /** Words of `Herd` and bytes of `Dressing` in dressing.wgsl. */ -const HERD_WORDS = 8, DRESSING_BYTES = 48; +const HERD_WORDS = 8, DRESSING_BYTES = 64; + +/** + * The showroom (`showroom=lat,lon,heading,entries[,tier]` in the address), the engine view of the model review: in place + * of the herds, a row of animals across the view toward `heading` (degrees from north) at (lat, lon), SHOW_SPACING_M + * apart, each facing right and turned SHOW_TURN toward the eye. An entry is a breed, which stands all its models, or + * `breed.k`, its model k. With `tier` 1 every animal draws its far tier at any distance. + */ +interface Showroom { lonLat: [number, number]; heading: number; entries: string[]; tier: number } +const SHOW_SPACING_M = 3.2, SHOW_TURN = 0.45; + +function showroom(): Showroom | undefined { + const value = globalThis.location ? new URLSearchParams(globalThis.location.search).get('showroom') : null; + if (!value) return undefined; + const [lat, lon, heading, entries, tier] = value.split(','); + return { lonLat: [Number(lon), Number(lat)], heading: (Number(heading) * Math.PI) / 180, entries: entries.split('|'), tier: Number(tier ?? 0) }; +} interface Resources { gpu: Gpu; herds: GPUComputePipeline; rocks: GPUComputePipeline; groups: GPUBindGroup[]; params: GPUBuffer } @@ -28,6 +46,10 @@ export class Dressing implements Producer { private readonly rockModel?: number; private herdSide = 0; private rockSide = 0; + private readonly show = showroom(); + /** The first entry of the showroom's animals in the table, and their count. */ + private showFirst = 0; + private showCount = 0; /** The files of the models. */ private readonly urls: string[] = []; @@ -37,17 +59,31 @@ export class Dressing implements Producer { const spec = ({ tiers: [mesh], shape }: Packed, until: number): ModelSpec => ({ tiers: [{ mesh, until }], shape }); // No fade of the rocks' tier: rocks_of ends each rock at its own distance before the reach. this.rockModel = this.load(objects.file, objects.rocks, model => ({ ...spec(model, ROCK_REACH_M), fade: 0 })); - const breeds = new Map(), used = new Set(rules.regions.flatMap(region => region.herds.map(herd => herd.model)).filter(name => name in breedModels)); + const animal = ({ tiers: [near, far], shape }: Packed): ModelSpec => ({ tiers: this.show?.tier ? [{ mesh: far, until: HERD_REACH_M }] : [{ mesh: near, until: ANIMAL_NEAR_M }, { mesh: far, until: HERD_REACH_M }], shape }); + const shown = this.show?.entries.map(entry => entry.split('.')) ?? []; + const breeds = new Map(), used = new Set([...rules.regions.flatMap(region => region.herds.map(herd => herd.model)), ...shown.map(([name]) => name)].filter(name => name in breedModels)); for (const name of used) { - const first = this.load(breedModels[name].file, breedModels[name].coats, model => spec(model, HERD_REACH_M)); + const first = this.load(breedModels[name].file, breedModels[name].coats * breedModels[name].poses, animal); if (first !== undefined) breeds.set(name, first); } - this.table = new Uint32Array(Math.max(1, rules.regions.length) * HERDS * HERD_WORDS); + // The showroom's animals: an entry of a breed stands each of its models. + const row = shown.filter(([name]) => breeds.has(name)).flatMap(([name, k]) => (k ? [Number(k)] : Array.from({ length: breedModels[name].coats * breedModels[name].poses }, (_, m) => m)).map(m => ({ name, model: breeds.get(name)! + m }))); + this.showFirst = Math.max(1, rules.regions.length) * HERDS; + this.showCount = row.length; + this.table = new Uint32Array((this.showFirst + row.length) * HERD_WORDS); const floats = new Float32Array(this.table.buffer); + if (this.show) { + const across = -this.show.heading; + row.forEach(({ name, model }, k) => { + const at = (this.showFirst + k) * HERD_WORDS, offset = (k - (row.length - 1) / 2) * SHOW_SPACING_M; + this.table[at] = model; + floats.set([across - Math.PI / 2 - SHOW_TURN, breedModels[name].height, offset * Math.cos(across), offset * Math.sin(across)], at + 2); + }); + } rules.regions.forEach((region, r) => { region.herds.filter(herd => breeds.has(herd.model)).slice(0, HERDS).forEach((herd, k) => { - const at = (r * HERDS + k) * HERD_WORDS; - this.table.set([breeds.get(herd.model)!, breedModels[herd.model].coats], at); + const at = (r * HERDS + k) * HERD_WORDS, { coats, poses } = breedModels[herd.model]; + this.table.set([breeds.get(herd.model)!, coats | (poses << 16)], at); floats.set([herd.groups, breedModels[herd.model].height, ...herd.size], at + 2); this.table.set(bits(named(rules.vocabulary, herd.on)), at + 6); }); @@ -101,6 +137,11 @@ export class Dressing implements Producer { ints.set([Math.floor(ux / ROCK_CELL) - this.rockSide / 2, Math.floor(uy / ROCK_CELL) - this.rockSide / 2], 4); words[6] = this.rockModel ?? 0; floats[8] = HERD_REACH_M; + if (this.show) { + const [sx, sy] = worldPixel(this.show.lonLat, UNITS); + ints.set([Math.round(sx), Math.round(sy)], 12); + words.set([this.showCount, this.showFirst], 14); + } r.gpu.device.queue.writeBuffer(r.params, 0, params); } diff --git a/builder/web/src/lib/trailview/dressing/dressing.wgsl b/builder/web/src/lib/trailview/dressing/dressing.wgsl index 3669725517..9341f5c83c 100644 --- a/builder/web/src/lib/trailview/dressing/dressing.wgsl +++ b/builder/web/src/lib/trailview/dressing/dressing.wgsl @@ -24,13 +24,20 @@ struct Dressing { herd_reach: f32, unused2: f32, unused3: vec2f, + // The showroom of dressing.ts, which stands its animals in place of the herds: its middle in world units, its + // animals, and the first of their entries in `herds`. + show_origin: vec2i, + show_count: u32, + show_first: u32, } -// A herd of a region, as dressing.ts writes it: its first model and coats, its groups per eye's circle, -// its breed's height, its animals per group, and the materials that it grazes as bits of their codes. +// A herd of a region, as dressing.ts writes it: its first model, its coats (low 16 bits) and poses (high 16 bits), +// its groups per eye's circle, its breed's height, its animals per group, and the materials that it grazes as bits of +// their codes. Its models are each coat in each pose. A showroom entry holds its model, its yaw in `groups` and its +// offset from the showroom's middle in metres east and north in `size`. struct Herd { model: u32, - coats: u32, + looks: u32, groups: f32, height: f32, size: vec2f, @@ -58,6 +65,20 @@ var cell_region: u32; @compute @workgroup_size(64) fn herds_of(@builtin(workgroup_id) group: vec3u, @builtin(local_invocation_index) lane: u32) { + if (dressing.show_count > 0u) { + if (all(group.xy == vec2u(0u))) { + for (var i = lane; i < dressing.show_count; i += 64u) { + let h = herds[dressing.show_first + i]; + let at = dressing.show_origin + vec2i(round(vec2f(h.size.x, -h.size.y) / surface.unit)); + let s = lod_space(vec2f(at - surface.anchor)); + let ground = stand_height(s, at); + if (known(ground)) { + emit(h.model, s, ground, h.height, h.groups, 1.0, 1.0, 1.0); + } + } + } + return; + } let cell = dressing.herd_origin + vec2i(group.xy); let size = 1 << HERD_SHIFT; let corner = cell << vec2u(HERD_SHIFT); @@ -98,9 +119,12 @@ fn herds_of(@builtin(workgroup_id) group: vec3u, @builtin(local_invocation_index if (!known(ground)) { continue; } - // Most of a group wears the breed's first coat. - let coat = select(1u + mix_bits(a + 7u) % max(herd.coats - 1u, 1u), 0u, unit_float(mix_bits(a + 8u)) < 0.6 || herd.coats == 1u); - emit(herd.model + coat, s, ground, herd.height * (0.85 + 0.3 * unit_float(mix_bits(a + 9u))), + // Most of a group wears the breed's first coat; the poses come about as often each. + let coats = herd.looks & 0xffffu; + let poses = herd.looks >> 16u; + let coat = select(1u + mix_bits(a + 7u) % max(coats - 1u, 1u), 0u, unit_float(mix_bits(a + 8u)) < 0.6 || coats == 1u); + let pose = mix_bits(a + 12u) % poses; + emit(herd.model + coat * poses + pose, s, ground, herd.height * (0.85 + 0.3 * unit_float(mix_bits(a + 9u))), 6.2831853 * unit_float(mix_bits(a + 10u)), 1.0, 0.92 + 0.16 * unit_float(mix_bits(a + 11u)), 1.0); } } diff --git a/builder/web/src/lib/trailview/models/animals.ts b/builder/web/src/lib/trailview/models/animals.ts index 91e7e704b1..cf5ec485e5 100644 --- a/builder/web/src/lib/trailview/models/animals.ts +++ b/builder/web/src/lib/trailview/models/animals.ts @@ -1,71 +1,18 @@ -// Grazing animals for the herds, a low-poly rework of the prototype's src/models/animals/: one -// four-legged build whose proportions, coats, horns and patches make the breed. 1 m tall at the withers' -// top, feet at the origin, z up, facing +y; the instance scales it to the breed's height. -import { rgb } from '../structures/mesh'; -import { Model, random, shade, type Vec } from './flat'; +// The animals of the herds: one file per breed in animals/, whose name is the breed's id, by which packs name it. A breed +// builds each of its coats in each of its poses with the modelling kit (sculpt.ts): 1 m tall at the withers' top when +// it stands, feet at the origin, z up, facing +y; the instance scales it to the breed's height. +import type { Sculpt } from './sculpt'; -interface Breed { +export interface Animal { + name: string; + latin: string; /** Metres to the top of the back, which the instance scales to. */ height: number; - /** The body's length and its half-width and half-depth, the legs' length, the neck's rise and the head's length, as shares of the height. */ - body: [number, number, number]; - leg: number; - neck: number; - head: number; - /** Coats by seed: the body, and the belly, legs and head. */ - coats: [string, string][]; - /** Patches of the second colour over the body, a share of its faces. */ - patches?: number; - horns?: 'cow' | 'long' | 'curl' | 'goat'; - hooves: string; + coats: Coat[]; + /** The count of poses; the herds draw each about as often. */ + poses: number; + build(s: Sculpt, coat: Coat, pose: number): void; } -/** The breeds that the packs of data/trailview/packs name as herd models. */ -export const BREEDS: Record = { - 'brown-cattle': { height: 1.4, body: [1.45, 0.3, 0.32], leg: 0.52, neck: 0.12, head: 0.36, coats: [['#7e6a58', '#a8957e'], ['#8e4a24', '#b87444'], ['#ae8250', '#d4ae78']], horns: 'cow', hooves: '#2c2420' }, - 'dairy-cattle': { height: 1.45, body: [1.5, 0.29, 0.32], leg: 0.55, neck: 0.1, head: 0.36, coats: [['#e9e6de', '#1e1c1b'], ['#e9e6de', '#1e1c1b']], patches: 0.45, hooves: '#2c2420' }, - 'simmental-cattle': { height: 1.45, body: [1.45, 0.3, 0.32], leg: 0.52, neck: 0.1, head: 0.36, coats: [['#ece6da', '#a85428'], ['#ece6da', '#c88e4c']], patches: 0.5, horns: 'cow', hooves: '#2c2420' }, - 'highland-cow': { height: 1.3, body: [1.4, 0.34, 0.36], leg: 0.46, neck: 0.1, head: 0.38, coats: [['#b3561f', '#e09048'], ['#4a2a1a', '#7a4a2c'], ['#d0ae74', '#efd6a2']], horns: 'long', hooves: '#2c2420' }, - sheep: { height: 0.95, body: [1.15, 0.36, 0.38], leg: 0.5, neck: 0.14, head: 0.3, coats: [['#efe7d6', '#2d2828'], ['#e6dcc6', '#2d2828']], horns: 'curl', hooves: '#2e211b' }, - goat: { height: 1.05, body: [1.1, 0.24, 0.27], leg: 0.6, neck: 0.22, head: 0.3, coats: [['#2e241e', '#ece4d4'], ['#2a211c', '#5a4434'], ['#87482a', '#e6dccb']], horns: 'goat', hooves: '#2c2420' }, - horse: { height: 1.6, body: [1.35, 0.22, 0.27], leg: 0.62, neck: 0.42, head: 0.42, coats: [['#6a3418', '#1a1512'], ['#8a4018', '#6e3014'], ['#b8b6b2', '#6e6c6a'], ['#221f1e', '#141212']], hooves: '#2a2624' }, -}; - -/** An animal of a breed in one of its coats. */ -export function animal(name: string, seed = 0): Model { - const b = BREEDS[name], [length, half, deep] = b.body, rand = random(seed + 3); - const [coat, other] = b.coats[seed % b.coats.length].map(h => rgb(h)), m = new Model(); - const back = 1, belly = b.leg, mid = (back + belly) / 2, y0 = -length / 2, y1 = length / 2; - // The body: an octagon swept from rump to chest; patches paint some of its faces in the second colour. - const ring = (y: number, k: number): Vec[] => Array.from({ length: 8 }, (_, i) => { - const a = (i / 8) * 2 * Math.PI; - return [Math.cos(a) * half * k, y, mid + Math.sin(a) * (back - belly) / 2 * k]; - }); - const rings = [ring(y0, 0.75), ring(y0 + 0.15 * length, 1), ring(y1 - 0.2 * length, 1), ring(y1, 0.8)]; - rings.slice(1).forEach((r, k) => r.forEach((p, i) => { - const q = rings[k], j = (i + 1) % 8, low = Math.sin(((i + 0.5) / 8) * 2 * Math.PI) < -0.5; - m.poly([q[i], q[j], r[j], p], b.patches && rand() < b.patches ? other : low && !b.patches ? shade(coat, 0.85) : coat); - })); - m.poly(rings[0], coat).poly(rings[3], coat); - // Neck and head: the neck rises from the chest, the head hangs forward from it. - const neck: Vec = [0, y1 + 0.05, back + b.neck], snout: Vec = [0, y1 + 0.05 + b.head, back + b.neck - 0.25 * b.head]; - const face = b.patches ? other : name === 'sheep' ? other : coat; - m.beam([0, y1 - 0.05, mid + 0.05], neck, deep * 1.1, coat, { sides: 6, w1: deep * 0.8 }); - m.beam(neck, snout, deep * 0.8, face, { sides: 6, w1: deep * 0.5, capped: true }); - for (const s of [-1, 1]) m.box([s * deep * 0.5, neck[1] + 0.03, neck[2] + 0.06], [0.14 * b.head + 0.05, 0.04, 0.06], face); - // Legs, hooves and tail. - for (const [x, y] of [[-1, y0 + 0.12], [1, y0 + 0.12], [-1, y1 - 0.12], [1, y1 - 0.12]]) { - m.beam([x * half * 0.55, y, mid], [x * half * 0.55, y, 0.06], 0.09 + 0.05 * half, name === 'sheep' || b.patches ? other : coat, { sides: 4, w1: 0.07 }); - m.box([x * half * 0.55, y, 0.03], [0.1, 0.12, 0.06], rgb(b.hooves)); - } - m.beam([0, y0, back - 0.05], [0, y0 - 0.06, belly - 0.05], 0.05, coat, { sides: 3 }); - // Horns. - const horn = rgb('#e2d6b8'), top = neck[2] + 0.1; - if (b.horns) for (const s of [-1, 1]) { - const at: Vec = [s * deep * 0.35, neck[1] + 0.02, top]; - const tip: Vec = b.horns === 'long' ? [s * (deep + 0.45), at[1] + 0.05, top + 0.12] : b.horns === 'goat' ? [s * 0.12, at[1] - 0.22, top + 0.2] - : b.horns === 'curl' ? [s * (deep * 0.6), at[1] - 0.05, top - 0.12] : [s * (deep * 0.5 + 0.12), at[1] + 0.04, top + 0.12]; - m.beam(at, tip, 0.06, b.horns === 'goat' ? rgb('#6b5c4a') : horn, { sides: 3, w1: 0.02 }); - } - return m; -} +export const ANIMALS = Object.fromEntries(Object.entries(import.meta.glob('./animals/*.ts', { eager: true, import: 'default' })) + .map(([path, animal]) => [path.split('/').pop()!.replace(/\.ts$/, ''), animal as Animal])); diff --git a/builder/web/src/lib/trailview/models/animals/brown-cattle.ts b/builder/web/src/lib/trailview/models/animals/brown-cattle.ts new file mode 100644 index 0000000000..1dbf28489e --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/brown-cattle.ts @@ -0,0 +1,30 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { alongY, axis, bands, bellied, both } from '../sculpt'; + +const EYE = rgb('#1c1614'), HOOF = rgb('#2c2420'), HORN = rgb('#e2d6b8'), PINK = rgb('#d8a79a'), CREAM = rgb('#e4d8c2'), NOSE = rgb('#3a2e2a'); + +export default { + name: 'Brown cattle', + latin: 'Bos taurus', + height: 1.4, + coats: ['#9a7a5c', '#8e4a24', '#ae8250'].map(rgb), + poses: 1, + build(s, coat) { + const h = axis([0, 0.66, 1.0], -30); + s.skin(alongY([[-0.66, 0.74, 0.12, 0.14, 0.14], [-0.56, 0.72, 0.25, 0.25, 0.24], [-0.3, 0.72, 0.31, 0.28, 0.31], [0.05, 0.71, 0.32, 0.28, 0.33], [0.35, 0.73, 0.29, 0.27, 0.3], [0.52, 0.75, 0.22, 0.22, 0.24], [0.6, 0.76, 0.12, 0.13, 0.14]]), 10, bellied(coat, shade(coat, 0.85))); + s.skin(alongY([[0.38, 0.78, 0.2, 0.2, 0.22, 30], [0.74, 0.93, 0.135, 0.14, 0.15, 25]]), 8, coat); + s.skin(h.rings([[0, 0.1, 0.1, 0.1], [0.07, 0.165, 0.15, 0.15], [0.2, 0.17, 0.15, 0.16], [0.34, 0.13, 0.11, 0.13], [0.44, 0.125, 0.1, 0.12], [0.5, 0.09, 0.07, 0.08]]), 8, bands(coat, coat, coat, coat, CREAM, CREAM, NOSE)); + const leg = (y: number, k: number) => [[y, 0.62, 0.1 * k, 0.12 * k, 0.12 * k], [y, 0.36, 0.075, 0.085, 0.085], [y, 0.1, 0.065, 0.07, 0.07], [y, 0.085, 0.08, 0.09, 0.085], [y, 0, 0.085, 0.1, 0.09]]; + for (const [x, y, k] of [[0.17, 0.36, 1], [0.18, -0.42, 1.15]]) both(side => s.skin(leg(y, k).map(([ly, z, w, up, down]) => ({ at: [side * x, ly, z], w, up, down, pitch: -90, e: 2 })), 6, bands(coat, coat, coat, HOOF))); + both(side => { + s.leaf(h.p(0.1, side * 0.13, 0.05), h.p(0.08, side * 0.4, 0), 0.14, 0.05, h.dir, coat); + s.chain([h.p(0.06, side * 0.1, 0.12), h.p(0.05, side * 0.2, 0.2), h.p(0.07, side * 0.22, 0.3)], [0.06, 0.045, 0.015], HORN); + s.fine(() => s.box(h.p(0.21, side * 0.165, 0.05), [0.03, 0.05, 0.05], EYE)); + }); + s.fine(() => s.chain([[0, -0.66, 0.9], [0, -0.75, 0.6], [0, -0.75, 0.42]], [0.04, 0.03, 0.03], coat)); + s.fine(() => s.chain([[0, -0.75, 0.44], [0, -0.75, 0.28]], [0.08, 0.03], NOSE)); + s.fine(() => s.skin(alongY([[-0.25, 0.46, 0.11, 0.13, 0.13, -90], [-0.25, 0.36, 0.09, 0.11, 0.11, -90], [-0.25, 0.33, 0.05, 0.06, 0.06, -90]]), 6, PINK)); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/bake.ts b/builder/web/src/lib/trailview/models/bake.ts index 530e6483bf..cd8e63f6d4 100644 --- a/builder/web/src/lib/trailview/models/bake.ts +++ b/builder/web/src/lib/trailview/models/bake.ts @@ -3,13 +3,14 @@ import { KINDS } from '../kinds'; import { SEASONS, type Season } from '../rules/regions'; import { SUMMER } from '../vegetation/phenology'; -import { animal, BREEDS } from './animals'; +import { ANIMALS } from './animals'; import { geometry } from './flat'; import { bareIn, tree, TREES } from './library'; import type { FloatMesh, Models, Packed } from './model-file'; import { encodeModels, pack } from './pack'; import { plant, PLANTS } from './plant-library'; import { rock } from './rocks'; +import { mesh, Sculpt } from './sculpt'; import { lit, simplified, simplifierReady } from './simplify'; import { fits, tone } from './tone'; import type { Grown, Lod } from './trees'; @@ -74,7 +75,15 @@ export async function bake(): Promise { models.plants[id] = { ground, seasons }; } - for (const [name, breed] of Object.entries(BREEDS)) models.breeds[name] = { height: breed.height, coats: breed.coats.length, file: await file('animal', `animal-${name}`, breed.coats.map((_, coat) => pack([geometry(animal(name, coat))]))) }; + // A breed's models, each coat in each pose, with a near and a far tier. + for (const [name, animal] of Object.entries(ANIMALS)) { + const built = animal.coats.flatMap(coat => Array.from({ length: animal.poses }, (_, pose) => pack([0, 1].map(tier => { + const s = new Sculpt(tier); + animal.build(s, coat, pose); + return mesh(s.model); + })))); + models.breeds[name] = { height: animal.height, coats: animal.coats.length, poses: animal.poses, file: await file('animal', `animal-${name}`, built) }; + } const rocks = (['slab', 'boulder'] as const).flatMap(name => Array.from({ length: SLABS }, (_, k) => pack([geometry(rock(name, k + 1))]))); const points = [...KINDS].flatMap(([, kind]) => Object.values(kind.models ?? {}).map(source => source())); diff --git a/builder/web/src/lib/trailview/models/flat.ts b/builder/web/src/lib/trailview/models/flat.ts index 1719a31953..0e50b8d566 100644 --- a/builder/web/src/lib/trailview/models/flat.ts +++ b/builder/web/src/lib/trailview/models/flat.ts @@ -23,6 +23,10 @@ export class Model { /** How much each triangle glows at night, 0 to 1, and whether it rises from its foot as the night falls, as a flame. */ readonly glows: number[] = []; readonly rises: boolean[] = []; + /** The polygon of each triangle: the triangles of one `poly` share it. */ + readonly faces: number[] = []; + private polygons = 0; + private open?: number; get triangles(): number { return this.colours.length; @@ -33,6 +37,7 @@ export class Model { this.colours.push(colour); this.glows.push(0); this.rises.push(false); + this.faces.push(this.open ?? this.polygons++); return this; } @@ -45,7 +50,9 @@ export class Model { /** A convex polygon, as a fan. */ poly(corners: Vec[], colour: number): this { + this.open = this.polygons++; for (let i = 1; i + 1 < corners.length; i++) this.tri(corners[0], corners[i], corners[i + 1], colour); + this.open = undefined; return this; } @@ -54,6 +61,8 @@ export class Model { this.colours.push(...other.colours); this.glows.push(...other.glows); this.rises.push(...other.rises); + this.faces.push(...other.faces.map(face => face + this.polygons)); + this.polygons += other.polygons; return this; } diff --git a/builder/web/src/lib/trailview/models/model-file.ts b/builder/web/src/lib/trailview/models/model-file.ts index 4240c429ea..9a466946e9 100644 --- a/builder/web/src/lib/trailview/models/model-file.ts +++ b/builder/web/src/lib/trailview/models/model-file.ts @@ -67,8 +67,8 @@ export function quantize(mesh: FloatMesh, extent: number): Uint8Array } -/** A breed: its height in metres to the top of the back, its count of coats, and the file of its coats. */ -export interface BreedEntry { height: number; coats: number; file: string } +/** A breed: its height in metres to the top of the back, its counts of coats and poses, and the file of its models, each coat in each pose. */ +export interface BreedEntry { height: number; coats: number; poses: number; file: string } /** * The models of the build (`virtual:models`): what the engine knows before it fetches a file. The objects file holds the diff --git a/builder/web/src/lib/trailview/models/sculpt.ts b/builder/web/src/lib/trailview/models/sculpt.ts new file mode 100644 index 0000000000..25af71c3a8 --- /dev/null +++ b/builder/web/src/lib/trailview/models/sculpt.ts @@ -0,0 +1,128 @@ +// The modelling kit of the soft low-poly style (docs/content: the model style guide): round skins lofted through rings, +// flat leaves and chains of bars, in flat faces of one colour each. Every face turns away from a point inside its part, +// so no part needs a hand-made winding. A sculpt has a tier: tier 1 builds the same parts with fewer sides and leaves +// out the fine details, for the far tier of a model. +import { geometry, Model, type Vec } from './flat'; +import type { FloatMesh } from './model-file'; + +/** A ring of a skin: its middle, its half-width, its reach above and below the middle, the pitch of its axis above +y in degrees, and how square it is (2 is an ellipse). */ +export interface Ring { at: Vec; w: number; up: number; down: number; pitch: number; e: number } +/** The colour of a face from its band (−1 and the band count are the end caps) and from how far up (−1 to 1) its facet looks. */ +export type Paint = (band: number, top: number) => number; + +export const sub = (a: Vec, b: Vec): Vec => [a[0] - b[0], a[1] - b[1], a[2] - b[2]]; +export const along = (a: Vec, d: Vec, k: number): Vec => [a[0] + d[0] * k, a[1] + d[1] * k, a[2] + d[2] * k]; +const cross = (a: Vec, b: Vec): Vec => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]]; +const unit = (a: Vec): Vec => along([0, 0, 0], a, 1 / (Math.hypot(...a) || 1)); +const bend = (v: number, e: number) => Math.sign(v) * Math.abs(v) ** (2 / e); + +/** A paint of one colour for each band; the caps take the first and the last. */ +export const bands = (...colours: number[]): Paint => band => colours[Math.max(0, Math.min(colours.length - 1, band + 1))]; +/** A paint with a belly: the facets that look down take `under`. */ +export const bellied = (coat: number, under: number): Paint => (_, top) => (top < -0.6 ? under : coat); +/** The same part at both sides: `f` takes −1 and 1. */ +export const both = (f: (s: number) => void) => [-1, 1].forEach(f); + +/** The rings of a part along y from rows of [y, z, half-width, up, down, pitch]. */ +export const alongY = (rows: number[][], e = 2): Ring[] => rows.map(([y, z, w, up, down, pitch = 0]) => ({ at: [0, y, z], w, up, down, pitch, e })); + +/** + * A frame along an axis from `at`, pitched `pitch` degrees above +y: `p(d, x, v)` is the point d along the axis, x to the + * side and v above it; `rings` takes rows of [d, half-width, up, down]. A head, a neck or a tail hangs from one. + */ +export function axis(at: Vec, pitch: number) { + const c = Math.cos((pitch * Math.PI) / 180), s = Math.sin((pitch * Math.PI) / 180); + const p = (d: number, x = 0, v = 0): Vec => [at[0] + x, at[1] + d * c - v * s, at[2] + d * s + v * c]; + return { p, dir: [0, c, s] as Vec, rings: (rows: number[][], e = 2): Ring[] => rows.map(([d, w, up, down]) => ({ at: p(d), w, up, down, pitch, e })) }; +} + +/** Tier 1 builds a part of n sides with this share of them, at least 3. */ +const FAR_SIDES = 0.4; + +/** A model in the making, at a tier: 0 near, 1 far. */ +export class Sculpt { + readonly model = new Model(); + constructor(readonly tier = 0) {} + + /** Sides of a part that has n at tier 0. */ + sides(n: number): number { + return this.tier ? Math.max(3, Math.round(n * FAR_SIDES)) : n; + } + + /** Fine details, which only tier 0 builds. */ + fine(f: () => void): this { + if (!this.tier) f(); + return this; + } + + /** A convex face whose normal points away from `inside`. */ + face(corners: Vec[], colour: number, inside: Vec): this { + const n = cross(sub(corners[1], corners[0]), sub(corners[2], corners[0])); + const mid = corners.reduce((sum, p) => along(sum, p, 1 / corners.length), [0, 0, 0] as Vec), out = sub(mid, inside); + this.model.poly(n[0] * out[0] + n[1] * out[1] + n[2] * out[2] < 0 ? [...corners].reverse() : corners, colour); + return this; + } + + /** A skin of `sides` facets (fewer at tier 1) through the rings, its ends closed. `lump` pushes every second point out and the others in, as wool. */ + skin(rings: Ring[], sides: number, paint: Paint | number, lump = 0): this { + const colour: Paint = typeof paint === 'number' ? () => paint : paint, last = rings.length - 1, n = this.sides(sides); + const points = rings.map((r, i) => Array.from({ length: n }, (_, k): Vec => { + const t = (2 * Math.PI * (k + 0.5)) / n, p = (r.pitch * Math.PI) / 180, swell = i > 0 && i < last ? 1 + lump * ((i + k) % 2 ? 1 : -1) : 1; + const s = bend(Math.sin(t), r.e), v = s * (s > 0 ? r.up : r.down) * swell; + return [r.at[0] + bend(Math.cos(t), r.e) * r.w * swell, r.at[1] - Math.sin(p) * v, r.at[2] + Math.cos(p) * v]; + })); + for (let i = 0; i < last; i++) for (let k = 0; k < n; k++) { + const j = (k + 1) % n; + this.face([points[i][k], points[i][j], points[i + 1][j], points[i + 1][k]], colour(i, Math.sin((2 * Math.PI * (k + 1)) / n)), along(rings[i].at, sub(rings[i + 1].at, rings[i].at), 0.5)); + } + this.face(points[0], colour(-1, 0), rings[1].at); + return this.face(points[last], colour(last, 0), rings[last - 1].at); + } + + /** A flat diamond from a to its tip b, `width` across and `thick` along n: an ear, a beard, a short tail. */ + leaf(a: Vec, b: Vec, width: number, thick: number, n: Vec, colour: number): this { + const d = sub(b, a), s = unit(cross(d, n)), c = along(a, d, 0.4), t = unit(n); + const q = [along(c, s, width / 2), along(c, t, thick / 2), along(c, s, -width / 2), along(c, t, -thick / 2)]; + for (let k = 0; k < 4; k++) for (const end of [a, b]) this.face([end, q[k], q[(k + 1) % 4]], colour, c); + return this; + } + + /** Bars through the points, each `widths` across at its point, of `sides` sides (fewer at tier 1): a horn, a tail. */ + chain(points: Vec[], widths: number[], colour: number, sides = 4): this { + for (let i = 0; i + 1 < points.length; i++) this.model.beam(points[i], points[i + 1], widths[i], colour, { sides: this.sides(sides), w1: widths[i + 1], capped: true }); + return this; + } + + /** A box about its middle: an eye, a nostril. */ + box(at: Vec, size: Vec, colour: number): this { + this.model.box(at, size, colour); + return this; + } +} + +/** + * The mesh of a model as the instances read it: each polygon lit flat by one normal (Newell's, so a lofted quad that is + * not quite planar draws as one facet), its corners kept once. + */ +export function mesh(model: Model): FloatMesh { + const flat = geometry(model), p = model.points, normals = new Map(); + model.faces.forEach((face, t) => { + const n = normals.get(face) ?? [0, 0, 0], i = 9 * t; + const c = cross([p[i + 3] - p[i], p[i + 4] - p[i + 1], p[i + 5] - p[i + 2]], [p[i + 6] - p[i], p[i + 7] - p[i + 1], p[i + 8] - p[i + 2]]); + normals.set(face, along(n, c, 1)); + }); + const at = new Map(), out = { position: [] as number[], normal: [] as number[], color: [] as number[], index: [] as number[] }; + for (let v = 0; v < flat.position.length / 3; v++) { + const position = [0, 1, 2].map(d => flat.position[3 * v + d]), normal = unit(normals.get(model.faces[Math.floor(v / 3)])!), color = [0, 1, 2].map(d => flat.color[3 * v + d]); + const key = [...position, ...normal, ...color].join(); + let k = at.get(key); + if (k === undefined) { + at.set(key, (k = out.position.length / 3)); + out.position.push(...position); + out.normal.push(...normal); + out.color.push(...color); + } + out.index.push(k); + } + return out; +} From 354d071d909b38265013f6802072ffa641c6135f Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 01:14:42 +0100 Subject: [PATCH 2/7] trailview: the animals in the soft low-poly style, 14 breeds in 3 poses, and the model review page Co-Authored-By: Claude Opus 5.5 --- .../src/lib/trailview/dressing/dressing.ts | 13 +- .../trailview/models/animals/body/cattle.ts | 29 +++++ .../lib/trailview/models/animals/body/deer.ts | 23 ++++ .../models/animals/body/quadruped.ts | 122 ++++++++++++++++++ .../trailview/models/animals/brown-cattle.ts | 24 +--- .../lib/trailview/models/animals/chamois.ts | 35 +++++ .../trailview/models/animals/dairy-cattle.ts | 19 +++ .../lib/trailview/models/animals/donkey.ts | 36 ++++++ .../lib/trailview/models/animals/dromedary.ts | 30 +++++ .../src/lib/trailview/models/animals/goat.ts | 41 ++++++ .../trailview/models/animals/highland-cow.ts | 32 +++++ .../src/lib/trailview/models/animals/horse.ts | 33 +++++ .../src/lib/trailview/models/animals/ibex.ts | 41 ++++++ .../src/lib/trailview/models/animals/pig.ts | 31 +++++ .../lib/trailview/models/animals/red-deer.ts | 33 +++++ .../lib/trailview/models/animals/reindeer.ts | 37 ++++++ .../src/lib/trailview/models/animals/sheep.ts | 32 +++++ .../models/animals/simmental-cattle.ts | 17 +++ .../web/src/lib/trailview/models/sculpt.ts | 43 ++++-- .../web/tests/browser/trailview/models.mjs | 68 ++++++++++ builder/web/vite/model-files.ts | 2 +- 21 files changed, 700 insertions(+), 41 deletions(-) create mode 100644 builder/web/src/lib/trailview/models/animals/body/cattle.ts create mode 100644 builder/web/src/lib/trailview/models/animals/body/deer.ts create mode 100644 builder/web/src/lib/trailview/models/animals/body/quadruped.ts create mode 100644 builder/web/src/lib/trailview/models/animals/chamois.ts create mode 100644 builder/web/src/lib/trailview/models/animals/dairy-cattle.ts create mode 100644 builder/web/src/lib/trailview/models/animals/donkey.ts create mode 100644 builder/web/src/lib/trailview/models/animals/dromedary.ts create mode 100644 builder/web/src/lib/trailview/models/animals/goat.ts create mode 100644 builder/web/src/lib/trailview/models/animals/highland-cow.ts create mode 100644 builder/web/src/lib/trailview/models/animals/horse.ts create mode 100644 builder/web/src/lib/trailview/models/animals/ibex.ts create mode 100644 builder/web/src/lib/trailview/models/animals/pig.ts create mode 100644 builder/web/src/lib/trailview/models/animals/red-deer.ts create mode 100644 builder/web/src/lib/trailview/models/animals/reindeer.ts create mode 100644 builder/web/src/lib/trailview/models/animals/sheep.ts create mode 100644 builder/web/src/lib/trailview/models/animals/simmental-cattle.ts create mode 100644 builder/web/tests/browser/trailview/models.mjs diff --git a/builder/web/src/lib/trailview/dressing/dressing.ts b/builder/web/src/lib/trailview/dressing/dressing.ts index d4d8a6ce21..dc3e72ed44 100644 --- a/builder/web/src/lib/trailview/dressing/dressing.ts +++ b/builder/web/src/lib/trailview/dressing/dressing.ts @@ -19,12 +19,12 @@ const HERD_WORDS = 8, DRESSING_BYTES = 64; /** * The showroom (`showroom=lat,lon,heading,entries[,tier]` in the address), the engine view of the model review: in place - * of the herds, a row of animals across the view toward `heading` (degrees from north) at (lat, lon), SHOW_SPACING_M - * apart, each facing right and turned SHOW_TURN toward the eye. An entry is a breed, which stands all its models, or + * of the herds, a row of animals across the view toward `heading` (degrees from north) at (lat, lon), SHOW_SPACING + * times their heights apart, each facing right and turned SHOW_TURN toward the eye. An entry is a breed, which stands all its models, or * `breed.k`, its model k. With `tier` 1 every animal draws its far tier at any distance. */ interface Showroom { lonLat: [number, number]; heading: number; entries: string[]; tier: number } -const SHOW_SPACING_M = 3.2, SHOW_TURN = 0.45; +const SHOW_SPACING = 2.3, SHOW_TURN = 0.45; function showroom(): Showroom | undefined { const value = globalThis.location ? new URLSearchParams(globalThis.location.search).get('showroom') : null; @@ -73,11 +73,14 @@ export class Dressing implements Producer { this.table = new Uint32Array((this.showFirst + row.length) * HERD_WORDS); const floats = new Float32Array(this.table.buffer); if (this.show) { - const across = -this.show.heading; + const across = -this.show.heading, room = row.map(({ name }) => SHOW_SPACING * breedModels[name].height); + let offset = -room.reduce((sum, r) => sum + r, 0) / 2; row.forEach(({ name, model }, k) => { - const at = (this.showFirst + k) * HERD_WORDS, offset = (k - (row.length - 1) / 2) * SHOW_SPACING_M; + const at = (this.showFirst + k) * HERD_WORDS; + offset += room[k] / 2; this.table[at] = model; floats.set([across - Math.PI / 2 - SHOW_TURN, breedModels[name].height, offset * Math.cos(across), offset * Math.sin(across)], at + 2); + offset += room[k] / 2; }); } rules.regions.forEach((region, r) => { diff --git a/builder/web/src/lib/trailview/models/animals/body/cattle.ts b/builder/web/src/lib/trailview/models/animals/body/cattle.ts new file mode 100644 index 0000000000..83448554d1 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/body/cattle.ts @@ -0,0 +1,29 @@ +// The body that the cattle breeds share. +import { shade } from '../../flat'; +import { alongY, bellied, both, type Paint, type Sculpt } from '../../sculpt'; +import { CREAM, ears, eyes, HOOF, HORN, NOSE, PINK, quadruped, type Body, type Coat } from './quadruped'; + +const BODY: Body = { + trunk: [[-0.66, 0.74, 0.12, 0.14, 0.14], [-0.56, 0.72, 0.25, 0.25, 0.24], [-0.3, 0.72, 0.31, 0.28, 0.31], [0.05, 0.71, 0.32, 0.28, 0.33], [0.35, 0.73, 0.29, 0.27, 0.3], [0.52, 0.75, 0.22, 0.22, 0.24], [0.6, 0.76, 0.12, 0.13, 0.14]], + neck: { at: [0.38, 0.78], length: 0.4, size: [[0.2, 0.2, 0.22], [0.135, 0.14, 0.15]], carry: [[24, 20], [-30, -60], [35, 25]] }, + head: { rows: [[0, 0.1, 0.1, 0.1], [0.07, 0.165, 0.15, 0.15], [0.2, 0.17, 0.15, 0.16], [0.34, 0.13, 0.11, 0.13], [0.44, 0.125, 0.1, 0.12], [0.5, 0.09, 0.07, 0.08]], nod: [-30, -72, -25] }, + front: { x: 0.17, y: 0.36, top: 0.62, thigh: 0.1, bone: 0.075 }, + hind: { x: 0.18, y: -0.42, top: 0.62, thigh: 0.115, bone: 0.075 }, +}; + +export interface Cattle { coat: number; trunk?: Paint; neck?: number; head?: Coat['head']; shin?: number; ear?: number; tuft?: number; horns?: boolean } + +/** A cow of the plain build: a breed gives its colours, and the paints of a patched one. */ +export function cattle(s: Sculpt, pose: number, c: Cattle): void { + const q = quadruped(s, BODY, pose, { + trunk: c.trunk ?? bellied(c.coat, shade(c.coat, 0.85)), neck: c.neck ?? c.coat, + head: c.head ?? (d => (d > 1 ? NOSE : d > 0.7 ? CREAM : c.coat)), + leg: () => [c.coat, c.shin ?? c.coat, HOOF], + }), h = q.head; + ears(s, h, [0.1, 0.12, 0.03], [0.0, 0.38, -0.07], 0.19, c.ear ?? c.coat); + if (c.horns ?? true) both(side => s.chain([h.p(0.06, side * 0.1, 0.12), h.p(0.05, side * 0.2, 0.2), h.p(0.07, side * 0.22, 0.3)], [0.06, 0.045, 0.015], HORN)); + eyes(s, h, [0.21, 0.165, 0.05]); + s.fine(() => s.chain([[0, -0.66, 0.9], [0, -0.75, 0.6], [0, -0.75, 0.42]].map(q.body), [0.04, 0.03, 0.03], c.coat)); + s.fine(() => s.chain([q.body([0, -0.75, 0.44]), q.body([0, -0.75, 0.28])], [0.08, 0.03], c.tuft ?? NOSE)); + if (!q.lies) s.fine(() => s.skin(alongY([[-0.25, 0.46, 0.11, 0.13, 0.13, -90], [-0.25, 0.36, 0.09, 0.11, 0.11, -90], [-0.25, 0.33, 0.05, 0.06, 0.06, -90]]), 6, PINK)); +} diff --git a/builder/web/src/lib/trailview/models/animals/body/deer.ts b/builder/web/src/lib/trailview/models/animals/body/deer.ts new file mode 100644 index 0000000000..70364f3e29 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/body/deer.ts @@ -0,0 +1,23 @@ +// The body and the antlers that the deer share. +import { both, type Sculpt } from '../../sculpt'; +import type { Body, quadruped } from './quadruped'; + +export const DEER: Body = { + trunk: [[-0.54, 0.8, 0.1, 0.11, 0.11], [-0.46, 0.79, 0.21, 0.2, 0.2], [-0.2, 0.78, 0.25, 0.22, 0.23], [0.1, 0.77, 0.25, 0.22, 0.24], [0.32, 0.78, 0.22, 0.22, 0.23], [0.45, 0.8, 0.16, 0.17, 0.18], [0.52, 0.81, 0.08, 0.09, 0.1]], + neck: { at: [0.34, 0.85], length: 0.48, size: [[0.16, 0.18, 0.2], [0.11, 0.125, 0.13], [0.095, 0.105, 0.105]], carry: [[66, 56], [-30, -55], [68, 58]] }, + head: { rows: [[0, 0.075, 0.08, 0.08], [0.06, 0.125, 0.115, 0.115], [0.18, 0.13, 0.115, 0.12], [0.32, 0.09, 0.08, 0.09], [0.42, 0.08, 0.065, 0.075], [0.46, 0.055, 0.045, 0.05]], nod: [-22, -72, -18], set: [0.05, 0.08] }, + front: { x: 0.13, y: 0.3, top: 0.68, thigh: 0.08, bone: 0.05 }, + hind: { x: 0.135, y: -0.38, top: 0.68, thigh: 0.095, bone: 0.05 }, +}; + +/** + * Both antlers from the crown frame: the beam through rows of [back, up, out], and tines as [the row of the beam they + * leave, back, up, out] of their tips. Tier 1 keeps the beam and the first tine. + */ +export function antlers(s: Sculpt, k: ReturnType['crown']>, beam: number[][], tines: number[][], colour: number, w = 0.055): void { + both(side => { + const at = ([back, up, out]: number[]) => k.p(-back, side * out, up), width = (i: number) => w * (1 - (0.8 * i) / (beam.length - 1)); + s.chain(beam.map(at), beam.map((_, i) => width(i)), colour, 3); + tines.forEach(([from, ...tip], i) => (i && s.tier) || s.chain([at(beam[from]), at(tip)], [0.85 * width(from), 0.012], colour, 3)); + }); +} diff --git a/builder/web/src/lib/trailview/models/animals/body/quadruped.ts b/builder/web/src/lib/trailview/models/animals/body/quadruped.ts new file mode 100644 index 0000000000..04baf30091 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/body/quadruped.ts @@ -0,0 +1,122 @@ +// The body that every herd animal shares: a trunk, a bent neck, a head and four legs from the numbers of a breed, in a +// pose. The breed adds what makes it itself (ears, horns, a tail) at the frames this returns. +import { rgb } from '../../../structures/mesh'; +import type { Vec } from '../../flat'; +import { alongY, axis, both, through, type Paint, type Sculpt } from '../../sculpt'; + +/** The poses: it stands with its head up, it grazes, it lies with its legs folded. */ +export const STAND = 0, GRAZE = 1, LIE = 2; +export const EYE = rgb('#1c1614'), HOOF = rgb('#2c2420'), NOSE = rgb('#3a2e2a'), HORN = rgb('#e2d6b8'), PINK = rgb('#d8a79a'), CREAM = rgb('#e4d8c2'); +export const X: Vec = [1, 0, 0]; + +/** A pair of legs: x and y of the feet, the top inside the trunk, the half-width of the thigh and of the bone. */ +export interface Leg { x: number; y: number; top: number; thigh: number; bone: number } + +export interface Body { + /** Rows of [y, z, half-width, up, down] from the rump to the chest. */ + trunk: number[][]; + sides?: number; + wool?: number; + neck: { + /** [y, z] of its root in the chest. */ + at: number[]; + length: number; + /** Rows of [half-width, up, down] from the root to the head, spread evenly. */ + size: number[][]; + /** For each pose, the pitch of the neck at its root and at the head. */ + carry: number[][]; + }; + head: { + /** Rows of [d, half-width, up, down] from the poll to the nose. */ + rows: number[][]; + /** The pitch of the head for each pose. */ + nod: number[]; + /** How far the poll sits behind and above the end of the neck. */ + set?: number[]; + }; + front: Leg; + hind: Leg; +} + +export interface Coat { + trunk: Paint | number; + neck: Paint | number; + /** From how far along the head a band ends (0 to 1; the front cap is 2) and how far up its facet looks. */ + head: (d: number, top: number) => number; + /** The thigh, the shin and the hoof; the front pair when `front`. */ + leg: (front: boolean) => number[]; +} + +/** How deep a lying trunk sinks into the grass. */ +const SINK = 0.03; +/** The longest leg that folds at its full length: a longer one would stand out over the lying trunk. */ +const LONGEST_FOLD = 0.64; +const mix = (rows: number[][], t: number) => { + const at = t * (rows.length - 1), i = Math.min(rows.length - 2, Math.floor(at)); + return rows[i].map((v, k) => v + (rows[i + 1][k] - v) * (at - i)); +}; + +/** + * Builds the body and returns its frames: `head` (an axis from the poll), `crown(d, v)` (an axis from there on the head + * that is level when the animal stands: horns hang from it), `neck(t, v)` (the point v above the neck at its share t), + * `body` (a point of the standing trunk in this pose), `lies`. + */ +export function quadruped(s: Sculpt, b: Body, pose: number, coat: Coat) { + const lies = pose === LIE, far = s.tier > 0; + const drop = lies ? Math.min(...b.trunk.slice(1, -1).map(([, z, , , down]) => z - down)) + SINK : 0; + const body = ([x, y, z]: number[]): Vec => [x, y, z - drop]; + s.skin(alongY(b.trunk.map(([y, z, ...size]) => [y, z - drop, ...size])), b.sides ?? 10, coat.trunk, b.wool); + + const n = far ? 2 : 3, [from, to] = b.neck.carry[pose], bones: Vec[] = [[0, b.neck.at[0], b.neck.at[1] - drop]]; + for (let i = 0; i < n; i++) { + const a = ((from + ((to - from) * (i + 0.5)) / n) * Math.PI) / 180, [, y, z] = bones[i]; + bones.push([0, y + (b.neck.length / n) * Math.cos(a), z + (b.neck.length / n) * Math.sin(a)]); + } + const rings = through(bones, bones.map((_, i) => mix(b.neck.size, i / n))); + s.skin(rings, 8, coat.neck); + const neck = (t: number, v = 0, x = 0): Vec => { + const i = Math.min(n - 1, Math.floor(t * n)), k = t * n - i, p = (rings[i].pitch + (rings[i + 1].pitch - rings[i].pitch) * k) * (Math.PI / 180); + return [x, bones[i][1] + (bones[i + 1][1] - bones[i][1]) * k - Math.sin(p) * v, bones[i][2] + (bones[i + 1][2] - bones[i][2]) * k + Math.cos(p) * v]; + }; + + const nod = b.head.nod[pose], [back, up] = b.head.set ?? [0.1, 0.02], head = axis(axis(bones[n], nod).p(-back, 0, up), nod); + const rows = b.head.rows.filter((_, i, all) => !far || i % 2 === 0 || i === all.length - 1), length = rows[rows.length - 1][0]; + s.skin(head.rings(rows), 8, (band, top) => coat.head(band < 0 ? 0 : band >= rows.length - 1 ? 2 : rows[band + 1][0] / length, top)); + + for (const front of [true, false]) { + const leg = front ? b.front : b.hind, { x, y, thigh, bone } = leg, top = lies ? Math.min(leg.top, LONGEST_FOLD) : leg.top, [upper, lower, hoof] = coat.leg(front), step = 1.13 * bone; + both(side => { + const at = (dx: number, py: number, z: number): Vec => [side * (x + dx), py, z]; + if (!lies) { + const hock = front ? 0 : -0.45 * bone; + const down = [[y, top, thigh, 1.2 * thigh, 1.2 * thigh], [y + hock, 0.56 * top, bone, 1.13 * bone, 1.13 * bone], [y + 0.3 * hock, step + 0.015, 0.87 * bone, 0.93 * bone, 0.93 * bone], + [y + 0.3 * hock, step, 1.07 * bone, 1.2 * bone, 1.13 * bone], [y + 0.3 * hock, 0, 1.13 * bone, 1.33 * bone, 1.2 * bone]].filter((_, i) => !far || i !== 2 && i !== 3); + s.skin(down.map(([py, z, w, fore, aft]) => ({ at: at(0, py, z), w, up: fore, down: aft, pitch: -90, e: 2 })), 6, far ? (band => [upper, upper, lower, lower][band + 1]) : (band => [upper, upper, lower, lower, hoof, hoof][band + 1])); + } else if (front) { + // The folded foreleg: the knee pokes out before the chest, the hoof lies by the elbow. + const fold = [[y - 0.1 * top, 1.6, 1.3, 1.5, 1.6], [y + 0.42 * top, 1.4, 1.2, 1.3, 1.4], [y + 0.5 * top, 1.2, 0.7, 0.8, 0.8]].filter((_, i) => !far || i !== 1); + s.skin(through(fold.map(([py, z]) => at(0, py, z * bone)), fold.map(row => row.slice(2).map(v => v * bone))), 6, lower); + s.fine(() => s.skin(through([at(1.2 * bone, y + 0.02 * top, 0.9 * bone), at(1.2 * bone, y + 0.2 * top, 0.9 * bone)], [[bone, bone, 0.9 * bone], [1.1 * bone, 1.1 * bone, 0.9 * bone]]), 6, hoof)); + } else { + // The haunch on the flank, and the shank along the grass to a hoof beside the belly. + s.skin(through([at(thigh, y - 0.3 * top, 0.3 * top), at(1.1 * thigh, y + 0.02 * top, 0.33 * top), at(thigh, y + 0.36 * top, 0.24 * top)], [[0.6 * thigh, 0.14 * top, 0.14 * top], [1.1 * thigh, 0.33 * top, 0.33 * top], [0.6 * thigh, 0.16 * top, 0.16 * top]]), 6, upper); + s.fine(() => s.skin(through([at(1.6 * thigh, y - 0.26 * top, 1.2 * bone), at(1.8 * thigh, y + 0.45 * top, 1.1 * bone), at(1.8 * thigh, y + 0.62 * top, 1.1 * bone)], [[1.1 * bone, 1.2 * bone, 1.2 * bone], [0.95 * bone, bone, bone], [1.1 * bone, 1.1 * bone, 1.1 * bone]]), 6, band => (band > 0 ? hoof : lower))); + } + }); + } + return { head, neck, body, lies, crown: (d: number, v: number) => axis(head.p(d, 0, v), nod - b.head.nod[STAND]) }; +} + +/** + * A paint from a map of the pelt: one word for each band, its letters the facets from low on the right flank over the + * back to low on the left flank. The belly, and a letter with no colour, take `base`. + */ +export const pelt = (map: string[], colours: Record, base: number): Paint => (band, _, around) => + colours[map[Math.max(0, Math.min(map.length - 1, band))][Math.round(around * 10 + 1) % 10]] ?? base; + +type Head = ReturnType; +/** Both eyes at [d, x, v] of the head: fine details. */ +export const eyes = (s: Sculpt, h: Head, [d, x, v]: number[], size = 0.05) => s.fine(() => both(side => s.box(h.p(d, side * x, v), [0.6 * size, size, size], EYE))); +/** Both ears, leaves from [d, x, v] of the head to their tips. */ +export const ears = (s: Sculpt, h: Head, [d, x, v]: number[], [td, tx, tv]: number[], width: number, colour: number) => + both(side => s.leaf(h.p(d, side * x, v), h.p(td, side * tx, tv), width, 0.6 * width, h.dir, colour)); diff --git a/builder/web/src/lib/trailview/models/animals/brown-cattle.ts b/builder/web/src/lib/trailview/models/animals/brown-cattle.ts index 1dbf28489e..f736715af5 100644 --- a/builder/web/src/lib/trailview/models/animals/brown-cattle.ts +++ b/builder/web/src/lib/trailview/models/animals/brown-cattle.ts @@ -1,30 +1,12 @@ import { rgb } from '../../structures/mesh'; import type { Animal } from '../animals'; -import { shade } from '../flat'; -import { alongY, axis, bands, bellied, both } from '../sculpt'; - -const EYE = rgb('#1c1614'), HOOF = rgb('#2c2420'), HORN = rgb('#e2d6b8'), PINK = rgb('#d8a79a'), CREAM = rgb('#e4d8c2'), NOSE = rgb('#3a2e2a'); +import { cattle } from './body/cattle'; export default { name: 'Brown cattle', latin: 'Bos taurus', height: 1.4, coats: ['#9a7a5c', '#8e4a24', '#ae8250'].map(rgb), - poses: 1, - build(s, coat) { - const h = axis([0, 0.66, 1.0], -30); - s.skin(alongY([[-0.66, 0.74, 0.12, 0.14, 0.14], [-0.56, 0.72, 0.25, 0.25, 0.24], [-0.3, 0.72, 0.31, 0.28, 0.31], [0.05, 0.71, 0.32, 0.28, 0.33], [0.35, 0.73, 0.29, 0.27, 0.3], [0.52, 0.75, 0.22, 0.22, 0.24], [0.6, 0.76, 0.12, 0.13, 0.14]]), 10, bellied(coat, shade(coat, 0.85))); - s.skin(alongY([[0.38, 0.78, 0.2, 0.2, 0.22, 30], [0.74, 0.93, 0.135, 0.14, 0.15, 25]]), 8, coat); - s.skin(h.rings([[0, 0.1, 0.1, 0.1], [0.07, 0.165, 0.15, 0.15], [0.2, 0.17, 0.15, 0.16], [0.34, 0.13, 0.11, 0.13], [0.44, 0.125, 0.1, 0.12], [0.5, 0.09, 0.07, 0.08]]), 8, bands(coat, coat, coat, coat, CREAM, CREAM, NOSE)); - const leg = (y: number, k: number) => [[y, 0.62, 0.1 * k, 0.12 * k, 0.12 * k], [y, 0.36, 0.075, 0.085, 0.085], [y, 0.1, 0.065, 0.07, 0.07], [y, 0.085, 0.08, 0.09, 0.085], [y, 0, 0.085, 0.1, 0.09]]; - for (const [x, y, k] of [[0.17, 0.36, 1], [0.18, -0.42, 1.15]]) both(side => s.skin(leg(y, k).map(([ly, z, w, up, down]) => ({ at: [side * x, ly, z], w, up, down, pitch: -90, e: 2 })), 6, bands(coat, coat, coat, HOOF))); - both(side => { - s.leaf(h.p(0.1, side * 0.13, 0.05), h.p(0.08, side * 0.4, 0), 0.14, 0.05, h.dir, coat); - s.chain([h.p(0.06, side * 0.1, 0.12), h.p(0.05, side * 0.2, 0.2), h.p(0.07, side * 0.22, 0.3)], [0.06, 0.045, 0.015], HORN); - s.fine(() => s.box(h.p(0.21, side * 0.165, 0.05), [0.03, 0.05, 0.05], EYE)); - }); - s.fine(() => s.chain([[0, -0.66, 0.9], [0, -0.75, 0.6], [0, -0.75, 0.42]], [0.04, 0.03, 0.03], coat)); - s.fine(() => s.chain([[0, -0.75, 0.44], [0, -0.75, 0.28]], [0.08, 0.03], NOSE)); - s.fine(() => s.skin(alongY([[-0.25, 0.46, 0.11, 0.13, 0.13, -90], [-0.25, 0.36, 0.09, 0.11, 0.11, -90], [-0.25, 0.33, 0.05, 0.06, 0.06, -90]]), 6, PINK)); - }, + poses: 3, + build: (s, coat, pose) => cattle(s, pose, { coat }), } satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/chamois.ts b/builder/web/src/lib/trailview/models/animals/chamois.ts new file mode 100644 index 0000000000..d681dbd78d --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/chamois.ts @@ -0,0 +1,35 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { both } from '../sculpt'; +import { ears, eyes, HOOF, NOSE, quadruped, X, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.5, 0.79, 0.1, 0.11, 0.11], [-0.42, 0.78, 0.21, 0.2, 0.21], [-0.18, 0.77, 0.26, 0.23, 0.26], [0.1, 0.77, 0.26, 0.23, 0.27], [0.31, 0.78, 0.23, 0.22, 0.24], [0.43, 0.8, 0.16, 0.17, 0.18], [0.5, 0.81, 0.08, 0.09, 0.1]], + neck: { at: [0.32, 0.86], length: 0.32, size: [[0.16, 0.18, 0.19], [0.115, 0.125, 0.13]], carry: [[66, 58], [-35, -60], [66, 56]] }, + head: { rows: [[0, 0.08, 0.085, 0.085], [0.06, 0.135, 0.125, 0.125], [0.18, 0.14, 0.125, 0.13], [0.31, 0.1, 0.09, 0.1], [0.39, 0.09, 0.075, 0.085], [0.43, 0.06, 0.05, 0.055]], nod: [-24, -75, -20], set: [0.05, 0.09] }, + front: { x: 0.13, y: 0.29, top: 0.62, thigh: 0.08, bone: 0.052 }, + hind: { x: 0.135, y: -0.35, top: 0.62, thigh: 0.092, bone: 0.052 }, +}; +const HORN = rgb('#231d1a'), FACE = rgb('#eadfc8'); + +export default { + name: 'Chamois', + latin: 'Rupicapra rupicapra', + height: 0.78, + // The dark coat of winter, the brown of autumn, the fawn of summer. + coats: ['#5c463a', '#6e5038', '#9c7448'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const dark = shade(coat, 0.5); + const q = quadruped(s, BODY, pose, { + trunk: (band, top) => (band < 0 ? FACE : top < -0.6 ? shade(FACE, 0.9) : top > 0.9 ? dark : coat), neck: (_, top) => (top < -0.6 ? FACE : coat), + // A pale face with a dark stripe from the ear through the eye to the nose. + head: (d, top) => (d > 1 ? NOSE : d < 0.2 ? coat : Math.abs(top) < 0.3 ? dark : FACE), leg: () => [coat, shade(coat, 0.6), HOOF], + }), h = q.head, k = q.crown(0.07, 0.1); + ears(s, h, [0.1, 0.1, 0.03], [0.02, 0.24, 0.16], 0.09, coat); + eyes(s, h, [0.19, 0.125, 0.045], 0.045); + both(side => s.chain([k.p(0, side * 0.045, 0), k.p(0.03, side * 0.06, 0.2), k.p(-0.02, side * 0.075, 0.28), k.p(-0.08, side * 0.085, 0.24)], [0.048, 0.04, 0.032, 0.012], HORN)); + s.leaf(q.body([0, -0.44, 0.9]), q.body([0, -0.55, 0.82]), 0.08, 0.05, X, dark); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/dairy-cattle.ts b/builder/web/src/lib/trailview/models/animals/dairy-cattle.ts new file mode 100644 index 0000000000..7fc30fd06f --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/dairy-cattle.ts @@ -0,0 +1,19 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { cattle } from './body/cattle'; +import { pelt, PINK } from './body/quadruped'; + +const WHITE = rgb('#e9e6de'), BLACK = rgb('#1e1c1b'); + +export default { + name: 'Dairy cattle', + latin: 'Bos taurus', + height: 1.45, + // A black fore and rump with a white girth; a black saddle with a white rump. + coats: [['..BBBB..', '..BBBBB.', '...BBBB.', '........', '.BBBBBB.', '.BBBBBB.'], ['........', '...BB...', '.BBBBBB.', '.BBBBB..', '....BBB.', '.BBBBBB.']], + poses: 3, + build: (s, map, pose) => cattle(s, pose, { + coat: WHITE, trunk: pelt(map, { B: BLACK }, WHITE), neck: BLACK, ear: BLACK, tuft: WHITE, horns: false, + head: (d, top) => (d > 0.9 ? PINK : top > 0.5 && d > 0.3 ? WHITE : BLACK), + }), +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/donkey.ts b/builder/web/src/lib/trailview/models/animals/donkey.ts new file mode 100644 index 0000000000..f6653b4ea7 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/donkey.ts @@ -0,0 +1,36 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { ears, eyes, quadruped, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.6, 0.78, 0.1, 0.12, 0.12], [-0.52, 0.76, 0.23, 0.22, 0.22], [-0.28, 0.75, 0.28, 0.24, 0.26], [0.04, 0.74, 0.29, 0.24, 0.28], [0.3, 0.76, 0.25, 0.23, 0.25], [0.45, 0.78, 0.19, 0.2, 0.21], [0.52, 0.79, 0.1, 0.11, 0.12]], + neck: { at: [0.36, 0.82], length: 0.44, size: [[0.17, 0.2, 0.22], [0.12, 0.15, 0.16], [0.105, 0.13, 0.13]], carry: [[42, 30], [-28, -52], [48, 36]] }, + head: { rows: [[0, 0.085, 0.09, 0.09], [0.07, 0.14, 0.135, 0.135], [0.21, 0.145, 0.135, 0.145], [0.37, 0.115, 0.1, 0.12], [0.48, 0.11, 0.09, 0.11], [0.53, 0.08, 0.06, 0.075]], nod: [-42, -70, -35], set: [0.08, 0.04] }, + front: { x: 0.14, y: 0.33, top: 0.66, thigh: 0.085, bone: 0.055 }, + hind: { x: 0.15, y: -0.42, top: 0.66, thigh: 0.1, bone: 0.055 }, +}; +const PALE = rgb('#ddd4c4'); + +export default { + name: 'Donkey', + latin: 'Equus asinus', + height: 1.1, + coats: ['#9a958e', '#8a705a', '#6c6058'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const dark = shade(coat, 0.45); + const q = quadruped(s, BODY, pose, { + // A pale belly, and the dark stripe of the back. + trunk: (_, top) => (top < -0.6 ? PALE : top > 0.9 ? shade(coat, 0.7) : coat), neck: coat, + head: d => (d > 1 ? shade(PALE, 0.75) : d > 0.8 ? PALE : coat), leg: () => [coat, coat, rgb('#2a2624')], + }), h = q.head; + // Long ears, with a pale ring round each eye. + ears(s, h, [0.06, 0.08, 0.1], [-0.06, 0.17, 0.42], 0.13, coat); + s.fine(() => [-1, 1].forEach(side => s.box(h.p(0.21, side * 0.14, 0.05), [0.03, 0.085, 0.085], PALE))); + eyes(s, h, [0.21, 0.15, 0.05]); + s.chain([q.neck(0.15, 0.2), q.neck(0.55, 0.17), q.neck(0.98, 0.15)], [0.06, 0.07, 0.06], dark); + s.fine(() => s.chain([[0, -0.6, 0.9], [0, -0.7, 0.7], [0, -0.71, 0.48]].map(q.body), [0.045, 0.04, 0.04], coat)); + s.chain([q.body([0, -0.71, 0.5]), q.body([0, -0.7, 0.28])], [0.09, 0.04], dark); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/dromedary.ts b/builder/web/src/lib/trailview/models/animals/dromedary.ts new file mode 100644 index 0000000000..c56ab846fa --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/dromedary.ts @@ -0,0 +1,30 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { alongY, bellied } from '../sculpt'; +import { ears, eyes, quadruped, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.6, 0.88, 0.09, 0.1, 0.1], [-0.52, 0.86, 0.2, 0.15, 0.18], [-0.28, 0.85, 0.25, 0.17, 0.22], [0.04, 0.84, 0.26, 0.17, 0.25], [0.32, 0.85, 0.23, 0.16, 0.25], [0.48, 0.85, 0.17, 0.14, 0.2], [0.56, 0.85, 0.09, 0.09, 0.12]], + neck: { at: [0.42, 0.78], length: 0.86, size: [[0.15, 0.17, 0.2], [0.1, 0.11, 0.13], [0.085, 0.09, 0.1], [0.08, 0.085, 0.09]], carry: [[8, 92], [-50, -20], [30, 95]] }, + head: { rows: [[0, 0.075, 0.075, 0.075], [0.06, 0.125, 0.11, 0.11], [0.18, 0.125, 0.11, 0.115], [0.32, 0.1, 0.075, 0.1], [0.43, 0.095, 0.065, 0.095], [0.47, 0.065, 0.045, 0.065]], nod: [-12, -50, -10], set: [0.1, -0.02] }, + front: { x: 0.14, y: 0.36, top: 0.8, thigh: 0.085, bone: 0.052 }, + hind: { x: 0.14, y: -0.42, top: 0.8, thigh: 0.1, bone: 0.052 }, +}; + +export default { + name: 'Dromedary', + latin: 'Camelus dromedarius', + height: 1.85, + coats: ['#c9a877', '#b08d60', '#dcc6a0'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const dark = shade(coat, 0.8); + const q = quadruped(s, BODY, pose, { trunk: bellied(coat, shade(coat, 0.88)), neck: coat, head: d => (d > 1 ? shade(coat, 0.6) : coat), leg: () => [coat, coat, shade(coat, 0.7)] }), h = q.head; + const [, , top] = q.body([0, 0, 0.98]); + s.skin(alongY([[-0.46, top - 0.02, 0.1, 0.05, 0.1], [-0.3, top + 0.03, 0.2, 0.15, 0.12], [-0.1, top + 0.05, 0.22, 0.21, 0.14], [0.1, top + 0.03, 0.18, 0.14, 0.12], [0.26, top - 0.02, 0.09, 0.05, 0.1]]), 8, (_, up) => (up > 0.9 ? dark : coat)); + ears(s, h, [0.06, 0.09, 0.05], [0.0, 0.17, 0.12], 0.07, coat); + eyes(s, h, [0.17, 0.11, 0.04], 0.045); + s.fine(() => s.chain([[0, -0.6, 0.94], [0, -0.68, 0.74], [0, -0.67, 0.56]].map(q.body), [0.04, 0.035, 0.05], dark)); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/goat.ts b/builder/web/src/lib/trailview/models/animals/goat.ts new file mode 100644 index 0000000000..5c12efdd3c --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/goat.ts @@ -0,0 +1,41 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { both } from '../sculpt'; +import { ears, eyes, HOOF, NOSE, quadruped, X, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.52, 0.76, 0.11, 0.11, 0.11], [-0.44, 0.75, 0.22, 0.22, 0.22], [-0.2, 0.74, 0.28, 0.25, 0.28], [0.1, 0.74, 0.28, 0.25, 0.29], [0.33, 0.75, 0.24, 0.24, 0.26], [0.45, 0.77, 0.16, 0.18, 0.19], [0.52, 0.78, 0.08, 0.09, 0.1]], + neck: { at: [0.35, 0.83], length: 0.33, size: [[0.16, 0.18, 0.19], [0.12, 0.13, 0.13]], carry: [[58, 50], [-35, -60], [60, 50]] }, + head: { rows: [[0, 0.085, 0.085, 0.085], [0.07, 0.145, 0.135, 0.135], [0.2, 0.15, 0.135, 0.14], [0.34, 0.105, 0.095, 0.105], [0.43, 0.095, 0.085, 0.095], [0.47, 0.065, 0.055, 0.06]], nod: [-30, -75, -25], set: [0.06, 0.1] }, + front: { x: 0.14, y: 0.31, top: 0.58, thigh: 0.08, bone: 0.056 }, + hind: { x: 0.14, y: -0.37, top: 0.58, thigh: 0.092, bone: 0.056 }, +}; +const HORN = rgb('#8a7a64'); + +interface Coat { fore: string; rear: string; under: string; shin: string; muzzle: string } + +export default { + name: 'Goat', + latin: 'Capra hircus', + height: 0.8, + // A black neck with a white rear; a dark brown; a chamois brown with dark legs; a white. + coats: [ + { fore: '#2e241e', rear: '#ece4d4', under: '', shin: '', muzzle: '#2e241e' }, + { fore: '#4a3a2e', rear: '#4a3a2e', under: '#7a6048', shin: '#33271f', muzzle: '#8a6e54' }, + { fore: '#87482a', rear: '#87482a', under: '#e6dccb', shin: '#2e241e', muzzle: '#e6dccb' }, + { fore: '#ece4d4', rear: '#ece4d4', under: '#e0d6c2', shin: '#ece4d4', muzzle: '#e2c8bc' }, + ] as Coat[], + poses: 3, + build(s, coat, pose) { + const [fore, rear] = [coat.fore, coat.rear].map(hex => rgb(hex)), under = coat.under ? rgb(coat.under) : 0, muzzle = rgb(coat.muzzle); + const q = quadruped(s, BODY, pose, { + trunk: (band, top) => (under && top < -0.6 ? under : band < 3 ? rear : fore), neck: fore, head: d => (d > 1 ? NOSE : d > 0.7 ? muzzle : fore), + leg: front => { const c = front ? fore : rear; return [c, coat.shin ? rgb(coat.shin) : c, HOOF]; }, + }), h = q.head, k = q.crown(0.05, 0.1); + ears(s, h, [0.11, 0.1, 0.04], [0.07, 0.34, -0.01], 0.11, fore); + both(side => s.chain([k.p(0, side * 0.07, 0), k.p(-0.03, side * 0.09, 0.14), k.p(-0.12, side * 0.11, 0.24), k.p(-0.23, side * 0.14, 0.27)], [0.06, 0.05, 0.035, 0.012], HORN)); + eyes(s, h, [0.2, 0.135, 0.05]); + s.leaf(h.p(0.35, 0, -0.08), h.p(0.32, 0, -0.3), 0.08, 0.05, X, muzzle); + s.leaf(q.body([0, -0.44, 0.9]), q.body([0, -0.6, 1.08]), 0.09, 0.05, X, rear); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/highland-cow.ts b/builder/web/src/lib/trailview/models/animals/highland-cow.ts new file mode 100644 index 0000000000..6bd0d051f0 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/highland-cow.ts @@ -0,0 +1,32 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { bellied, both } from '../sculpt'; +import { ears, HOOF, HORN, NOSE, quadruped, type Body } from './body/quadruped'; + +// A low, wide trunk under long hair that hangs to the knees. +const BODY: Body = { + trunk: [[-0.64, 0.7, 0.14, 0.16, 0.16], [-0.54, 0.68, 0.3, 0.29, 0.3], [-0.28, 0.67, 0.37, 0.32, 0.37], [0.06, 0.67, 0.38, 0.33, 0.39], [0.36, 0.69, 0.35, 0.31, 0.36], [0.54, 0.71, 0.26, 0.25, 0.28], [0.62, 0.72, 0.14, 0.15, 0.16]], + neck: { at: [0.4, 0.74], length: 0.36, size: [[0.25, 0.24, 0.27], [0.18, 0.18, 0.2]], carry: [[18, 12], [-30, -55], [28, 18]] }, + head: { rows: [[0, 0.12, 0.11, 0.11], [0.07, 0.19, 0.17, 0.17], [0.2, 0.19, 0.17, 0.18], [0.33, 0.15, 0.12, 0.14], [0.42, 0.14, 0.11, 0.13], [0.48, 0.1, 0.08, 0.09]], nod: [-34, -72, -28] }, + front: { x: 0.19, y: 0.38, top: 0.56, thigh: 0.12, bone: 0.085 }, + hind: { x: 0.2, y: -0.42, top: 0.56, thigh: 0.135, bone: 0.085 }, +}; + +export default { + name: 'Highland cow', + latin: 'Bos taurus', + height: 1.2, + coats: [['#b3561f', '#e09048'], ['#4a2a1a', '#7a4a2c'], ['#d0ae74', '#efd6a2']].map(pair => pair.map(hex => rgb(hex))), + poses: 3, + build(s, [coat, light], pose) { + const q = quadruped(s, BODY, pose, { trunk: bellied(coat, shade(coat, 0.8)), neck: coat, head: d => (d > 1 ? NOSE : d > 0.8 ? light : coat), leg: () => [coat, coat, HOOF] }), h = q.head; + // The fringe over the eyes, and hair that hangs from the neck and the flanks. + s.skin(h.rings([[-0.04, 0.12, 0.08, 0.06], [0.1, 0.2, 0.14, 0.05], [0.27, 0.15, 0.16, 0.03], [0.34, 0.07, 0.16, 0.02]].map(([d, w, up, down]) => [d, w, up + 0.06, down - 0.06])), 8, light); + s.fine(() => s.leaf(q.neck(0.25, -0.2), q.neck(0.6, -0.42), 0.26, 0.12, [1, 0, 0], shade(coat, 0.9))); + ears(s, h, [0.08, 0.16, 0.0], [0.03, 0.42, -0.08], 0.15, coat); + const k = q.crown(0.07, 0.13); + both(side => s.chain([k.p(0, side * 0.1, 0), k.p(0.02, side * 0.34, 0.03), k.p(0.07, side * 0.56, 0.17), k.p(0.1, side * 0.62, 0.4)], [0.07, 0.06, 0.045, 0.012], HORN)); + s.fine(() => s.chain([[0, -0.64, 0.86], [0, -0.74, 0.55], [0, -0.74, 0.22]].map(q.body), [0.05, 0.05, 0.1], coat)); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/horse.ts b/builder/web/src/lib/trailview/models/animals/horse.ts new file mode 100644 index 0000000000..5c6c303189 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/horse.ts @@ -0,0 +1,33 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { bellied } from '../sculpt'; +import { ears, eyes, quadruped, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.58, 0.8, 0.11, 0.13, 0.13], [-0.5, 0.78, 0.24, 0.23, 0.23], [-0.28, 0.77, 0.28, 0.24, 0.25], [0.02, 0.75, 0.28, 0.23, 0.26], [0.28, 0.77, 0.26, 0.24, 0.26], [0.43, 0.79, 0.2, 0.21, 0.23], [0.51, 0.8, 0.11, 0.12, 0.14]], + neck: { at: [0.33, 0.82], length: 0.58, size: [[0.18, 0.22, 0.26], [0.12, 0.16, 0.17], [0.095, 0.125, 0.115]], carry: [[52, 34], [-25, -50], [55, 40]] }, + head: { rows: [[0, 0.08, 0.09, 0.09], [0.07, 0.135, 0.13, 0.13], [0.22, 0.14, 0.13, 0.14], [0.4, 0.1, 0.09, 0.11], [0.53, 0.095, 0.08, 0.1], [0.58, 0.07, 0.055, 0.065]], nod: [-48, -70, -40], set: [0.08, 0.04] }, + front: { x: 0.14, y: 0.31, top: 0.7, thigh: 0.09, bone: 0.058 }, + hind: { x: 0.15, y: -0.41, top: 0.7, thigh: 0.105, bone: 0.058 }, +}; + +interface Coat { coat: string; hair: string; shin: string; blaze?: boolean } + +export default { + name: 'Horse', + latin: 'Equus caballus', + height: 1.55, + // A bay with a blaze, a chestnut, a grey, a black. + coats: [{ coat: '#7a3e1e', hair: '#1a1512', shin: '#2e1e16', blaze: true }, { coat: '#8a4018', hair: '#6e3014', shin: '#8a4018' }, { coat: '#b8b6b2', hair: '#6e6c6a', shin: '#8e8c8a' }, { coat: '#4a4441', hair: '#1c1a19', shin: '#4a4441' }] as Coat[], + poses: 3, + build(s, c, pose) { + const [coat, hair, shin] = [c.coat, c.hair, c.shin].map(hex => rgb(hex)), dark = shade(coat, 0.6); + const q = quadruped(s, BODY, pose, { trunk: bellied(coat, shade(coat, 0.85)), neck: coat, head: (d, top) => (c.blaze && top > 0.9 && d > 0.3 ? rgb('#ece6da') : d > 0.85 ? dark : coat), leg: () => [coat, shin, rgb('#2a2624')] }), h = q.head; + ears(s, h, [0.05, 0.07, 0.1], [0.02, 0.1, 0.27], 0.09, coat); + eyes(s, h, [0.22, 0.135, 0.05]); + // The mane on the crest, the forelock, the tail. + s.chain([q.neck(0.12, 0.2), q.neck(0.5, 0.17), q.neck(0.95, 0.15), h.p(0.14, 0, 0.15)], [0.09, 0.11, 0.1, 0.06], hair); + s.chain([[0, -0.56, 0.9], [0, -0.7, 0.74], [0, -0.74, 0.42], [0, -0.7, 0.22]].map(q.body), [0.07, 0.12, 0.13, 0.05], hair); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/ibex.ts b/builder/web/src/lib/trailview/models/animals/ibex.ts new file mode 100644 index 0000000000..d8a49423de --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/ibex.ts @@ -0,0 +1,41 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { bellied, both } from '../sculpt'; +import { ears, eyes, HOOF, NOSE, quadruped, X, type Body } from './body/quadruped'; + +const BODY: Body = { + trunk: [[-0.56, 0.74, 0.12, 0.13, 0.13], [-0.47, 0.73, 0.25, 0.24, 0.24], [-0.22, 0.72, 0.31, 0.27, 0.3], [0.1, 0.72, 0.32, 0.28, 0.31], [0.36, 0.74, 0.29, 0.26, 0.29], [0.5, 0.76, 0.2, 0.2, 0.22], [0.57, 0.77, 0.1, 0.11, 0.12]], + neck: { at: [0.38, 0.82], length: 0.3, size: [[0.21, 0.22, 0.24], [0.15, 0.16, 0.17]], carry: [[52, 42], [-35, -60], [56, 46]] }, + head: { rows: [[0, 0.095, 0.095, 0.095], [0.07, 0.155, 0.14, 0.14], [0.2, 0.155, 0.14, 0.145], [0.33, 0.115, 0.1, 0.115], [0.42, 0.105, 0.085, 0.1], [0.46, 0.07, 0.06, 0.065]], nod: [-28, -75, -22], set: [0.06, 0.1] }, + front: { x: 0.16, y: 0.34, top: 0.58, thigh: 0.095, bone: 0.065 }, + hind: { x: 0.165, y: -0.4, top: 0.58, thigh: 0.11, bone: 0.065 }, +}; +const HORN = rgb('#6e6152'), RIDGE = rgb('#8c7e6a'); +// The sweep of a horn in the level frame of the crown: [back, up, out, width]. +const SWEEP = [[0, 0, 0.06, 0.09], [0.04, 0.24, 0.09, 0.085], [0.15, 0.45, 0.13, 0.075], [0.31, 0.6, 0.17, 0.06], [0.5, 0.66, 0.21, 0.045], [0.66, 0.6, 0.24, 0.02]]; + +export default { + name: 'Alpine ibex', + latin: 'Capra ibex', + height: 0.9, + coats: ['#8f7a62', '#7a6652', '#a08a6c'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const dark = shade(coat, 0.55), pale = rgb('#d8cdb8'); + const q = quadruped(s, BODY, pose, { trunk: bellied(coat, pale), neck: coat, head: d => (d > 1 ? NOSE : d > 0.7 ? shade(coat, 1.2) : coat), leg: () => [coat, shade(coat, 0.7), HOOF] }), h = q.head, k = q.crown(0.06, 0.11); + ears(s, h, [0.12, 0.12, 0.0], [0.08, 0.33, -0.05], 0.1, coat); + eyes(s, h, [0.2, 0.14, 0.05]); + both(side => { + const at = SWEEP.map(([back, up, out]) => k.p(-back, side * out, up)); + s.chain(at, SWEEP.map(row => row[3]), HORN); + // The knots on the front of the horn. + s.fine(() => [1, 2, 3, 4].forEach(i => [0.15, 0.6].forEach(t => { + const [back, up, out, w] = SWEEP[i].map((v, n) => v + (SWEEP[i + 1][n] - v) * t), turn = Math.atan2(SWEEP[i + 1][1] - SWEEP[i][1], SWEEP[i + 1][0] - SWEEP[i][0]); + s.box(k.p(-back + 0.5 * w * Math.sin(turn), side * out, up + 0.5 * w * Math.cos(turn)), [1.25 * w, 0.045, 0.045], RIDGE); + }))); + }); + s.leaf(h.p(0.33, 0, -0.08), h.p(0.31, 0, -0.24), 0.07, 0.05, X, dark); + s.leaf(q.body([0, -0.48, 0.88]), q.body([0, -0.6, 0.8]), 0.1, 0.05, X, dark); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/pig.ts b/builder/web/src/lib/trailview/models/animals/pig.ts new file mode 100644 index 0000000000..cb2617912d --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/pig.ts @@ -0,0 +1,31 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { bellied, both } from '../sculpt'; +import { eyes, quadruped, type Body } from './body/quadruped'; + +// Lean and long: an arched back over slim legs, a long head that the pig carries low. +const BODY: Body = { + trunk: [[-0.62, 0.64, 0.12, 0.14, 0.14], [-0.53, 0.65, 0.26, 0.27, 0.29], [-0.28, 0.67, 0.31, 0.31, 0.35], [0.06, 0.68, 0.31, 0.32, 0.36], [0.36, 0.67, 0.29, 0.3, 0.34], [0.54, 0.65, 0.23, 0.25, 0.27], [0.62, 0.64, 0.13, 0.15, 0.15]], + neck: { at: [0.44, 0.64], length: 0.28, size: [[0.24, 0.27, 0.24], [0.18, 0.2, 0.18]], carry: [[-4, -8], [-30, -42], [6, 2]] }, + head: { rows: [[0, 0.12, 0.12, 0.11], [0.06, 0.18, 0.17, 0.15], [0.18, 0.165, 0.15, 0.14], [0.32, 0.1, 0.08, 0.095], [0.45, 0.085, 0.07, 0.085], [0.48, 0.08, 0.07, 0.08]], nod: [-20, -42, -12], set: [0.1, 0.03] }, + front: { x: 0.16, y: 0.4, top: 0.5, thigh: 0.09, bone: 0.055 }, + hind: { x: 0.165, y: -0.42, top: 0.5, thigh: 0.11, bone: 0.055 }, +}; +const SNOUT = rgb('#b89a94'); + +export default { + name: 'Iberian pig', + latin: 'Sus scrofa domesticus', + height: 0.75, + // Black, slate, and the dark red of the retinto. + coats: ['#575250', '#6e6864', '#84583f'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const q = quadruped(s, BODY, pose, { trunk: bellied(coat, shade(coat, 0.85)), neck: coat, head: d => (d > 0.95 ? SNOUT : coat), leg: () => [coat, coat, shade(coat, 0.5)] }), h = q.head; + // Ears that flop forward over the eyes. + both(side => s.leaf(h.p(0.05, side * 0.11, 0.14), h.p(0.3, side * 0.22, 0.07), 0.2, 0.07, [0, 0, 1], shade(coat, 0.8))); + eyes(s, h, [0.22, 0.135, 0.03], 0.04); + s.fine(() => s.chain([[0, -0.62, 0.72], [0, -0.7, 0.66], [0, -0.7, 0.54]].map(q.body), [0.04, 0.035, 0.02], coat)); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/red-deer.ts b/builder/web/src/lib/trailview/models/animals/red-deer.ts new file mode 100644 index 0000000000..a31929423a --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/red-deer.ts @@ -0,0 +1,33 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { antlers, DEER } from './body/deer'; +import { ears, eyes, HOOF, NOSE, quadruped, X } from './body/quadruped'; + +const RUMP = rgb('#e2d2b0'), ANTLER = rgb('#a89274'); + +interface Coat { coat: string; stag?: boolean } + +export default { + name: 'Red deer', + latin: 'Cervus elaphus', + height: 1.2, + // A stag among two hinds. + coats: [{ coat: '#96582e', stag: true }, { coat: '#a2673a' }, { coat: '#8c5a34' }] as Coat[], + poses: 3, + build(s, c, pose) { + const coat = rgb(c.coat), dark = shade(coat, 0.7); + const q = quadruped(s, DEER, pose, { + trunk: (band, top) => (band < 1 ? RUMP : top < -0.6 ? shade(coat, 1.25) : coat), neck: c.stag ? dark : coat, + head: d => (d > 1 ? NOSE : d > 0.75 ? shade(coat, 1.3) : coat), leg: () => [coat, shade(coat, 0.85), HOOF], + }), h = q.head; + ears(s, h, [0.08, 0.1, 0.04], [0.0, 0.32, 0.14], 0.13, coat); + eyes(s, h, [0.19, 0.125, 0.045], 0.045); + if (c.stag) { + antlers(s, q.crown(0.06, 0.1), [[0, 0, 0.06], [0.12, 0.22, 0.19], [0.26, 0.44, 0.3], [0.26, 0.68, 0.3]], [[0, -0.2, 0.1, 0.1], [1, -0.1, 0.38, 0.28], [2, 0.42, 0.6, 0.36], [2, 0.12, 0.64, 0.2]], ANTLER); + // The mane of the neck. + s.fine(() => s.leaf(q.neck(0.1, -0.15), q.neck(0.8, -0.17), 0.16, 0.14, X, dark)); + } + s.leaf(q.body([0, -0.5, 0.9]), q.body([0, -0.6, 0.78]), 0.09, 0.05, X, RUMP); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/reindeer.ts b/builder/web/src/lib/trailview/models/animals/reindeer.ts new file mode 100644 index 0000000000..6034f7ad46 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/reindeer.ts @@ -0,0 +1,37 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { antlers, DEER } from './body/deer'; +import { ears, eyes, HOOF, NOSE, quadruped, X, type Body } from './body/quadruped'; + +// A stocky deer on shorter legs that carries its head low. +const BODY: Body = { + ...DEER, + trunk: DEER.trunk.map(([y, z, w, up, down]) => [1.05 * y, z - 0.03, 1.16 * w, up + 0.03, 1.15 * down]), + neck: { at: [0.36, 0.82], length: 0.38, size: [[0.19, 0.2, 0.24], [0.14, 0.15, 0.19], [0.12, 0.13, 0.15]], carry: [[34, 22], [-35, -55], [40, 28]] }, + head: { rows: [[0, 0.085, 0.085, 0.085], [0.06, 0.14, 0.125, 0.125], [0.18, 0.14, 0.125, 0.13], [0.31, 0.11, 0.09, 0.105], [0.4, 0.105, 0.08, 0.095], [0.45, 0.075, 0.055, 0.065]], nod: [-30, -72, -24], set: [0.07, 0.05] }, + front: { x: 0.15, y: 0.32, top: 0.62, thigh: 0.085, bone: 0.055 }, + hind: { x: 0.155, y: -0.4, top: 0.62, thigh: 0.1, bone: 0.055 }, +}; +const PALE = rgb('#ddd5c4'), ANTLER = rgb('#b9a88c'); + +export default { + name: 'Reindeer', + latin: 'Rangifer tarandus', + height: 1.1, + coats: ['#6e5e50', '#857361', '#a39584'].map(hex => rgb(hex)), + poses: 3, + build(s, coat, pose) { + const dark = shade(coat, 0.8); + const q = quadruped(s, BODY, pose, { + trunk: (band, top) => (band < 1 ? PALE : top < -0.6 ? shade(PALE, 0.9) : band > 3 ? shade(coat, 1.15) : coat), neck: PALE, + head: d => (d > 1 ? NOSE : d > 0.75 ? PALE : coat), leg: () => [coat, dark, HOOF], + }), h = q.head; + ears(s, h, [0.09, 0.12, 0.03], [0.04, 0.3, 0.06], 0.1, coat); + eyes(s, h, [0.19, 0.14, 0.045], 0.045); + antlers(s, q.crown(0.06, 0.1), [[0, 0, 0.07], [0.22, 0.24, 0.2], [0.36, 0.52, 0.3], [0.2, 0.78, 0.34], [0.02, 0.86, 0.32]], [[0, -0.2, 0.1, 0.05], [3, 0.28, 0.96, 0.4], [1, 0.34, 0.2, 0.26], [2, 0.5, 0.56, 0.36]], ANTLER, 0.05); + // The mane under the neck. + s.leaf(q.neck(0.15, -0.2), q.neck(0.7, -0.34), 0.2, 0.14, X, PALE); + s.leaf(q.body([0, -0.52, 0.9]), q.body([0, -0.62, 0.8]), 0.09, 0.05, X, PALE); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/sheep.ts b/builder/web/src/lib/trailview/models/animals/sheep.ts new file mode 100644 index 0000000000..4cf700cb2b --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/sheep.ts @@ -0,0 +1,32 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { shade } from '../flat'; +import { axis, bellied } from '../sculpt'; +import { ears, eyes, quadruped, type Body } from './body/quadruped'; + +// Few, large lumps of wool: a trunk through 5 rings. +const BODY: Body = { + trunk: [[-0.56, 0.71, 0.17, 0.16, 0.16], [-0.4, 0.7, 0.35, 0.31, 0.33], [-0.03, 0.69, 0.39, 0.33, 0.36], [0.34, 0.71, 0.34, 0.3, 0.33], [0.5, 0.74, 0.17, 0.16, 0.17]], + wool: 0.05, + neck: { at: [0.34, 0.8], length: 0.3, size: [[0.21, 0.21, 0.21], [0.16, 0.16, 0.16]], carry: [[36, 30], [-30, -55], [42, 34]] }, + head: { rows: [[0, 0.08, 0.08, 0.08], [0.06, 0.13, 0.12, 0.12], [0.18, 0.135, 0.12, 0.12], [0.3, 0.1, 0.09, 0.1], [0.38, 0.09, 0.075, 0.085], [0.42, 0.06, 0.05, 0.055]], nod: [-35, -75, -28], set: [0.09, 0.03] }, + front: { x: 0.17, y: 0.3, top: 0.55, thigh: 0.07, bone: 0.052 }, + hind: { x: 0.17, y: -0.36, top: 0.55, thigh: 0.075, bone: 0.052 }, +}; + +export default { + name: 'Sheep', + latin: 'Ovis aries', + height: 0.8, + // Wool and face: two with a black face, a white one, a brown one. + coats: [['#efe7d6', '#2d2828'], ['#e6dcc6', '#2d2828'], ['#efe9dc', '#dccdb6'], ['#6a5444', '#3a2c26']].map(pair => pair.map(hex => rgb(hex))), + poses: 3, + build(s, [wool, face], pose) { + const q = quadruped(s, BODY, pose, { trunk: bellied(wool, shade(wool, 0.88)), neck: wool, head: () => face, leg: () => [wool, face, shade(face, 0.6)] }), h = q.head; + const cap = axis(h.p(0.09, 0, 0.11), 0); + s.skin(cap.rings([[-0.09, 0.06, 0.04, 0.04], [0, 0.13, 0.08, 0.05], [0.08, 0.07, 0.04, 0.04]]), 8, wool); + ears(s, h, [0.1, 0.1, 0.04], [0.08, 0.31, -0.03], 0.11, face); + eyes(s, h, [0.2, 0.13, 0.04], 0.04); + s.chain([[0, -0.54, 0.82], [0, -0.64, 0.7], [0, -0.66, 0.6]].map(q.body), [0.1, 0.1, 0.04], wool, 5); + }, +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/animals/simmental-cattle.ts b/builder/web/src/lib/trailview/models/animals/simmental-cattle.ts new file mode 100644 index 0000000000..4e7a9f99a9 --- /dev/null +++ b/builder/web/src/lib/trailview/models/animals/simmental-cattle.ts @@ -0,0 +1,17 @@ +import { rgb } from '../../structures/mesh'; +import type { Animal } from '../animals'; +import { cattle } from './body/cattle'; +import { pelt, PINK } from './body/quadruped'; + +const WHITE = rgb('#ece6da'); +// A red back over a white flank and a white chest. +const MAP = ['.RRRRRR.', 'RRRRRRRR', '..RRRRRR', '.RRRRRR.', 'RRRRRRRR', '.RRRRRR.']; + +export default { + name: 'Simmental cattle', + latin: 'Bos taurus', + height: 1.45, + coats: ['#a85428', '#c88e4c'].map(rgb), + poses: 3, + build: (s, red, pose) => cattle(s, pose, { coat: red, trunk: pelt(MAP, { R: red }, WHITE), shin: WHITE, tuft: WHITE, head: (d, top) => (d > 0.9 ? PINK : d < 0.2 && top < 0.5 ? red : WHITE) }), +} satisfies Animal; diff --git a/builder/web/src/lib/trailview/models/sculpt.ts b/builder/web/src/lib/trailview/models/sculpt.ts index 25af71c3a8..4252c83fe7 100644 --- a/builder/web/src/lib/trailview/models/sculpt.ts +++ b/builder/web/src/lib/trailview/models/sculpt.ts @@ -7,8 +7,11 @@ import type { FloatMesh } from './model-file'; /** A ring of a skin: its middle, its half-width, its reach above and below the middle, the pitch of its axis above +y in degrees, and how square it is (2 is an ellipse). */ export interface Ring { at: Vec; w: number; up: number; down: number; pitch: number; e: number } -/** The colour of a face from its band (−1 and the band count are the end caps) and from how far up (−1 to 1) its facet looks. */ -export type Paint = (band: number, top: number) => number; +/** + * The colour of a face from its band (−1 and the band count are the end caps), from how far up (−1 to 1) its facet looks, + * and from its place around the ring: 0 at +x, 0.25 at the top, 0.5 at −x. + */ +export type Paint = (band: number, top: number, around: number) => number; export const sub = (a: Vec, b: Vec): Vec => [a[0] - b[0], a[1] - b[1], a[2] - b[2]]; export const along = (a: Vec, d: Vec, k: number): Vec => [a[0] + d[0] * k, a[1] + d[1] * k, a[2] + d[2] * k]; @@ -36,17 +39,25 @@ export function axis(at: Vec, pitch: number) { return { p, dir: [0, c, s] as Vec, rings: (rows: number[][], e = 2): Ring[] => rows.map(([d, w, up, down]) => ({ at: p(d), w, up, down, pitch, e })) }; } -/** Tier 1 builds a part of n sides with this share of them, at least 3. */ -const FAR_SIDES = 0.4; +/** + * The rings of a part through points of one bend in the y-z plane, each ring square to the path, from rows of + * [half-width, up, down]: a bent neck, a folded leg. + */ +export function through(points: Vec[], rows: number[][], e = 2): Ring[] { + return points.map((at, i) => { + const a = points[Math.max(0, i - 1)], b = points[Math.min(points.length - 1, i + 1)], [w, up, down] = rows[i]; + return { at, w, up, down, pitch: (Math.atan2(b[2] - a[2], b[1] - a[1]) * 180) / Math.PI, e }; + }); +} /** A model in the making, at a tier: 0 near, 1 far. */ export class Sculpt { readonly model = new Model(); constructor(readonly tier = 0) {} - /** Sides of a part that has n at tier 0. */ + /** Sides of a part that has n at tier 0: 4 keep a round part the same at both sides, 3 are enough for a thin one. */ sides(n: number): number { - return this.tier ? Math.max(3, Math.round(n * FAR_SIDES)) : n; + return this.tier ? (n < 8 ? 3 : 4) : n; } /** Fine details, which only tier 0 builds. */ @@ -63,20 +74,23 @@ export class Sculpt { return this; } - /** A skin of `sides` facets (fewer at tier 1) through the rings, its ends closed. `lump` pushes every second point out and the others in, as wool. */ + /** + * A skin of `sides` facets (fewer at tier 1) through the rings, its ends closed; a ring of few sides grows to keep the + * area of its ellipse. `lump` pushes every second point out and the others in, as wool. + */ skin(rings: Ring[], sides: number, paint: Paint | number, lump = 0): this { - const colour: Paint = typeof paint === 'number' ? () => paint : paint, last = rings.length - 1, n = this.sides(sides); + const colour: Paint = typeof paint === 'number' ? () => paint : paint, last = rings.length - 1, n = this.sides(sides), full = Math.sqrt(Math.PI / ((n / 2) * Math.sin((2 * Math.PI) / n))); const points = rings.map((r, i) => Array.from({ length: n }, (_, k): Vec => { - const t = (2 * Math.PI * (k + 0.5)) / n, p = (r.pitch * Math.PI) / 180, swell = i > 0 && i < last ? 1 + lump * ((i + k) % 2 ? 1 : -1) : 1; + const t = (2 * Math.PI * (k + 0.5)) / n, p = (r.pitch * Math.PI) / 180, swell = full * (i > 0 && i < last ? 1 + lump * ((i + k) % 2 ? 1 : -1) : 1); const s = bend(Math.sin(t), r.e), v = s * (s > 0 ? r.up : r.down) * swell; return [r.at[0] + bend(Math.cos(t), r.e) * r.w * swell, r.at[1] - Math.sin(p) * v, r.at[2] + Math.cos(p) * v]; })); for (let i = 0; i < last; i++) for (let k = 0; k < n; k++) { const j = (k + 1) % n; - this.face([points[i][k], points[i][j], points[i + 1][j], points[i + 1][k]], colour(i, Math.sin((2 * Math.PI * (k + 1)) / n)), along(rings[i].at, sub(rings[i + 1].at, rings[i].at), 0.5)); + this.face([points[i][k], points[i][j], points[i + 1][j], points[i + 1][k]], colour(i, Math.sin((2 * Math.PI * (k + 1)) / n), ((k + 1) / n) % 1), along(rings[i].at, sub(rings[i + 1].at, rings[i].at), 0.5)); } - this.face(points[0], colour(-1, 0), rings[1].at); - return this.face(points[last], colour(last, 0), rings[last - 1].at); + this.face(points[0], colour(-1, 0, 0), rings[1].at); + return this.face(points[last], colour(last, 0, 0), rings[last - 1].at); } /** A flat diamond from a to its tip b, `width` across and `thick` along n: an ear, a beard, a short tail. */ @@ -87,9 +101,10 @@ export class Sculpt { return this; } - /** Bars through the points, each `widths` across at its point, of `sides` sides (fewer at tier 1): a horn, a tail. */ + /** Bars through the points, each `widths` across at its point, of `sides` sides: a horn, a tail. Tier 1 has fewer sides and goes through every second point and the last. */ chain(points: Vec[], widths: number[], colour: number, sides = 4): this { - for (let i = 0; i + 1 < points.length; i++) this.model.beam(points[i], points[i + 1], widths[i], colour, { sides: this.sides(sides), w1: widths[i + 1], capped: true }); + const keep = points.map((_, i) => i).filter(i => !this.tier || i % 2 === 0 || i === points.length - 1); + for (let k = 0; k + 1 < keep.length; k++) this.model.beam(points[keep[k]], points[keep[k + 1]], widths[keep[k]], colour, { sides: this.sides(sides), w1: widths[keep[k + 1]], capped: true }); return this; } diff --git a/builder/web/tests/browser/trailview/models.mjs b/builder/web/tests/browser/trailview/models.mjs new file mode 100644 index 0000000000..889934ebc7 --- /dev/null +++ b/builder/web/tests/browser/trailview/models.mjs @@ -0,0 +1,68 @@ +// The model review page: each breed's models in the engine's light, near at tier 0 and close up at tier 1, with the +// triangles and vertices of each tier against the budget, and the models of another build beside them. +// +// node builder/web/tests/browser/trailview/models.mjs [--out DIR] [--before DIR] [--only a,b] [SERVED] +// +// The page must be built (`box.sh` or `npm run build:trailview`), from the same checkout. SERVED are the data +// options of shoot.mjs (--tiles, --ground, --features); the place is a flat meadow of the Engelberg box. --before names +// the folder of another run: its `-near.png` stands beside each breed (today's model, for a change of models). +// Writes DIR/index.html and one PNG per breed and tier; the showroom of dressing.ts stands the animals. + +import { spawnSync } from 'node:child_process'; +import { copyFileSync, existsSync, mkdirSync, writeFileSync } from 'node:fs'; +import { join } from 'node:path'; +import { parseArgs } from 'node:util'; +import { bakeModels } from '../../../vite/model-files.ts'; +import { decodeModels } from '../../../src/lib/trailview/models/model-file.ts'; + +const { values } = parseArgs({ + options: { + out: { type: 'string', default: new URL('../../../../../.artifacts/trailview-models', import.meta.url).pathname }, + before: { type: 'string' }, + only: { type: 'string' }, + tiles: { type: 'string' }, + ground: { type: 'string' }, + features: { type: 'string' }, + }, +}); +/** The showroom's middle, the eye's heading toward it, and the page; SHOW_SPACING of dressing.ts. */ +const PLACE = [46.820416, 8.403045], HEADING = 160, WIDTH = 1600, HEIGHT = 640, SPACING = 2.3; +/** The budget of models/bake.ts, per tier: triangles and vertices. */ +const BUDGET = [[1000, 3000], [250, 750]]; + +const { baked } = await bakeModels(); +const only = values.only?.split(','); +const breeds = Object.entries(baked.models.breeds).filter(([name]) => !only || only.includes(name)); +mkdirSync(values.out, { recursive: true }); + +// The eye stands far enough before the row to see all of it. +const views = breeds.flatMap(([name, { height, coats, poses }]) => { + const distance = Math.max(6, (0.5 * coats * poses * SPACING * height) / 1.1), a = (HEADING * Math.PI) / 180; + const lat = PLACE[0] - (distance * Math.cos(a)) / 111320, lon = PLACE[1] - (distance * Math.sin(a)) / (111320 * Math.cos((PLACE[0] * Math.PI) / 180)); + const view = (tier) => `?lat=${lat.toFixed(7)}&lon=${lon.toFixed(7)}&heading=${HEADING}&pitch=-6&eye=1.6&date=2026-08-15&time=15:00&weather=sunny&showroom=${PLACE.join(',')},${HEADING},${name},${tier}`; + return [{ name: `${name}-near`, view: view(0) }, { name: `${name}-tier1`, view: view(1) }]; +}); +writeFileSync(join(values.out, 'views.json'), JSON.stringify(views)); +const served = ['tiles', 'ground', 'features'].flatMap(key => (values[key] ? [`--${key}`, values[key]] : [])); +const shot = spawnSync(process.execPath, [new URL('./shoot.mjs', import.meta.url).pathname, '--gpu', '--views', join(values.out, 'views.json'), '--out', values.out, '--width', `${WIDTH}`, '--height', `${HEIGHT}`, ...served], { stdio: 'inherit' }); +if (shot.status !== 0) process.exit(shot.status ?? 1); + +const rows = []; +for (const [name, { height, coats, poses, file }] of breeds) { + const models = await decodeModels(baked.files.get(file)); + const counts = models.map(({ tiers }, k) => `${k}: coat ${Math.floor(k / poses)}, pose ${k % poses}${tiers.map(({ vertices, index }, t) => { + const tris = index.length / 3, verts = vertices.length / 16, over = tris > BUDGET[t][0] || verts > BUDGET[t][1]; + return `${tris} / ${BUDGET[t][0]}${verts} / ${BUDGET[t][1]}`; + }).join('')}`).join(''); + const before = values.before && join(values.before, `${name}-near.png`); + if (before && existsSync(before)) copyFileSync(before, join(values.out, `${name}-before.png`)); + rows.push(`

${name}

${height} m to the back, ${coats} coats × ${poses} poses, ${baked.files.get(file).length} bytes

+${before && existsSync(before) ? `
Before
` : ''} +
Tier 0, to 150 m
+
Tier 1, to 1,500 m, drawn close
+${counts}
ModelTier 0 trianglesTier 0 verticesTier 1 trianglesTier 1 vertices
`); +} +writeFileSync(join(values.out, 'index.html'), `TrailView models + +

TrailView models

${rows.join('\n')}`); +console.log(join(values.out, 'index.html')); diff --git a/builder/web/vite/model-files.ts b/builder/web/vite/model-files.ts index edf2376765..98c48ef318 100644 --- a/builder/web/vite/model-files.ts +++ b/builder/web/vite/model-files.ts @@ -22,7 +22,7 @@ const MARK = /"@@model-file:([\w-]+)@@"/g; const SOURCES = path.join(ROOT, "src/lib/trailview"); /** The files and the models, and the files of the modules in the bundle. */ -async function bakeModels(): Promise<{ baked: Baked; modules: string[] }> { +export async function bakeModels(): Promise<{ baked: Baked; modules: string[] }> { const out = await build({ configFile: false, root: ROOT, logLevel: "silent", ssr: { noExternal: true }, build: { ssr: ENTRY, write: false, minify: false, rollupOptions: { output: { inlineDynamicImports: true } } }, From 3c3c4a5d58c947651057bd387bd8102616b4c91d Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 01:14:42 +0100 Subject: [PATCH 3/7] trailview: herds of ibex, chamois, deer, reindeer, pig, donkey, dromedary and horses draw their own models Co-Authored-By: Claude Opus 5.5 --- data/trailview/packs/alps.json | 4 ++-- data/trailview/packs/apennines.json | 2 +- data/trailview/packs/caledon.json | 4 ++-- data/trailview/packs/canaries-east.json | 2 +- data/trailview/packs/corsica.json | 2 +- data/trailview/packs/fjell.json | 2 +- data/trailview/packs/iberia.json | 2 +- data/trailview/packs/iberian-conifer.json | 2 +- data/trailview/packs/iceland.json | 2 +- data/trailview/packs/illyria.json | 2 +- data/trailview/packs/kola.json | 2 +- data/trailview/packs/norway-coast.json | 2 +- data/trailview/packs/nw-iberia.json | 2 +- data/trailview/packs/pyrenees.json | 2 +- data/trailview/packs/south-apennines.json | 2 +- data/trailview/packs/sw-iberia.json | 2 +- data/trailview/packs/tyrrhenian.json | 4 ++-- specs/trailview-models.md | 4 ++-- 18 files changed, 22 insertions(+), 22 deletions(-) diff --git a/data/trailview/packs/alps.json b/data/trailview/packs/alps.json index 86f360168d..046dae11e6 100644 --- a/data/trailview/packs/alps.json +++ b/data/trailview/packs/alps.json @@ -35,8 +35,8 @@ "simmental-cattle": { "groups": 1, "size": [3, 12], "on": ["pasture", "grassland"] }, "alpine-sheep": { "model": "sheep", "latin": "Ovis aries (White Alpine)", "groups": 1, "size": [10, 40], "on": ["rough-grass", "heath"] }, "goat": { "groups": 1, "size": [3, 10], "on": ["rough-grass", "scrub", "heath"] }, - "chamois": { "model": "goat", "latin": "Rupicapra rupicapra", "groups": 1, "size": [1, 5], "on": ["scree", "bare-rock"] }, - "alpine-ibex": { "model": "goat", "latin": "Capra ibex", "groups": 1, "size": [2, 6], "on": ["bare-rock", "scree"] } + "chamois": { "latin": "Rupicapra rupicapra", "groups": 1, "size": [1, 5], "on": ["scree", "bare-rock"] }, + "alpine-ibex": { "model": "ibex", "latin": "Capra ibex", "groups": 1, "size": [2, 6], "on": ["bare-rock", "scree"] } }, "rows": { "orchard": "hawthorn" }, "style": { "si": "black-forest-farmhouse", "it-21": "slate-stone-house", "it-23": "slate-stone-house", "it-25": "slate-stone-house", "ch-ti": "slate-stone-house", "fr-pac": "slate-stone-house", "de-by": "bavarian-chalet", "at": "bavarian-chalet", "*": "chalet" } diff --git a/data/trailview/packs/apennines.json b/data/trailview/packs/apennines.json index 64d1e61d1d..fa202f0744 100644 --- a/data/trailview/packs/apennines.json +++ b/data/trailview/packs/apennines.json @@ -36,7 +36,7 @@ "cattle": { "model": "highland-cow", "latin": "Bos taurus (Marchigiana)", "groups": 2, "size": [4, 15], "on": ["pasture", "grassland", "arable"] }, "horse": { "groups": 2, "size": [3, 12], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "goat": { "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, - "pyrenean-chamois": { "model": "goat", "latin": "Rupicapra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse", "rough-grass", "wet-grassland", "grassland"] } + "pyrenean-chamois": { "model": "chamois", "latin": "Rupicapra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse", "rough-grass", "wet-grassland", "grassland"] } }, "style": { "it-45": "slate-stone-house", "it-52": "slate-stone-house", "*": "stone-house" } } diff --git a/data/trailview/packs/caledon.json b/data/trailview/packs/caledon.json index f5218b376e..f3a4b35c99 100644 --- a/data/trailview/packs/caledon.json +++ b/data/trailview/packs/caledon.json @@ -36,11 +36,11 @@ "foxglove": { "model": "alpine-flowers", "latin": "Digitalis purpurea", "on": ["grass", "shrub"], "height": [0.8, 1.5], "share": 0.03, "clumped": true } }, "herds": { - "red-deer": { "model": "goat", "latin": "Cervus elaphus", "groups": 3, "size": [4, 25], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, + "red-deer": { "latin": "Cervus elaphus", "groups": 3, "size": [4, 25], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, "sheep": { "groups": 4, "size": [3, 20], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "heath"] }, "highland-cow": { "groups": 1, "size": [2, 8], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "aberdeen-angus": { "model": "highland-cow", "latin": "Bos taurus (Aberdeen Angus)", "groups": 2, "size": [5, 20], "on": ["pasture", "grassland", "arable"] }, - "highland-pony": { "model": "highland-cow", "latin": "Equus caballus (Highland)", "groups": 1, "size": [1, 4], "on": ["pasture", "grassland", "arable"] } + "highland-pony": { "model": "horse", "latin": "Equus caballus (Highland)", "groups": 1, "size": [1, 4], "on": ["pasture", "grassland", "arable"] } }, "style": "highland-cottage" } diff --git a/data/trailview/packs/canaries-east.json b/data/trailview/packs/canaries-east.json index fde4ca1a79..f197ac61bc 100644 --- a/data/trailview/packs/canaries-east.json +++ b/data/trailview/packs/canaries-east.json @@ -19,7 +19,7 @@ }, "herds": { "goat": { "groups": 2, "size": [5, 25], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, - "dromedary": { "model": "highland-cow", "latin": "Camelus dromedarius", "groups": 1, "size": [2, 8], "on": ["scrub", "sclerophyllous-scrub", "rough-grass", "wet-grassland", "grassland"] } + "dromedary": { "latin": "Camelus dromedarius", "groups": 1, "size": [2, 8], "on": ["scrub", "sclerophyllous-scrub", "rough-grass", "wet-grassland", "grassland"] } }, "style": "canarian-house" } diff --git a/data/trailview/packs/corsica.json b/data/trailview/packs/corsica.json index 4e21ffeb27..cc0205928a 100644 --- a/data/trailview/packs/corsica.json +++ b/data/trailview/packs/corsica.json @@ -27,7 +27,7 @@ }, "herds": { "cattle": { "model": "brown-cattle", "groups": 2, "size": [3, 10], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "scrub", "sclerophyllous-scrub"] }, - "iberian-pig": { "model": "goat", "latin": "Sus scrofa domesticus", "groups": 2, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] }, + "iberian-pig": { "model": "pig", "latin": "Sus scrofa domesticus", "groups": 2, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] }, "goat": { "groups": 2, "size": [5, 20], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "sheep": { "groups": 2, "size": [10, 40], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "horse": { "groups": 1, "size": [2, 8], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, diff --git a/data/trailview/packs/fjell.json b/data/trailview/packs/fjell.json index e96b72feef..a218d04c7b 100644 --- a/data/trailview/packs/fjell.json +++ b/data/trailview/packs/fjell.json @@ -24,7 +24,7 @@ "grass": { "off": ["#moor"] } }, "herds": { - "reindeer": { "model": "goat", "latin": "Rangifer tarandus", "groups": 3, "size": [3, 12], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, + "reindeer": { "latin": "Rangifer tarandus", "groups": 3, "size": [3, 12], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, "sheep": { "groups": 3, "size": [2, 6], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "heath"] } }, "style": "falu-red-house", diff --git a/data/trailview/packs/iberia.json b/data/trailview/packs/iberia.json index 1f93640690..a70801626d 100644 --- a/data/trailview/packs/iberia.json +++ b/data/trailview/packs/iberia.json @@ -23,7 +23,7 @@ }, "herds": { "sheep": { "groups": 2, "size": [15, 60], "on": ["pasture", "grassland", "arable"] }, - "iberian-pig": { "model": "goat", "latin": "Sus scrofa domesticus", "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland"] }, + "iberian-pig": { "model": "pig", "latin": "Sus scrofa domesticus", "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland"] }, "cattle": { "model": "brown-cattle", "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland"] }, "goat": { "groups": 1, "size": [8, 30], "on": ["scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] } }, diff --git a/data/trailview/packs/iberian-conifer.json b/data/trailview/packs/iberian-conifer.json index 84f30de2ab..c42b6e936c 100644 --- a/data/trailview/packs/iberian-conifer.json +++ b/data/trailview/packs/iberian-conifer.json @@ -34,7 +34,7 @@ "goat": { "groups": 1, "size": [8, 30], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "cattle": { "model": "brown-cattle", "groups": 2, "size": [4, 15], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "horse": { "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "heath", "pasture", "arable"] }, - "iberian-ibex": { "model": "goat", "latin": "Capra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse"] } + "iberian-ibex": { "model": "ibex", "latin": "Capra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse"] } }, "rows": { "orchard": "hawthorn" }, "style": "village-house" diff --git a/data/trailview/packs/iceland.json b/data/trailview/packs/iceland.json index be10c1f1d6..748ba5a58a 100644 --- a/data/trailview/packs/iceland.json +++ b/data/trailview/packs/iceland.json @@ -26,7 +26,7 @@ }, "herds": { "icelandic-sheep": { "model": "sheep", "latin": "Ovis aries (Icelandic)", "groups": 5, "size": [2, 4], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "heath", "bog"] }, - "icelandic-horse": { "model": "highland-cow", "latin": "Equus caballus (Icelandic)", "groups": 2, "size": [3, 12], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, + "icelandic-horse": { "model": "horse", "latin": "Equus caballus (Icelandic)", "groups": 2, "size": [3, 12], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "icelandic-cattle": { "model": "highland-cow", "latin": "Bos taurus (Icelandic)", "groups": 1, "size": [3, 10], "on": ["pasture", "grassland", "arable"] } }, "style": "cottage" diff --git a/data/trailview/packs/illyria.json b/data/trailview/packs/illyria.json index 5edcb07ea8..37c3f297b0 100644 --- a/data/trailview/packs/illyria.json +++ b/data/trailview/packs/illyria.json @@ -44,7 +44,7 @@ "sheep": { "groups": 3, "size": [10, 60], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "goat": { "groups": 3, "size": [4, 20], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "cattle": { "model": "highland-cow", "latin": "Bos taurus (Busha)", "groups": 1, "size": [2, 8], "on": ["pasture", "grassland", "arable"] }, - "donkey": { "model": "highland-cow", "latin": "Equus asinus", "groups": 1, "size": [1, 3], "on": ["rough-grass", "wet-grassland", "grassland", "pasture", "arable"] } + "donkey": { "latin": "Equus asinus", "groups": 1, "size": [1, 3], "on": ["rough-grass", "wet-grassland", "grassland", "pasture", "arable"] } }, "rows": { "orchard": "almond" }, "style": { "al": "village-house", "*": "stone-house" } diff --git a/data/trailview/packs/kola.json b/data/trailview/packs/kola.json index e22c4c2c44..d8edb1472b 100644 --- a/data/trailview/packs/kola.json +++ b/data/trailview/packs/kola.json @@ -23,7 +23,7 @@ "lyme-grass": { "model": "esparto", "latin": "Leymus arenarius", "on": ["bare"], "height": [0.5, 1.0], "share": 0.03, "clumped": true } }, "herds": { - "reindeer": { "model": "goat", "latin": "Rangifer tarandus", "groups": 3, "size": [3, 12], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, + "reindeer": { "latin": "Rangifer tarandus", "groups": 3, "size": [3, 12], "on": ["heath", "rough-grass", "wet-grassland", "grassland", "bog"] }, "sheep": { "groups": 1, "size": [2, 6], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] } }, "style": "wood-cabin" diff --git a/data/trailview/packs/norway-coast.json b/data/trailview/packs/norway-coast.json index 2a774f1b1e..c62da7ddad 100644 --- a/data/trailview/packs/norway-coast.json +++ b/data/trailview/packs/norway-coast.json @@ -34,7 +34,7 @@ "old-norwegian-sheep": { "model": "sheep", "latin": "Ovis aries (Old Norwegian)", "groups": 2, "size": [3, 12], "on": ["heath", "rough-grass", "wet-grassland", "grassland"] }, "goat": { "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] }, "norwegian-red-cattle": { "model": "highland-cow", "latin": "Bos taurus (Norwegian Red)", "groups": 2, "size": [3, 10], "on": ["pasture", "grassland", "arable"] }, - "fjord-horse": { "model": "highland-cow", "latin": "Equus caballus (Fjord)", "groups": 1, "size": [1, 4], "on": ["pasture", "grassland", "arable"] } + "fjord-horse": { "model": "horse", "latin": "Equus caballus (Fjord)", "groups": 1, "size": [1, 4], "on": ["pasture", "grassland", "arable"] } }, "style": "wood-cabin", "houses": "cottage" diff --git a/data/trailview/packs/nw-iberia.json b/data/trailview/packs/nw-iberia.json index b55d2dbf0a..3b72711cd6 100644 --- a/data/trailview/packs/nw-iberia.json +++ b/data/trailview/packs/nw-iberia.json @@ -42,7 +42,7 @@ "sheep": { "groups": 3, "size": [15, 60], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "heath"] }, "goat": { "groups": 1, "size": [5, 20], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "horse": { "groups": 1, "size": [3, 10], "on": ["heath", "rough-grass", "wet-grassland", "grassland"] }, - "iberian-ibex": { "model": "goat", "latin": "Capra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse"] } + "iberian-ibex": { "model": "ibex", "latin": "Capra pyrenaica", "groups": 1, "size": [3, 12], "on": ["bare-rock", "scree", "sparse"] } }, "rows": { "orchard": "hawthorn" }, "style": { "es-cl": "slate-stone-house", "es-ga": "slate-stone-house", "pt-04": "slate-stone-house", "es-ex": "village-house", "es-cm": "village-house", "pt-05": "village-house", "pt-12": "village-house", "*": "stone-house" } diff --git a/data/trailview/packs/pyrenees.json b/data/trailview/packs/pyrenees.json index 130bcbb70d..73913b03c9 100644 --- a/data/trailview/packs/pyrenees.json +++ b/data/trailview/packs/pyrenees.json @@ -41,7 +41,7 @@ "sheep": { "groups": 3, "size": [10, 40], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland", "heath"] }, "horse": { "groups": 2, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "heath", "pasture", "arable"] }, "goat": { "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, - "pyrenean-chamois": { "model": "goat", "latin": "Rupicapra pyrenaica", "groups": 1, "size": [2, 8], "on": ["bare-rock", "scree", "sparse", "rough-grass", "wet-grassland", "grassland"] } + "pyrenean-chamois": { "model": "chamois", "latin": "Rupicapra pyrenaica", "groups": 1, "size": [2, 8], "on": ["bare-rock", "scree", "sparse", "rough-grass", "wet-grassland", "grassland"] } }, "rows": { "orchard": "hawthorn" }, "style": "slate-stone-house" diff --git a/data/trailview/packs/south-apennines.json b/data/trailview/packs/south-apennines.json index 9ac73641ac..491d5a97c8 100644 --- a/data/trailview/packs/south-apennines.json +++ b/data/trailview/packs/south-apennines.json @@ -42,7 +42,7 @@ "goat": { "groups": 2, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "cattle": { "model": "highland-cow", "latin": "Bos taurus (Podolica)", "groups": 2, "size": [4, 15], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "horse": { "groups": 2, "size": [3, 12], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, - "iberian-pig": { "model": "goat", "latin": "Sus scrofa domesticus", "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] } + "iberian-pig": { "model": "pig", "latin": "Sus scrofa domesticus", "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] } }, "style": "stone-house" } diff --git a/data/trailview/packs/sw-iberia.json b/data/trailview/packs/sw-iberia.json index 81b45964fa..6d441fa8c1 100644 --- a/data/trailview/packs/sw-iberia.json +++ b/data/trailview/packs/sw-iberia.json @@ -30,7 +30,7 @@ }, "herds": { "cattle": { "model": "brown-cattle", "groups": 2, "size": [5, 25], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, - "iberian-pig": { "model": "goat", "latin": "Sus scrofa domesticus", "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland"] }, + "iberian-pig": { "model": "pig", "latin": "Sus scrofa domesticus", "groups": 1, "size": [4, 15], "on": ["rough-grass", "wet-grassland", "grassland"] }, "sheep": { "groups": 2, "size": [15, 60], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "goat": { "groups": 1, "size": [8, 30], "on": ["scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "horse": { "groups": 1, "size": [3, 12], "on": ["pasture", "grassland", "arable"] } diff --git a/data/trailview/packs/tyrrhenian.json b/data/trailview/packs/tyrrhenian.json index 75369ab253..d9708213a8 100644 --- a/data/trailview/packs/tyrrhenian.json +++ b/data/trailview/packs/tyrrhenian.json @@ -43,8 +43,8 @@ "goat": { "groups": 2, "size": [5, 25], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub", "bare-rock", "scree", "sparse"] }, "cattle": { "model": "brown-cattle", "groups": 1, "size": [3, 12], "on": ["pasture", "grassland", "arable", "rough-grass", "wet-grassland"] }, "horse": { "groups": 1, "size": [2, 6], "on": ["pasture", "grassland", "arable"] }, - "donkey": { "model": "highland-cow", "latin": "Equus asinus", "groups": 1, "size": [1, 4], "on": ["rough-grass", "wet-grassland", "grassland", "pasture", "arable"] }, - "iberian-pig": { "model": "goat", "latin": "Sus scrofa domesticus", "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] } + "donkey": { "latin": "Equus asinus", "groups": 1, "size": [1, 4], "on": ["rough-grass", "wet-grassland", "grassland", "pasture", "arable"] }, + "iberian-pig": { "model": "pig", "latin": "Sus scrofa domesticus", "groups": 1, "size": [3, 10], "on": ["rough-grass", "wet-grassland", "grassland", "scrub", "sclerophyllous-scrub"] } }, "rows": { "orchard": "almond" }, "style": { "mt": "canarian-house", "it-75": "canarian-house", "*": "village-house" } diff --git a/specs/trailview-models.md b/specs/trailview-models.md index f70d5468ef..e97947ebf9 100644 --- a/specs/trailview-models.md +++ b/specs/trailview-models.md @@ -31,7 +31,7 @@ has a new address. The module `virtual:models` of the build is the manifest (`Mo | A tree species' summer crown | 1, with 3 tiers | `trees[id].summer`, with `keepsHeading` and, per phase (winter, spring, summer, autumn), the colour matrix (3 × 3, columns first) that turns the summer crown into the phase's, or null | | A tree species' crown of its own in a phase | 1, with 3 tiers | `trees[id].crowns[phase]`, null for a phase without one | | A plant in a season | 3 shapes (seeds 1, 2, 3), 1 tier each | `plants[id].seasons[season]`, with the plant's `ground` | -| A breed of animal | 1 per coat | `breeds[name].file`, with `height` and `coats` | +| A breed of animal | 1 per coat and pose, coat by coat (model `coat × poses + pose`), 2 tiers each | `breeds[name].file`, with `height`, `coats` and `poses` | | The objects | the rocks (3 slabs, 3 boulders), then the models of the kinds in the order of `POINT_MODELS` | `objects.file`, with `rocks` and per kind model the end of each tier in metres (`until`) and `casts` | ## 2. File layout @@ -92,7 +92,7 @@ where each comes from. | Plant, each shape | 0 | 350 | 1,000 | | Rock | 0 | 100 | 300 | | Animal | 0 | 1,000 (the owner's choice: few on screen) | 3,000 | -| Animal, a second tier where it has one | 1 | 250 | 750 | +| Animal | 1 | 250 | 750 | | Small object of a kind | 0 | 600 (the owner's choice: few on screen) | 1,800 | One view draws at most 256 instance models, each with at most 3 mesh tiers and an impostor. The From cc47d5dbfb77eb68d182aaf454141ba5ed5cdb67 Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 01:27:06 +0100 Subject: [PATCH 4/7] trailview: a region's herds take their models when the region comes into reach All breeds of all packs in 3 poses no longer fit in the instances' 256 models. Co-Authored-By: Claude Opus 5.5 --- builder/web/src/lib/trailview/README.md | 4 +- .../src/lib/trailview/dressing/dressing.ts | 70 ++++++++++++------- builder/web/src/lib/trailview/engine.ts | 2 +- .../src/lib/trailview/models/sculpt.test.ts | 30 ++++++++ 4 files changed, 79 insertions(+), 27 deletions(-) create mode 100644 builder/web/src/lib/trailview/models/sculpt.test.ts diff --git a/builder/web/src/lib/trailview/README.md b/builder/web/src/lib/trailview/README.md index 6305831c24..175dad5ff3 100644 --- a/builder/web/src/lib/trailview/README.md +++ b/builder/web/src/lib/trailview/README.md @@ -38,10 +38,10 @@ the palette of the `world` region. | `kinds/` | One module per kind of `data/trailview/kinds.json`, found by its file name (`index.ts`), with the models that it stands on the surface; the shared handlers (`kind.ts`): a line structure on the surface, models at points. The instances draw the models of the kinds' points (`structures/kind-points.ts`). A kind's `near` meshes and points draw only within about 2 km, where a node of level 17 draws; a kind names its models, never their numbers | | `ground/` | The ground pages, `look.wgsl` (the ground shading of the prototype), the road paint (`roads.wgsl`), the rows of the material fields (`fields.wgsl`), the rules packing and the per-page compute | | `structures/` | The houses: a worker makes a record per building of each zoom 14 quarter of the zoom 13 feature tiles (`house-records.ts`); `houses.wgsl` fits each to the drawn surface with a basement, culls it, picks its level of detail and draws it from a template, and lights its windows at night | -| `models/` | The house templates: the prototype's buildings as faces whose coordinates name slots that `houses.wgsl` fills per house; the prototype's trees and plants without three.js (`shape.ts`, `trees.ts`, `trees/`, `plant-shape.ts`, `plants/`); the models of flat faces of the kinds and the dressing (`flat.ts`, lifts, landmarks, rocks, animals, crosses). The build writes the fixed models as files (`bake.ts`, [contract](../../../../../specs/trailview-models.md)) | +| `models/` | The house templates: the prototype's buildings as faces whose coordinates name slots that `houses.wgsl` fills per house; the prototype's trees and plants without three.js (`shape.ts`, `trees.ts`, `trees/`, `plant-shape.ts`, `plants/`); the models of flat faces of the kinds and the dressing (`flat.ts`, lifts, landmarks, rocks, crosses); the modelling kit of the soft low-poly style (`sculpt.ts`) and the herd animals, one file per breed (`animals.ts`, `animals/`). The build writes the fixed models as files (`bake.ts`, [contract](../../../../../specs/trailview-models.md)) | | `instances/` | Instances on the drawn surface: producers emit them (`emit.wgsl`), one indirect draw per model and tier (`sort.wgsl`, `draw.wgsl`), a tree's phase models and crown colours, impostors, culling by the last frame's depth (`hiz.wgsl`), point pools of kinds (`points.ts`) | | `vegetation/` | Each tree's phase on the date (`phenology.ts`); the tree models of the phases, shared by the forest, the shrubs and the plantings (`tree-models.ts`); the canopy tiles about the eye (`canopy.ts`) and the forest placed from them each frame (`forest.wgsl`); the ground plants and shrubs about the eye (`plants.wgsl`); the clearing that moves with the eye (`clearing.wgsl`); the plants of the materials planted in rows, on the rows of the material fields (`rows.wgsl`, `ground/fields.wgsl`) | -| `dressing/` | The herds of the packs on the materials that they graze, and rocks on rough and rocky ground, placed each frame (`dressing.wgsl`); the rocks' density and placement, which the ground also paints past their instances (`rocks.wgsl`) | +| `dressing/` | The herds of the packs on the materials that they graze, and rocks on rough and rocky ground, placed each frame (`dressing.wgsl`); the `showroom` address option, which stands a row of animals before the eye for the model review; the rocks' density and placement, which the ground also paints past their instances (`rocks.wgsl`) | | `light/` | The light keys and weather presets, the look at the eye, `shade.wgsl` (toon bands, haze, `finish()`), the sky with the moon, the stars and the Milky Way, and a solar eclipse where the moon covers the sun (`celestial.ts`, `eclipse.ts`, `night.ts`; `tools/trailview/sky.py` makes `milkyway.webp`, `stars.bin` and `moon.webp`), the object shadow maps near and far from the eye (`shadow.ts`) | | `resolve/` | The render targets, the jitter, TAA and `finish()` | | `plan/` | The ground plan with `ground=plan`: the cells about the eye and their inputs (`plan.ts`, `inputs.ts`), the build in the bridge of [`builder/ground-plan-wasm`](../../../../ground-plan-wasm/README.md), one copy per page (`bridge.ts`, `plan-worker.ts`, `pkg/`), the debug draw over the canvas (`debug.ts`, `draw.ts`, `debug.wgsl`) | diff --git a/builder/web/src/lib/trailview/dressing/dressing.ts b/builder/web/src/lib/trailview/dressing/dressing.ts index dc3e72ed44..e4b2b480c8 100644 --- a/builder/web/src/lib/trailview/dressing/dressing.ts +++ b/builder/web/src/lib/trailview/dressing/dressing.ts @@ -7,6 +7,7 @@ import { Instances, VIEWS, type ModelSpec, type Producer, type Surfaces } from ' import type { ModelFiles } from '../instances/model-files'; import type { Packed } from '../models/model-file'; import { bits, named, type Rules } from '../rules/regions'; +import type { Reach } from '../vegetation/tree-models'; /** Herds stand within this many metres, rocks within this many; as HERDS of dressing.wgsl and ROCK_REACH_M of rocks.wgsl. */ const HERD_REACH_M = 1500, ROCK_REACH_M = 1000, HERDS = 4; @@ -33,12 +34,14 @@ function showroom(): Showroom | undefined { return { lonLat: [Number(lon), Number(lat)], heading: (Number(heading) * Math.PI) / 180, entries: entries.split('|'), tier: Number(tier ?? 0) }; } -interface Resources { gpu: Gpu; herds: GPUComputePipeline; rocks: GPUComputePipeline; groups: GPUBindGroup[]; params: GPUBuffer } +interface Resources { gpu: Gpu; herds: GPUComputePipeline; rocks: GPUComputePipeline; groups: GPUBindGroup[]; params: GPUBuffer; table: GPUBuffer } /** * The dressing of the ground (dressing.wgsl): the herds of the regions' packs on the materials that * they graze, and rocks on rough and rocky ground, placed on the GPU each frame. Their models come from - * model files (models/model-file.ts): the rocks from the objects file, each breed from a file of its own. + * model files (models/model-file.ts): the rocks from the objects file, each breed from a file of its own. A + * region's herds take their models when the region comes into reach: all breeds of all packs would not fit + * in the instances' models. */ export class Dressing implements Producer { private resources?: Resources; @@ -52,22 +55,21 @@ export class Dressing implements Producer { private showCount = 0; /** The files of the models. */ private readonly urls: string[] = []; + /** The first instance model of each breed that has its models, and the regions whose herds are in the table. */ + private readonly breeds = new Map(); + private readonly placed = new Set(); + private changed = false; + private updated = false; - constructor(rules: Rules, private readonly instances: Instances, private readonly files: ModelFiles) { + constructor(private readonly rules: Rules, private readonly instances: Instances, private readonly files: ModelFiles) { instances.produce(this); const { objects, breeds: breedModels } = files.models; const spec = ({ tiers: [mesh], shape }: Packed, until: number): ModelSpec => ({ tiers: [{ mesh, until }], shape }); // No fade of the rocks' tier: rocks_of ends each rock at its own distance before the reach. this.rockModel = this.load(objects.file, objects.rocks, model => ({ ...spec(model, ROCK_REACH_M), fade: 0 })); - const animal = ({ tiers: [near, far], shape }: Packed): ModelSpec => ({ tiers: this.show?.tier ? [{ mesh: far, until: HERD_REACH_M }] : [{ mesh: near, until: ANIMAL_NEAR_M }, { mesh: far, until: HERD_REACH_M }], shape }); - const shown = this.show?.entries.map(entry => entry.split('.')) ?? []; - const breeds = new Map(), used = new Set([...rules.regions.flatMap(region => region.herds.map(herd => herd.model)), ...shown.map(([name]) => name)].filter(name => name in breedModels)); - for (const name of used) { - const first = this.load(breedModels[name].file, breedModels[name].coats * breedModels[name].poses, animal); - if (first !== undefined) breeds.set(name, first); - } // The showroom's animals: an entry of a breed stands each of its models. - const row = shown.filter(([name]) => breeds.has(name)).flatMap(([name, k]) => (k ? [Number(k)] : Array.from({ length: breedModels[name].coats * breedModels[name].poses }, (_, m) => m)).map(m => ({ name, model: breeds.get(name)! + m }))); + const row = (this.show?.entries ?? []).map(entry => entry.split('.')).filter(([name]) => this.breed(name) !== undefined) + .flatMap(([name, k]) => (k ? [Number(k)] : Array.from({ length: breedModels[name].coats * breedModels[name].poses }, (_, m) => m)).map(m => ({ name, model: this.breed(name)! + m }))); this.showFirst = Math.max(1, rules.regions.length) * HERDS; this.showCount = row.length; this.table = new Uint32Array((this.showFirst + row.length) * HERD_WORDS); @@ -83,13 +85,29 @@ export class Dressing implements Producer { offset += room[k] / 2; }); } - rules.regions.forEach((region, r) => { - region.herds.filter(herd => breeds.has(herd.model)).slice(0, HERDS).forEach((herd, k) => { - const at = (r * HERDS + k) * HERD_WORDS, { coats, poses } = breedModels[herd.model]; - this.table.set([breeds.get(herd.model)!, coats | (poses << 16)], at); - floats.set([herd.groups, breedModels[herd.model].height, ...herd.size], at + 2); - this.table.set(bits(named(rules.vocabulary, herd.on)), at + 6); - }); + } + + /** The first instance model of a breed, which it adds on the first ask; undefined where the instances have no room. */ + private breed(name: string): number | undefined { + const entry = this.files.models.breeds[name]; + if (!entry) return undefined; + if (!this.breeds.has(name)) { + const near = this.show?.tier ? [] : [ANIMAL_NEAR_M]; + this.breeds.set(name, this.load(entry.file, entry.coats * entry.poses, ({ tiers, shape }) => ({ tiers: [...near, HERD_REACH_M].map((until, t) => ({ mesh: tiers[t + 1 - near.length], until })), shape }))); + } + return this.breeds.get(name); + } + + /** Writes the herds of region `r` into the table, in the order of its pack: those whose breed has its models. */ + private place(r: number): void { + this.placed.add(r); + this.changed = true; + const floats = new Float32Array(this.table.buffer), { breeds } = this.files.models; + this.rules.regions[r].herds.filter(herd => this.breed(herd.model) !== undefined).slice(0, HERDS).forEach((herd, k) => { + const at = (r * HERDS + k) * HERD_WORDS, { coats, poses, height } = breeds[herd.model]; + this.table.set([this.breed(herd.model)!, coats | (poses << 16)], at); + floats.set([herd.groups, height, ...herd.size], at + 2); + this.table.set(bits(named(this.rules.vocabulary, herd.on)), at + 6); }); } @@ -104,9 +122,9 @@ export class Dressing implements Producer { return first; } - /** Whether the models have arrived, or failed. */ + /** Whether the models of the regions in reach have arrived, or failed. */ get idle(): boolean { - return this.files.done(...this.urls); + return this.updated && this.files.done(...this.urls); } async attach(gpu: Gpu, { surface, features }: Surfaces): Promise { @@ -114,10 +132,10 @@ export class Dressing implements Producer { const { device } = gpu; const herds = gpu.buffer('dressing', this.table.byteLength, GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST); const params = gpu.buffer('dressing', DRESSING_BYTES, GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST); - device.queue.writeBuffer(herds, 0, this.table); + this.changed = true; const [herdsOf, rocksOf] = await gpu.once(dressingPipelines); this.resources = { - gpu, herds: herdsOf, rocks: rocksOf, params, + gpu, herds: herdsOf, rocks: rocksOf, params, table: herds, groups: VIEWS.map(view => device.createBindGroup({ layout: herdsOf.getBindGroupLayout(0), entries: [...this.instances.emitResources(view), { binding: 8, resource: { buffer: params } }, { binding: 9, resource: { buffer: herds } }] })), }; this.surface = surface; @@ -127,10 +145,14 @@ export class Dressing implements Producer { private surface?: GPUBindGroup; private features?: GPUBindGroup; - /** The windows of herd cells and rock points about the eye at (lon, lat). */ - update(lonLat: [number, number]): void { + /** The windows of herd cells and rock points about the eye at (lon, lat), and the herds of the regions in reach. */ + update(lonLat: [number, number], { reach }: Reach): void { const r = this.resources; if (!r) return; + for (const region of reach) if (!this.placed.has(region) && this.rules.regions[region]) this.place(region); + if (this.changed) r.gpu.device.queue.writeBuffer(r.table, 0, this.table); + this.changed = false; + this.updated = true; const [ux, uy] = worldPixel(lonLat, UNITS), unit = anchorAt(...lonLat).unit; this.herdSide = 2 * Math.ceil(HERD_REACH_M / (HERD_CELL * unit)) + 2; this.rockSide = 2 * Math.ceil(ROCK_REACH_M / (ROCK_CELL * unit)) + 2; diff --git a/builder/web/src/lib/trailview/engine.ts b/builder/web/src/lib/trailview/engine.ts index 1ca8068405..4117e671f5 100644 --- a/builder/web/src/lib/trailview/engine.ts +++ b/builder/web/src/lib/trailview/engine.ts @@ -711,7 +711,7 @@ export class TrailView { this.forest.update(lonLat); this.plants.update(lonLat, this.extras.date, place.above, reach); this.rows.update(lonLat); - this.dressing.update(lonLat); + this.dressing.update(lonLat, reach); const group = this.groundLook.group; this.drawing = !!(eye && group); // A frame that cannot draw asks for no next frame: a capture would wait forever. diff --git a/builder/web/src/lib/trailview/models/sculpt.test.ts b/builder/web/src/lib/trailview/models/sculpt.test.ts new file mode 100644 index 0000000000..ebf9587732 --- /dev/null +++ b/builder/web/src/lib/trailview/models/sculpt.test.ts @@ -0,0 +1,30 @@ +import { describe, expect, it } from 'vitest'; +import { alongY, mesh, Sculpt } from './sculpt'; + +describe('the modelling kit', () => { + it('turns every face of a skin away from its axis, and keeps each facet as one normal with its corners once', () => { + const s = new Sculpt().skin(alongY([[-1, 0, 0.3, 0.4, 0.2], [0, 0, 0.5, 0.6, 0.3], [1, 0, 0.2, 0.2, 0.2]]), 8, 0x808080); + const { position: p, normal: n, index } = mesh(s.model); + for (let t = 0; t < index.length; t += 3) { + const [a, b, c] = [index[t], index[t + 1], index[t + 2]]; + const mid = [0, 1, 2].map(d => (p[3 * a + d] + p[3 * b + d] + p[3 * c + d]) / 3); + // Away from the y axis on the sides, along it at the caps. + const out = Math.abs(mid[1]) > 0.99 ? [0, mid[1], 0] : [mid[0], 0, mid[2]]; + expect(n[3 * a] * out[0] + n[3 * a + 1] * out[1] + n[3 * a + 2] * out[2]).toBeGreaterThan(0); + } + // 2 bands of 8 quads with 4 corners each, and 2 caps of 8 corners. + expect(p.length / 3).toBe(2 * 8 * 4 + 2 * 8); + expect(index.length / 3).toBe(2 * 8 * 2 + 2 * 6); + }); + + it('builds the far tier with fewer sides and without the fine details', () => { + const [near, far] = [0, 1].map(tier => { + const s = new Sculpt(tier).skin(alongY([[-1, 0, 0.3, 0.3, 0.3], [1, 0, 0.3, 0.3, 0.3]]), 10, 0); + const body = s.model.triangles; + s.fine(() => s.box([0, 0, 0], [0.1, 0.1, 0.1], 0)); + return { body, details: s.model.triangles - body }; + }); + expect(far.body).toBeLessThan(near.body); + expect([near.details, far.details]).toEqual([12, 0]); + }); +}); From 2a9fb19683be5b48b7f1770a9bc78a25adf1b891 Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 01:37:42 +0100 Subject: [PATCH 5/7] docs: the TrailView model style guide Co-Authored-By: Claude Opus 5.5 --- docs/assets/trailview-models/lineup.jpg | Bin 0 -> 110584 bytes docs/assets/trailview-models/poses.jpg | Bin 0 -> 50058 bytes docs/assets/trailview-models/tiers.jpg | Bin 0 -> 36396 bytes docs/content/nav.json | 1 + docs/content/software/trailview-models.md | 70 ++++++++++++++++++++++ 5 files changed, 71 insertions(+) create mode 100644 docs/assets/trailview-models/lineup.jpg create mode 100644 docs/assets/trailview-models/poses.jpg create mode 100644 docs/assets/trailview-models/tiers.jpg create mode 100644 docs/content/software/trailview-models.md diff --git a/docs/assets/trailview-models/lineup.jpg b/docs/assets/trailview-models/lineup.jpg new file mode 100644 index 0000000000000000000000000000000000000000..ba83a1c6bdfcb3649d536fdf00b09fcc01a549a7 GIT binary patch literal 110584 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 #;vjC|KdeQxzjv2KemjsB} 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⩔yxPcaG|j%AlgC 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 z z!)fSH2stLZ$7CEHi}#2L3$qd1MCINWcQ#SRd_^Z82tX4}hKTd{Na|Ek>hKeU0he(` z!*=)W{zzZMAS7oUcv|VfPISMJQG=p@70Kb%P7a63LRuPZ5#L9A5CwbPB6UI! z6uF=b>wbucv_uX?0N|wir_Bi-F?P1&?^vfASai`Q@ITa(xu51x1}8-!Hw`^SltWhl zb=4Wsw&-ktal+j~M@s;h9tejIiU6;~_CgA0Xv9(b4f8-b(2$WfOizfW`^X7n)uXvY zPN&Tabh1N;^H4}xwD_iP6vu*b$pGxt)=7s_ia%(4P{r+^iU6Cf{E`B|`6nD39Lf{+-{ zA1fp@zmgmHN?lYEC%)yO6Apz40D?$Hc)Q?$E1i1;#N94V@4#G~XqkPhBA=$+RM0C|)x*1>SBKs1CwO5K;z<0N&-#*Bo3)s=EIP QAP8_s@l4(YE1*CB+2OQn?*IS* literal 0 HcmV?d00001 diff --git a/docs/assets/trailview-models/tiers.jpg b/docs/assets/trailview-models/tiers.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b7172211b5a7ca46dac6f156bbd9a1bf345bdac5 GIT binary patch literal 36396 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 MD`H}hu)jzD2QMb Date: Sun, 22 Nov 2026 01:52:13 +0100 Subject: [PATCH 6/7] trailview: review fixes: only drawn herds take models, chain caps face out, a broken showroom option is ignored, the review page reads the budget Co-Authored-By: Claude Opus 5.5 --- .../web/src/lib/trailview/dressing/dressing.ts | 4 +++- builder/web/src/lib/trailview/models/bake.ts | 6 +++--- builder/web/src/lib/trailview/models/sculpt.ts | 16 +++++++++++++++- builder/web/tests/browser/trailview/models.mjs | 4 +--- 4 files changed, 22 insertions(+), 8 deletions(-) diff --git a/builder/web/src/lib/trailview/dressing/dressing.ts b/builder/web/src/lib/trailview/dressing/dressing.ts index e4b2b480c8..bcb11fb8be 100644 --- a/builder/web/src/lib/trailview/dressing/dressing.ts +++ b/builder/web/src/lib/trailview/dressing/dressing.ts @@ -31,6 +31,7 @@ function showroom(): Showroom | undefined { const value = globalThis.location ? new URLSearchParams(globalThis.location.search).get('showroom') : null; if (!value) return undefined; const [lat, lon, heading, entries, tier] = value.split(','); + if (!entries) return undefined; return { lonLat: [Number(lon), Number(lat)], heading: (Number(heading) * Math.PI) / 180, entries: entries.split('|'), tier: Number(tier ?? 0) }; } @@ -103,7 +104,8 @@ export class Dressing implements Producer { this.placed.add(r); this.changed = true; const floats = new Float32Array(this.table.buffer), { breeds } = this.files.models; - this.rules.regions[r].herds.filter(herd => this.breed(herd.model) !== undefined).slice(0, HERDS).forEach((herd, k) => { + // Only the first HERDS herds with a model draw, so only theirs take instance models. + this.rules.regions[r].herds.filter(herd => herd.model in breeds).slice(0, HERDS).filter(herd => this.breed(herd.model) !== undefined).forEach((herd, k) => { const at = (r * HERDS + k) * HERD_WORDS, { coats, poses, height } = breeds[herd.model]; this.table.set([this.breed(herd.model)!, coats | (poses << 16)], at); floats.set([herd.groups, height, ...herd.size], at + 2); diff --git a/builder/web/src/lib/trailview/models/bake.ts b/builder/web/src/lib/trailview/models/bake.ts index cd8e63f6d4..82f12f2d8f 100644 --- a/builder/web/src/lib/trailview/models/bake.ts +++ b/builder/web/src/lib/trailview/models/bake.ts @@ -37,8 +37,8 @@ const BUDGET: Record = { }; const TREE_MEAN = 3400; -/** What the build serves: each file by name, and the models with the names of their files. */ -export interface Baked { files: Map; models: Models } +/** What the build serves: each file by name, and the models with the names of their files; and the budget, for the review page. */ +export interface Baked { files: Map; models: Models; budget: typeof BUDGET } export async function bake(): Promise { await simplifierReady; @@ -95,7 +95,7 @@ export async function bake(): Promise { const mean = summers.reduce((sum, n) => sum + n, 0) / summers.length; if (mean > TREE_MEAN) over.push(`the tree species: ${Math.round(mean)} triangles in tier 0 on average, the budget ${TREE_MEAN}`); if (over.length) throw new Error(`Models over the budget of specs/trailview-models.md:\n${over.join('\n')}`); - return { files, models }; + return { files, models, budget: BUDGET }; } /** A crown of a species' own in a season: bare crowns grow each tier from the tree, the others simplify tier 0. */ diff --git a/builder/web/src/lib/trailview/models/sculpt.ts b/builder/web/src/lib/trailview/models/sculpt.ts index 4252c83fe7..64ce2d1bb3 100644 --- a/builder/web/src/lib/trailview/models/sculpt.ts +++ b/builder/web/src/lib/trailview/models/sculpt.ts @@ -104,10 +104,24 @@ export class Sculpt { /** Bars through the points, each `widths` across at its point, of `sides` sides: a horn, a tail. Tier 1 has fewer sides and goes through every second point and the last. */ chain(points: Vec[], widths: number[], colour: number, sides = 4): this { const keep = points.map((_, i) => i).filter(i => !this.tier || i % 2 === 0 || i === points.length - 1); - for (let k = 0; k + 1 < keep.length; k++) this.model.beam(points[keep[k]], points[keep[k + 1]], widths[keep[k]], colour, { sides: this.sides(sides), w1: widths[keep[k + 1]], capped: true }); + for (let k = 0; k + 1 < keep.length; k++) { + const a = points[keep[k]], b = points[keep[k + 1]], first = this.model.triangles; + this.model.beam(a, b, widths[keep[k]], colour, { sides: this.sides(sides), w1: widths[keep[k + 1]], capped: true }); + this.outward(first, along(a, sub(b, a), 0.5)); + } return this; } + /** Turns each triangle from `first` on away from `inside`: Model.beam winds its start cap inward. */ + private outward(first: number, inside: Vec): void { + const p = this.model.points; + for (let i = 9 * first; i < p.length; i += 9) { + const a: Vec = [p[i], p[i + 1], p[i + 2]], b: Vec = [p[i + 3], p[i + 4], p[i + 5]], c: Vec = [p[i + 6], p[i + 7], p[i + 8]]; + const n = cross(sub(b, a), sub(c, a)), out = sub(along(along(a, b, 1), c, 1).map(v => v / 3) as Vec, inside); + if (n[0] * out[0] + n[1] * out[1] + n[2] * out[2] < 0) p.splice(i + 3, 6, ...c, ...b); + } + } + /** A box about its middle: an eye, a nostril. */ box(at: Vec, size: Vec, colour: number): this { this.model.box(at, size, colour); diff --git a/builder/web/tests/browser/trailview/models.mjs b/builder/web/tests/browser/trailview/models.mjs index 889934ebc7..2a52575bda 100644 --- a/builder/web/tests/browser/trailview/models.mjs +++ b/builder/web/tests/browser/trailview/models.mjs @@ -27,10 +27,8 @@ const { values } = parseArgs({ }); /** The showroom's middle, the eye's heading toward it, and the page; SHOW_SPACING of dressing.ts. */ const PLACE = [46.820416, 8.403045], HEADING = 160, WIDTH = 1600, HEIGHT = 640, SPACING = 2.3; -/** The budget of models/bake.ts, per tier: triangles and vertices. */ -const BUDGET = [[1000, 3000], [250, 750]]; - const { baked } = await bakeModels(); +const BUDGET = baked.budget.animal; const only = values.only?.split(','); const breeds = Object.entries(baked.models.breeds).filter(([name]) => !only || only.includes(name)); mkdirSync(values.out, { recursive: true }); From 0fec26ef1596626c767d04a2a2c54de83c60d7da Mon Sep 17 00:00:00 2001 From: timohueser Date: Sun, 22 Nov 2026 01:52:13 +0100 Subject: [PATCH 7/7] docs: the image paths of the TrailView model guide Co-Authored-By: Claude Opus 5.5 --- docs/content/software/trailview-models.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/content/software/trailview-models.md b/docs/content/software/trailview-models.md index 09b9ea9888..e9fd22938c 100644 --- a/docs/content/software/trailview-models.md +++ b/docs/content/software/trailview-models.md @@ -10,7 +10,7 @@ them have one style, "soft low-poly". This page says what the style is and why w of a model file and the triangle budget of each kind are in the [model contract](src:specs/trailview-models.md). -![A row of the herd animals on a meadow in TrailView: cattle, sheep, goats, a horse, a donkey, a pig, a dromedary, deer, reindeer, ibex and chamois](../assets/trailview-models/lineup.jpg) +![A row of the herd animals on a meadow in TrailView: cattle, sheep, goats, a horse, a donkey, a pig, a dromedary, deer, reindeer, ibex and chamois](../../assets/trailview-models/lineup.jpg) ## The style @@ -53,14 +53,14 @@ and leaves out fine details such as eyes and udders. So the outline and the colo same when an animal moves from one tier to the other. For an animal, the near tier ends at 150 m. Past it, an animal is only a few pixels tall. -![The cattle of TrailView in the near tier (left) and the far tier (right), drawn at the same size](../assets/trailview-models/tiers.jpg) +![The cattle of TrailView in the near tier (left) and the far tier (right), drawn at the same size](../../assets/trailview-models/tiers.jpg) ## Poses and coats An animal has two or three poses: it stands, it grazes, or it lies. A herd mixes them, so a group looks alive. A breed has one to four coats, and most animals of a group wear the first coat. -![A brown cow standing, grazing and lying](../assets/trailview-models/poses.jpg) +![A brown cow standing, grazing and lying](../../assets/trailview-models/poses.jpg) ## A new model