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
|
|
@ -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 и кеширует профиль. Адаптируется
|
||||
только то, что не влияет на результат: число потоков, раскладка по ядрам, качество
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||
Пик логируется отдельной строкой, поэтому «лаг в момент переворота» можно найти в
|
||||
логе, а не только на графике.
|
||||
|
||||
|
|
|
|||
|
|
@ -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 — эталонный паук: конструкция, приводы, контакт стоп
|
||||
с землёй и устойчивость.
|
||||
|
|
|
|||
18
docs/UI.md
18
docs/UI.md
|
|
@ -33,6 +33,24 @@ UI-фреймворк и не библиотека для чужих прогр
|
|||
Виджеты вводятся по одному и только под конкретную задачу редактора. Зоопарк
|
||||
«на будущее» запрещён (KISS).
|
||||
|
||||
## Управление (M4)
|
||||
|
||||
В окне одна сцена: тележка на террейне. Ввод задаёт только цель моторов на
|
||||
границе кадра и не меняет шаг симуляции.
|
||||
|
||||
| Ввод | Действие |
|
||||
|---|---|
|
||||
| `W` / `S` | газ вперёд / назад (тележка) |
|
||||
| `A` / `D` | поворот влево / вправо (тележка) |
|
||||
| Стрелки | камера: вперёд/назад, влево/вправо |
|
||||
| `Q` / `E` | камера вниз / вверх |
|
||||
| `Shift` | ускорить камеру |
|
||||
| ЛКМ + мышь | обзор камерой |
|
||||
| `Escape` | выход |
|
||||
|
||||
Когда клавиши отпущены, цель моторов — ноль: тележка тормозит, а не катится
|
||||
по инерции.
|
||||
|
||||
## Текст
|
||||
|
||||
- Сейчас: `fontdue` только растеризует глифы, раскладку строк и переносы делаем сами.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue