Просьба пользователя: «по возможности делай анимации». Записан план (A26) с
тем, что уже есть и чего нет.
Уже есть в formats: mdl.bones() (скелет: родители, позиции, кватернионы),
mdl.attachments(), vvd.vertices() (веса и кости по вершинам), vtx.body_parts()
(топология). То есть данные скелета и весов читаются — не хватает переноса их в
рендер.
Чего нет: разбора секвенций (mstudioseqdesc_t) и кадров из отдельного .ani
(mstudioanimdesc_t, сжатие кривой/дельтами); костей и весов в ModelVertex;
CPU-скиннинга; выбора секвенции по состоянию (ACT_MP_*) с блендингом.
Порядок: (а) секвенции и .ani в mdl.rs, (б) кости/веса в ModelVertex,
(в) CPU-скиннинг и заливка на GPU (механизм moved_ranges уже готов — тот же
путь, что у движущихся пропов), (г) проигрывание одной секвенции с циклом,
(д) выбор по состоянию и блендинг. Приёмка: модель двигается, ходьба переходит
в бег и присед, прыжок отдельной секвенцией.
Первый срез вьюмодели: модель оружия на том же рендере, что пропы и модель
игрока. Не рисовалась по двум причинам, обе найдены кадром:
1. разворот на 180° (нужный модели игрока) уводил ствол ЗА камеру: у моделей
оружия Source геометрия вынесена вперёд по оси модели (у пистолета ~47
юнитов, у монтировки −52 по Y);
2. привязка шла к origin модели, а надо к центру её габарита: у пистолета центр
≈(0, 0, 47), поэтому ствол уезжал выше кадра. Теперь смещение считается как
`глаз + 20 вперёд + 6 вправо − 10 вниз − повёрнутый центр габарита`.
Проверено кадром: `SOURCE_RS_VIEW_MODEL=models/weapons/v_pistol.mdl` — пистолет
стоит в кадре. По умолчанию берётся пистолет: `v_physgun.mdl` в ассетах нет
(это модель GMod, а не HL2), есть откат на монтировку.
Все 23 сьюта и 29 картовых тестов зелёные; разбор и посадка записаны в
docs/DIARY.md.
Замер: материал вьюмодели в мире — индекс 54, имя crowbar_cyl (виден в
--debug-materials). Рендер одним этим материалом (--only-material 54) даёт
пустой кадр, то есть геометрия и поза ни при чём — не доходит сам батч.
Записано, что проверять дальше: попал ли батч в renderer.batches после
refresh_batches (диапазоны индексов забираются в блоке физики — возможно,
раньше, чем обновление списка), совпадает ли batch.material с позицией
материала в world.materials, и не мешает ли фильтр --only-material.
Ещё две поломки на пути «новой геометрии»:
1. Буфер вершин мира создавался без COPY_DST, поэтому точечная заливка
диапазонов падала с ошибкой wgpu (у пользователя это уронило бы клиент —
поймано прогоном, а не тестом). Теперь VERTEX | COPY_DST, для индексов
INDEX | COPY_DST, добавлен upload_index_ranges.
2. Рендерер копировал список батчей при сборке, поэтому добавленная геометрия
(спавн) в кадр не попадала до полной пересборки. Добавлен
WorldRenderer::refresh_batches: когда появились новые индексы, список батчей и
признаки воды перечитываются, а полная пересборка нужна только при новой
текстуре.
Вьюмодель (A23, первый срез): создаётся тем же рендером моделей, следует за
взглядом, включается SOURCE_RS_VIEW_MODEL (по умолчанию физган, откат на
монтировку — v_physgun.mdl в ассетах не нашёлся). В кадре она пока не
появляется: создание работает, а звено «перенос позы каждый кадр + заливка»
нет — записано открытым вопросом в docs/DIARY.md.
Все 23 сьюта и 28 картовых тестов зелёные.
Жалоба пользователя: «физика вроде работает, но позиция рендера обновляется
только при спавне нового». Причина: мир двигал вершины в памяти, а буфер
рендера заливался один раз при сборке мира — потому пересборка рендерера при
спавне и «лечила» картинку.
Сделано: World::moved_ranges и take_moved_ranges (диапазоны заполняет
rewrite_instance, то есть любое движение пропа, модели игрока или физгана),
WorldRenderer::upload_vertex_ranges — точечная заливка queue.write_buffer по
этим диапазонам, и вызов в кадре клиента сразу после шага физики.
Тест probe_moving_prop_reports_vertex_ranges (диагностика, ignored) пока не
сходится и это записано честно: коробка в тесте задана в мировых координатах,
а меш обязан быть в локальных (видно по двойному смещению вершины), и список
диапазонов после step_physics пуст — проверить is_sleeping у тела после
телепорта. Проверка в интерактиве: заспавнить арбуз и посмотреть, падает ли он
на экране.
Все 23 сьюта и 28 картовых тестов зелёные; разбор в docs/DIARY.md.
Первый срез взаимодействия с пропами (то, что в GMod делает weapon_physgun):
ЛКМ берёт ближайшее тело под прицелом — луч из глаз, расстояние 8..260 юнитов,
допуск 40 в стороны, побеждает ближайшее; пока кнопка зажата, тело каждый кадр
телепортируется на луч взгляда на взятом расстоянии (углы сохраняются);
отпустил — тело свободно и падает само.
Добавлен переключатель SOURCE_RS_PHYSGUN=1: держит ближайшее тело без мыши —
нужен для проверки скриптом, а не руками (SDL-событий мыши в скрипте нет).
Проверка: код собирается, clippy чистый, все 23 сьюта зелёные. Интерактивно
проверить не смог — в скриптовых кадрах камера упирается в стены (наводить
нечем). Проверять у кучи пропов в районе -2930 -1370 -64: посмотреть на проп,
зажать ЛКМ. Записано в docs/DIARY.md.
Движок: геометрия модели вынесена в append_model_geometry (меш, материалы,
вершины с трансформацией, батчи со смещением индексов на вершины экземпляра).
Поверх неё World::spawn_prop — то же, что делает Q-меню GMod: геометрия, сущность
класса prop_physics (её видят Lua и физика), тело в мире физики по габаритам
меша, экземпляр пропа для move_prop.
Клиент: клавиша G — спавн пропа по взгляду (модель из SOURCE_RS_SPAWN_MODEL, по
умолчанию models/props_junk/watermelon01.mdl), и аргумент --spawn <модель> для
отладки и скриптов. Проп сразу попадает в габариты коллизии игрока — их клиент
пересобирает каждый кадр.
Проверено кадром: арбуз заспавнен в 96 юнитах по взгляду и отрисован
(--player-pos="-2438 -966 48", камера у "-2500 -1050 60|5 0"). Грабли записаны
в дневник: буферы рендера собраны на сборке мира, поэтому после спавна рендерер
пересобирается целиком — позже заменим до-аллокацией вершин.
Первый срез модели игрока, чтобы не блокировать Sandbox: рендер тот же, что у
пропов (статический меш PropMesh), скелет и анимации следующим срезом.
Движок: ModelInstance (экземпляр модели без сущности) плюс
World::spawn_model_instance (модель с диска, материалы с дедупликацией, вершины
с трансформацией, батчи) и World::move_model_instance; перезапись геометрии
вынесена в общий rewrite_instance, им пользуются и пропы.
Клиент: модель создаётся после разбора --player-pos и едет за игроком (позиция —
ступни, курс — взгляд, развёрнутый на 180°, потому что у моделей Source ось Y
смотрит влево). Включается переменной SOURCE_RS_PLAYER_MODEL: пустое значение —
models/player/police.mdl, иначе путь к модели.
Проверено кадром: модель стоит на площадке в -2438 -966 48, текстуры на месте,
вершин в мире стало 46359 против 43212 без модели. Грабли записаны в дневник:
индексы модели локальные, при вставке в общий буфер к ним прибавляется
first_vertex (без этого кадр превращался в мусор).
Заведён docs/DIARY.md — живой дневник состояния, замеров, инструментов и
грабель, чтобы уплотнение контекста ничего не теряло.
