Finish M4: cart, log facade, idle diagnostics and terrain LOD

Add the core::log facade with five levels and a sink; migrate the app dev log and enable trace in --dev. Replace the dropped cubes with a four-wheel cart on revolute joints driven by velocity motors, add WASD controls, a golden trajectory and a slope test. Instrument idle frame spikes and throttle the window title. Add chunked terrain LOD with skirts (2368 vs 8192 triangles) while physics keeps the full mesh. Pin Rust 1.100.0; edition stays 2024.
This commit is contained in:
Loki 2026-11-17 14:32:52 +01:00
parent 190ef9cc4b
commit 1042269d7e
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
38 changed files with 2348 additions and 374 deletions

View file

@ -55,6 +55,29 @@
на подготовку снимка. Бюджет проверяется бенчмарком в автоматическом прогоне; выход за него — повод
переходить на `ash` (D24) или упрощать World, но не менять шаг.
## Рельеф и LOD
`worldgen::terrain` строит высотную карту и один меш на её основе (D14). Первый шаг
LOD — chunked LOD без отдельного прохода рендера:
- карта режется на чанки по `LodConfig::chunk_cells` клеток, последний чанк короче;
- внутри чанка остаются каждый `step`-й узел, `step` — степень двойки не больше
`max_step` и размера чанка; шаг растёт с расстоянием от камеры до центра чанка
(`switch_m` на удвоение);
- по периметру каждого чанка идёт вертикальная юбка глубиной `skirt_m`, она
закрывает трещины между соседями с разным шагом и не меняет верхнюю поверхность;
- приложение хранит центр, от которого построен меш, и пересобирает его, когда
камера сместилась на `LOD_REBUILD_M` (4 м); между перестроениями кадр платит
только проверку расстояния.
Результат по-прежнему один `TerrainMesh` в сцене, поэтому рендер не менялся.
Физика работает на полном меше `heightmap.mesh()`: LOD облегчает только картинку
и не влияет на столкновения или детерминизм симуляции.
Это честно первый шаг: шаг выбирается по расстоянию до чанка, а не по экранной
ошибке, и границы чанков могут заметно переключаться при движении. Продолжение —
rings/clipmap с сеткой, сшитой без юбок, и выбором детализации по проекции ошибки
на экран.
## Адаптация под устройство
`platform` определяет ядра (P/E), SIMD, RAM, GPU и кеширует профиль. Адаптируется
только то, что не влияет на результат: число потоков, раскладка по ядрам, качество

View file

@ -6,6 +6,28 @@
Правила для кода — в [CODE_RULES.md](CODE_RULES.md), раздел «Логирование».
## Фасад `core::log`
Библиотеки пишут через `fabrilis_core::log`, а не через `println!` и не через
внешний `log`/`tracing` (D35):
```rust
use fabrilis_core::log::{info, warn};
info!("world", "terrain seed={} size={}", seed, size);
warn!("physics", "solver degraded: iterations={}", iterations);
```
Первый аргумент макроса — target (подсистема), дальше обычный `format!`-шаблон.
Уровни: `error`, `warn`, `info`, `debug`, `trace`. Аргументы не вычисляются и не
форматируются, если уровень выключен или приёмник не установлен. `Record`
заимствует target и сообщение; аллокацию делает приёмник.
Приложение ставит приёмник один раз до стартового баннера:
`app` открывает dev-лог по `--log` (или `--dev`) и регистрирует `DevLogSink`.
`--dev` включает `trace`, обычный запуск — `info`. Без файла приёмника нет, и
фасад молчит, не создавая файлов.
## Оверлей
Поверх кадра показывается панель (левый верхний угол выбран для M4d):
@ -26,6 +48,10 @@
физики, авто-масштаб по максимуму, сетка и подписи 0 / max мс. Пики контактов
(переворот куба, удар) должны быть видны как узкие высокие всплески.
Заголовок окна с `RTF` обновляется не чаще раза в секунду: на Wayland каждый
`set_title` — это запрос композитору, и слать его на каждом кадре незачем. Формат
заголовка не меняется, «...» остаётся до первого измерения RTF.
## Флаги запуска
| Флаг | Что делает |
@ -68,9 +94,26 @@ GPU в dev-логе, нет.
- созданные тела, коллайдеры, массы, стартовые позы;
- параметры камеры и изменения управления (без покадрового шума);
- раз в секунду — сводку метрик;
- каждый пик: номер кадра, время кадра, время физики, причина (`contact`/`resize`/`render`);
- каждый пик: номер кадра, время кадра и физического шага, время фаз `render_ms`,
`overlay_ms`, `title_ms`, стоимость чтения `/proc` `metrics_us`, число шагов
(`steps`) и причину (`frame`/`physics`/`frame+physics`);
- ошибки wgpu/Rapier с контекстом.
Строка пика выглядит так:
```text
frame=4517 frame_ms=1873.22 physics_step_ms=0.124 render_ms=1.29 overlay_ms=0.05 title_ms=0.01 metrics_us=99 steps=50 trigger=frame
```
Поля позволяют сразу отделить виновника. `render_ms` включает блокирующий захват
surface, поэтому в ровном режиме он близок к одному интервалу vsync (~13 мс при
75 Гц). Если `frame_ms` заметно больше суммы фаз, а `render_ms` остаётся в норме,
кадр задержался вне приложения: оно ждало callback композитора (пропуск vsync,
внешняя нагрузка). Если растёт `physics_step_ms` — виновата симуляция, если
`overlay_ms` — сборка панели, `metrics_us` — чтение `/proc` (обычно ~0.1 мс, то
есть шум). Большой `render_ms` вместе с большим `frame_ms` — блокировка на
захвате поверхности или в драйвере GPU.
Пик логируется отдельной строкой, поэтому «лаг в момент переворота» можно найти в
логе, а не только на графике.

View file

@ -37,6 +37,9 @@
Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.
Статус: готовы M0 (скелет, правила) и M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная
математика, seeded RNG, минимальная физика с мотором и датчиками.
Статус: готовы M0 (скелет, правила), M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки), M2 (векторы, RNG, шарнир с мотором, датчики,
PD-контур), M3 (импорт STL/OBJ, массы и инерция, материалы, RON-сцены,
blob-store) и M4 (рельеф и chunked LOD, wgpu-рендер, тележка на шарнирах,
оверлей и логи). Дальше M5 — эталонный паук: конструкция, приводы, контакт стоп
с землёй и устойчивость.

View file

@ -33,6 +33,24 @@ UI-фреймворк и не библиотека для чужих прогр
Виджеты вводятся по одному и только под конкретную задачу редактора. Зоопарк
«на будущее» запрещён (KISS).
## Управление (M4)
В окне одна сцена: тележка на террейне. Ввод задаёт только цель моторов на
границе кадра и не меняет шаг симуляции.
| Ввод | Действие |
|---|---|
| `W` / `S` | газ вперёд / назад (тележка) |
| `A` / `D` | поворот влево / вправо (тележка) |
| Стрелки | камера: вперёд/назад, влево/вправо |
| `Q` / `E` | камера вниз / вверх |
| `Shift` | ускорить камеру |
| ЛКМ + мышь | обзор камерой |
| `Escape` | выход |
Когда клавиши отпущены, цель моторов — ноль: тележка тормозит, а не катится
по инерции.
## Текст
- Сейчас: `fontdue` только растеризует глифы, раскладку строк и переносы делаем сами.