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.
6.4 KiB
UI
UI Fabrilis — это редактор и отладочный оверлей внутри приложения, а не отдельный
UI-фреймворк и не библиотека для чужих программ. Окно обычное прямоугольное,
управление окном и вводом — на winit (D24), рисование — на нашем wgpu-рендере,
готовые UI-библиотеки не берём (D20).
Модель
- Immediate-mode на старте. UI каждый кадр строит список команд рисования (прямоугольник, скруглённый прямоугольник, линия, текст, картинка, клип), рендер батчит их. Состояние виджетов живёт в приложении, а не в дереве UI.
- Retained-дерево только по доказанной нужде. Если профилирование покажет, что
пересборка команд дорога, вводим стабильные
NodeId, dirty-флаги и кеш ресурсов. Reconciliation и анимационный граф заранее не пишем. - Event-driven redraw. Нет изменений — нет кадра. Каждый кадр имеет причину
(
Input,Animation,Resize,SimulationTick,Debug), счётчик причин виден в оверлее; в простое — 0 кадров/с. - Кеш ресурсов. Пайплайны кешируются по
shader + layout + format + blend; текст — через общий glyph atlas, а не текстуру на надпись. Offscreen-проходы только там, где эффект этого требует. - Capability-модель. Вместо
bool—Available | Unavailable { reason } | Conditional { reason }: «нет прозрачности», «fractional scale не поддержан», «эффект недоступен на этом backend'е». Не выполнять молча.
Что есть в M4 и M10
| Этап | UI |
|---|---|
| M4 | оверлей отладки: FPS/RTF, число тел, причины кадров, время подсистем; прямоугольники, текст, линии, клип |
| M10 | панели и сплиттеры, дерево конструкции, таблица свойств, графики, 3D-вид, диалоги, текстовые поля |
Виджеты вводятся по одному и только под конкретную задачу редактора. Зоопарк «на будущее» запрещён (KISS).
Управление (M4)
В окне одна сцена: тележка на террейне. Ввод задаёт только цель моторов на границе кадра и не меняет шаг симуляции.
| Ввод | Действие |
|---|---|
W / S |
газ вперёд / назад (тележка) |
A / D |
поворот влево / вправо (тележка) |
| Стрелки | камера: вперёд/назад, влево/вправо |
Q / E |
камера вниз / вверх |
Shift |
ускорить камеру |
| ЛКМ + мышь | обзор камерой |
Escape |
выход |
Когда клавиши отпущены, цель моторов — ноль: тележка тормозит, а не катится по инерции.
Текст
- Сейчас:
fontdueтолько растеризует глифы, раскладку строк и переносы делаем сами. Для латиницы и кириллицы этого достаточно. - Текстовые поля требуют shaping и IME. Решение отложено до M10: кандидаты —
cosmic-textилиParley(+glyphonдля wgpu). Берём только когда появляется настоящее поле ввода, с записью в DECISIONS.md. - Курсор, выделение, копирование и IME не эмулируем частично: либо полноценно, либо поле ввода не выпускаем.
Что взято из ShapeUI blueprint
Локальная копия: ref/shapeui-blueprint_v0.2_revised_ru.md (в git не входит).
Из него берём идеи, не архитектуру:
- event-driven redraw и счётчик причины кадра;
- render command list и батчинг вместо draw call на виджет;
- общий glyph atlas;
- раздельные dirty-флаги (стиль, layout, текст, геометрия);
- capability-модель вместо обещаний
bool; - оверлей диагностики: PSS/RSS, draw calls, offscreen passes, кеши, причина кадра;
- дисциплину «сначала панели/текст/ввод, потом виджеты».
Что из ShapeUI не берём
- Окна произвольной формы, click-through,
wl_region,set_input_region: у нас обычное окно, этим занимаетсяwinit. - Свой Wayland-backend и raw
wl_surface: дублируетwinit. - CPU-рендерер, Vello, несколько backend'ов, morphing, shader marketplace.
- Собственный scene graph с реконсиляцией до доказанной необходимости.
- Доступность (AccessKit) с первого дня; вернёмся к ней перед публичным релизом.
Диагностика
Оверлей показывает то, что можно проверить:
PSS / RSS 38.4 / 51.1 MiB (estimated)
draw calls 6
offscreen 1
pipelines 5
glyph atlas 2.1 MiB
frames last 10s 0
last frame Idle
Числа не выдаются за «всю VRAM процесса»; приблизительные помечаются estimated.
Открыто
- Shaping и IME для текстовых полей:
cosmic-textилиParley, решаем на M10. - Нужен ли retained-слой: решаем по профилировке M10, не заранее.
- Графики: своя простая отрисовка линий и областей; библиотеку не берём.