Всем привет! Последние пару недель я делал мод для Euro Truck Simulator 2: Spotify прямо на штатном экране навигации в кабине. Обложка, название трека, прогресс, всё на приборке. Я вообще люблю прикручивать Spotify туда, куда не просят, в прошлый раз это был Genius.
Небольшой дисклеймер. Вообще я бэкенд-разработчик и пишу в основном на Go и TypeScript. Плагины для ETS2 — это нативные DLL с C-интерфейсом, поэтому мод я писал на C++, так что строго не судите. Чтобы код получился более-менее приличным, я сверялся с гайдом cpp-best-practices: сборка с /W4 /WX и дополнительными предупреждениями, статический анализатор MSVC и AddressSanitizer в CI, clang-format, unit-тесты и офлайн-стенд, который гоняет мод без игры. Если опытный плюсовик увидит что-то странное, буду рад замечаниям.
Официальный SDK игры умеет только отдавать телеметрию: скорость, пауза, какой грузовик. Рисовать он не умеет. Поэтому мод перехватывает Direct3D 11 и в нужный момент подсовывает игре вместо картинки навигатора свою текстуру. Сам перехват оставлю за кадром, а в этой статье расскажу про задачу, на которую ушло больше всего времени: как понять, какая из текстур игры и есть экран навигатора. Без исходников игры, без отладочной информации, только то, что видно снаружи.
Экран — это просто текстура
Игра не рисует навигатор прямо на модели. Сначала она рисует картинку экрана в отдельную текстуру (render target), а потом натягивает её на модельку экрана, как самую обычную текстуру. Значит, если подменить текстуру в тот момент, когда игра отдаёт её шейдеру, на экране окажется моя картинка.
Отдаёт текстуры шейдеру вызов PSSetShaderResources, его я и перехватил. Оставалось понять, какую текстуру подменять. Я ожидал что-то широкоформатное, под форму экрана, условно 1024×512. Забегая вперёд: не угадал.
Красим всё подряд
Раз я не знаю, какая текстура нужна, пусть игра покажет сама. Я сделал диагностический режим: каждый render target, который игра берёт в шейдер, подменяется розовой полосатой заглушкой с крупным номером. Номер это просто индекс текстуры в моём списке.
Какие текстуры попадают в список, решает простой фильтр:
const bool shape = (td.BindFlags & D3D11_BIND_RENDER_TARGET) &&
td.SampleDesc.Count == 1 && td.ArraySize == 1 &&
!(td.MiscFlags & D3D11_RESOURCE_MISC_TEXTURECUBE) &&
td.Width >= 64 && td.Height >= 64;
Одно исключение пришлось добавить сразу: буферы размером с экран и их уменьшенные копии (½, ¼ и так до 1/32, так устроены bloom, SSAO и прочая постобработка). Если подменить и их, вместо кадра получается розовая каша. Заодно выяснилось, что игра рендерит сцену не в 1920×1080, а в 2880×2160: у меня в настройках стоит масштабирование. Так что «размер экрана» пришлось определять по самому большому буферу, а не по окну.
Заходим в кабину, жмём кнопку, и вот что получается:
На одном кадре сразу несколько находок:
- На приборке
#30, это дисплей в щитке приборов. - Зеркала тоже текстуры (
#33,#34). Логично: отражение в зеркале это отдельный рендер сцены с другой камеры. - Порозовели даже машины на парковке, видимо, им достались текстуры отражений.
- А на навигаторе номер обрезан. Это первая подсказка: экран показывает не всю текстуру, а только кусок из её середины.
Дальше режим «по одной»: подменяется только одна текстура, я листаю номера кнопками, пока заглушка не окажется на навигаторе, и подтверждаю, мод записывает её описание в файл. И тут сюрприз: экран навигатора это квадратная текстура 256×256 с флагом GENERATE_MIPS (игра сама строит ей уменьшенные копии, mip-уровни). Никакого широкоформата: на экран идёт только полоса посередине, меньше половины высоты.
Номер каждый раз разный
Нашёл, отлично. Только номер это порядок, в котором текстуры попались мне на глаза, а адрес текстуры меняется при каждом запуске и в каждом грузовике. Нужно правило, а не номер.
Первое наблюдение: все экраны в кабине, и навигатор, и дисплей в щитке, это render target'ы с GENERATE_MIPS размером не больше 1024. Среди остальных render target'ов игры таких я не встретил. Получилось определение «дисплея»:
bool IsDisplay(const D3D11_TEXTURE2D_DESC& d) {
return (d.MiscFlags & D3D11_RESOURCE_MISC_GENERATE_MIPS) &&
(d.BindFlags & D3D11_BIND_RENDER_TARGET) && d.ArraySize == 1 && d.Width >= 64 &&
d.Height >= 64 && std::max(d.Width, d.Height) <= 1024;
}
Но дисплеев несколько, и навигатор надо отличать от щитка. Для этого я сделал запись кадра: несколько кадров подряд мод пишет в лог каждую смену render target'а и каждую текстуру, которую берёт шейдер. Такой RenderDoc на коленке. В логе цепочка видна как на ладони:
карта (1024×1024, без мипов, перерисовывается каждый кадр)
→ дисплей 256×256 → дисплей 256×256 навигатор
UI щитка → дисплей 512×512 → дисплей 512×512 щиток приборов
сцена: модельки экранов берут последний дисплей каждой цепочки
Выходит, навигатор это дисплей, в начале цепочки которого карта. А карта это обычный render target без мипов. Первая версия так и работала: раз в несколько секунд искала дисплеи, которые рисуют из обычного render target'а, и брала самый большой.
Спидометр украл мой плеер
Всё работало ровно до первого выхода из меню паузы. После меню плеер переехал с навигатора на дисплей в щитке, прямо между спидометром и тахометром.
Оказалось, игра подмешивает в дисплеи ещё одну текстуру без мипов, судя по всему, кеш шрифтов. После меню щиток тоже начал из неё рисовать и по моему правилу стал выглядеть «подключённым к карте». А так как он больше навигатора (512 против 256), выбор пал на него.
Отличие нашлось простое: карту игра перерисовывает каждый кадр, а кеш шрифтов нет. Значит, картой считаем только тот render target, в который рисовали в этом же кадре.
И вторая находка оттуда же: текстуры дисплеев берутся из общего пула, и игра может отдать «мою» текстуру другому дисплею. Поэтому решение теперь принимается заново каждый кадр: как только в мою текстуру нарисовали что-то без карты, подмена прекращается.
Итоговый алгоритм
Каждый кадр мод собирает граф «какой дисплей из чего рисовал» и решает так:
- Дисплей, который рисовал из обычного render target'а, перерисованного в этом же кадре, показывает карту.
- «Показывает карту» передаётся по цепочке: дисплей, который рисовал из такого дисплея, тоже показывает карту.
- Кандидаты — дисплеи с картой в конце цепочки, то есть те, которые никто больше к себе не рисует.
- Выбор «липкий»: текущая текстура остаётся, пока она кандидат. Иначе берётся размер, сохранённый для этого грузовика, иначе самый маленький, экраны навигации маленькие.
Шаги 1 и 2 в коде:
for (const auto& [display, sources] : f.plainSources) {
for (TextureId s : sources) {
if (f.rendered.count(s)) { // в этот render target рисовали в этом кадре
a.showsMap.insert(display);
break;
}
}
}
for (bool changed = true; changed;) {
changed = false;
for (const auto& [display, sources] : f.displaySources) {
if (a.showsMap.count(display)) { continue; }
for (TextureId s : sources) {
if (a.showsMap.count(s)) {
a.showsMap.insert(display);
changed = true;
break;
}
}
}
}
Всё это происходит на потоке рендера, а PSSetShaderResources игра вызывает тысячи раз за кадр. Поэтому в горячем пути никаких аллокаций, а вся тяжёлая работа делается один раз в конце кадра. По моим замерам хук добавляет к вызову от 4 до 12 наносекунд.
А для старых грузовиков, где навигатора нет вовсе, есть ручной выбор: в режиме подгонки можно пролистать дисплеи и закрепить плеер, например, на экране в щитке.
Заключение
Главное, что я вынес из этой истории: когда не знаешь, как устроена чужая программа, проще всего заставить её показать себя. Пронумеровать всё подряд оказалось быстрее любых догадок, а запись кадра превратила гадание в чтение лога. Мне было интересно в этом копаться, надеюсь, и вам было интересно читать.
Исходный код — на GitHub:
👉 ets-spotify