BUG-DOOR-CLIP: обрезка силуэта правым косяком двери уровня

Симптом (нашёл пользователь сразу после L1-EXIT): при подъёме по лестнице за
дверью уровня силуэт Кида вылезал ПРАВЕЕ правого косяка проёма; по высоте
обрезка была корректна.

Причина — недопортированная половина clip_char (seg006:1231).  Для кадров
двери оригинал ставит ДВА клипа, у нас был только первый:
    obj_clip_top   = leveldoor_ybottom + 1;   // было
    obj_clip_right = leveldoor_right;          // не было
Отдельная ловушка: комментарий в SDLPoP говорит «frames 217..228», а КОД
проверяет >= frame_224_exit_stairs_8, то есть 224..228 — портировано по коду.

Fore-слоем это не лечится: створка и косяк уходят в оригинале целиком в
backtable (draw_leveldoor, все add_backtable), рисуются ПОД персонажем и
перекрыть его не могут.  Единственный способ — срезать сам спрайт.

libbgi: gfx_blit_cols_part_w(..., uint8_t maxw) — обрезка СПРАВА у
колоночного блита.  Для column-major это ровно уменьшение числа колонок, то
есть внутри ядра механизм уже был (так же клипается край экрана,
w = _bgi_maxx + 1 - x), наружу не выводился.  Тело блита переехало туда,
gfx_blit_cols_part стал тонкой обёрткой (maxw=0) — тем же приёмом, каким
gfx_blit_cols уже обёрнут вокруг gfx_blit_cols_part.  Работает и при flip:
первые maxw нарисованных колонок всегда ложатся в левую часть футпринта.
make size-check: роста нет.

PoP: pop_leveldoor_right / pop_leveldoor_ybottom (порт одноимённых глобалов)
пишет draw_leveldoor в pop_state — их читает clip_char из другого банка;
pop_clip_char_right() отдаёт границу, kid_draw превращает её в maxw и уводит
эти кадры с noclip-пути на общий.  Прямоугольник heal (kid_lw) сужается тоже
— стираем ровно нарисованное.

Проверено в MAME: pop_leveldoor_right = 176, что есть ровно (draw_xh<<3)+48
для двери комнаты 9; pop_leveldoor_ybottom = 112 у закрытой створки и 69 у
поднятой — сходится с формулой оригинала.  Отрисовку подтвердил пользователь
на живом подъёме.

Заодно: ROOMNAV остаётся включённым осознанно — это наш чит, которого в
оригинале не было, как и S/K/I; позже сведём в общий блок читов.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Александр Петров
2026-08-01 23:43:01 +03:00
parent e86f254b87
commit ba37bd1133
12 changed files with 224 additions and 111 deletions
+7 -52
View File
@@ -14,63 +14,17 @@ odd-pixel арифметика `char_x`, подстановка тайла на
починена кодом ещё в июле, список просто отстал — чем именно закрыта каждая,
расписано в [`bug_closed.md`](bug_closed.md)).
**Открытых багов нет.** Осталось только незакрытое по оптимизации и
незаконченная ревизия комнат:
| ID | что | тип |
|----|-----|-----|
| [BUG-DOOR-CLIP](#bug-door-clip) | Кид не обрезается правым косяком двери уровня | Medium |
| [T-1](#t-1) | пики перерисовываются безусловно | оптимизация |
| [T-2](#t-2) | Кид перерисовывается в покое | оптимизация |
| [обход 24 комнат](#обход-всех-24-комнат-уровня-1) | таблица заполнена на 5 строк из 24 | ревизия |
---
<a id="bug-door-clip"></a>
## BUG-DOOR-CLIP. Подъём по лестнице двери уровня: нет обрезки по правому косяку — **Medium**
**Симптом (2026-08-01, найден пользователем сразу после L1-EXIT):** при
подъёме по лестнице за дверью уровня (seq_70, кадры 224..228) силуэт Кида
вылезает ПРАВЕЕ правого косяка проёма — должен уходить за него. По ВЫСОТЕ
обрезка корректна.
**Причина — недопортированная половина `clip_char`** (seg006:1231). Для
кадров двери уровня оригинал ставит ДВА клипа, а мы портировали только
первый:
```c
if (frame >= frame_224_exit_stairs_8 && frame < 229) {
obj_clip_top = leveldoor_ybottom + 1; // ЕСТЬ (pop_clip_char_top)
obj_clip_right = leveldoor_right; // НЕТ
}
```
`leveldoor_right = (draw_xh << 3) + 48` считается в `draw_leveldoor`
(seg008:1D29) от колонки ЛЕВОЙ половины двери; для palace-уровней (+8,
`tbl_level_type`) — на уровне 1 не применяется.
Обратить внимание: комментарий в SDLPoP говорит «frames 217..228», а КОД
проверяет `>= frame_224_exit_stairs_8`, то есть **224..228**. Портировать по
коду.
**Чего не хватает в движке:** обрезки СПРАВА у колоночного блита.
`gfx_blit_cols_part` (libbgi) умеет только обрезку сверху (`skip`/`rows`) плюс
клип по краю ЭКРАНА (`w = _bgi_maxx + 1 - x`). Для column-major спрайта
обрезка справа — это ровно уменьшение `w`, то есть внутри ядра она уже есть,
не хватает способа задать её снаружи.
**План (не начат):**
1. libbgi: тело `gfx_blit_cols_part` вынести в вариант с ограничением
ширины (напр. `gfx_blit_cols_part_w(..., uint8_t maxw)`), а нынешнюю
функцию оставить тонкой обёрткой — тем же приёмом, каким `gfx_blit_cols`
уже обёрнут вокруг `gfx_blit_cols_part`. Флип тут не мешает: в кадрах
двери направление всегда dir_FF_left, то есть flip=0.
2. PoP: `pop_clip_char_top` дополнить правым клипом (или завести
`pop_clip_char_right`), считать `leveldoor_right` от колонки двери.
3. `make size-check` (трогаем libbgi) + проверка стоп-кадром в MAME:
поймать кадр 224..228 клавишей `1` и сверить кромку.
**Пока не починено, дефект косметический** — вход на следующий уровень
работает.
---
# Оптимизация отрисовки (записано 2026-07-29)
@@ -181,6 +135,7 @@ Kid ставится на первый пол, `pop_trob_reset()` возвращ
- Читы (`pop_cheat.h`): **K** — убить стража, **I** — бессмертие (toggle),
**S** — выдать меч.
- Респавн после смерти — по **↑** (или авто через `RESPAWN_DELAY`); ставит
Kid в `START_ROOM`.
- `START_ROOM=1 / COL 3 / ROW 0`жёстко зашитый тестовый старт; перевести
на `pop_level_start_*` (задача L1-START в [`TASKS.md`](TASKS.md)).
Kid в стартовую позицию УРОВНЯ (`pop_start_level`, порт do_startpos).
- **ROOMNAV (`=`/`-`)тоже наш чит**, которого в оригинале не было, как и
`S`. Все они со временем съедутся в общий блок читов, разрешаемый в
настройках; пока просто включены (`pop_cheats = 1` в `roomtest.c`).