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

@ -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.
Пик логируется отдельной строкой, поэтому «лаг в момент переворота» можно найти в
логе, а не только на графике.