Repository navigation
Description
Status: approved
Part of epic #3782 (part 3). Depends on #3785. The epic holds the facts about today's animals, the budget and the owner's decisions.
TL;DR
Goal: one way to make every TrailView model ourselves, in one style: a shared modelling kit in code, a style guide and a review page. The animals are the first models made with it.
Decision: all models are our own TypeScript files built with one kit; asset packs and photos are only inspiration and references. Style: low-fidelity, game-like, cute, never odd, few triangles. Each species file holds traced outlines (from public-domain or CC0 photos), colours, poses or seasons, and seeds; the build makes the tiers inside the budget of specs/trailview-models.md.
Systems: trailview
Contracts: none (it keeps specs/trailview-models.md)
Size: M (a look change across many model files, more than 500 changed lines)
Plan
- Mock-ups: a cow, a sheep and a goat in 2 or 3 style variants made with a first cut of the kit, at 10 m and 100 m in the engine, next to today's models. The owner chooses the style; nothing else is built before.
- The kit (grown from
models/shape.tsandmodels/flat.ts), the style guide indocs/content/with pictures, and the review page (turntable per tier, counts against the budget, today's model beside it). - Remake the animals: about 12 species models (cattle, highland cow, sheep, goat, ibex, chamois, red deer, reindeer, horse, donkey, pig, dromedary) with 2 or 3 poses; tier 0 to 150 m at most 1,000 triangles, tier 1 to 1,500 m at most 250.
- The same kit then remakes every other generated model, one kind at a time: the trees (TrailView: remake the trees with the modelling kit #3797), the plants and shrubs (TrailView: remake the plants and shrubs with the modelling kit #3798), the rocks (TrailView: remake the rocks with the modelling kit #3799) and the small objects of the kinds (TrailView: remake the small objects of the kinds with the modelling kit #3800).
Done when
- The owner approves the mock-up style, then the before/after gallery (near 10 to 30 m and far 300 to 1,000 m, summer and winter, cattle, sheep, goats and one new species).
- One flight on the M1 Pro and one at the phone canvas of 780 x 1688, develop against the branch, alternated: not noticeably slower, within the noise.
Out of scope: where and when animals and plants stand (the herd and plant placement is temporary), and flowers that bloom by region and season.
Prototype: which modelling style should the kit use?
Answer: style a, soft low-poly (the owner's choice, 2026-11-22).
Evidence: a cow, a sheep and a goat in three styles (a: soft low-poly, b: chunky toy, c: natural faceted), shown in the engine on the Engelberg meadow next to today's models at 10 m and 100 m, with a showroom address switch that stands a row of breeds before the eye. Style a: cow 636, sheep 600, goat 608 triangles. All styles read at 100 m.
For the design: a's way of building: round skins lofted through rings of 10 to 12 sides with separate up and down reach and a pitch; a friendly, slightly large head with eyes, ears and a cream muzzle; short sturdy legs with stepped hooves; small details (udder, tail tuft, lumpy wool, beard, swept horns); faces turned away from a point inside each part, so no hand winding. Next for a: fewer, larger wool lumps (the lump reads as facet noise at 10 m), and ears that the horns do not hide.
Branch: https://github.com/timohueser/OpenBikeComputer/tree/prototype/animal-styles
Activity
timohueser commentedon Nov 22, 2026
Built in #3801: the kit (
models/sculpt.ts), 14 breeds in 12 body shapes with 3 poses each, the review page (tests/browser/trailview/models.mjs) and the style guide (docs/content/software/trailview-models.md). The before/after gallery waits for the owner's approval: https://claude.ai/artifact/VyMRtxCuEcx6jfzjUbYdAb. Frame time on the M1 Pro, desktop and phone canvas: no change beyond the noise.