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:
parent
190ef9cc4b
commit
1042269d7e
38 changed files with 2348 additions and 374 deletions
|
|
@ -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.
|
||||
|
||||
Пик логируется отдельной строкой, поэтому «лаг в момент переворота» можно найти в
|
||||
логе, а не только на графике.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue