# ЦИАН фаза (персонажи + передний слой) — анализ и оптимизация

Рабочий документ: живёт между сессиями.  Внизу **журнал правок** — каждая
запись с замером до/после.  Сцена, рецепт воспроизведения и зонды —
[`perf_l13_room23.md`](perf_l13_room23.md); там же ответ про 8-битные
габариты.  Парная фаза — [`perf_green_phase.md`](perf_green_phase.md).

Границы фазы в `roomtest.c`: от `PROF(6)` (строка 620) до `PROF(0)`
(строка 677).  Содержимое: `pop_check_mirror`, `pop_loose_mob_draw`,
соперник, `pop_char_draw(KID)`, `pop_loose_mob_draw_over`, `pop_fore_needed`,
`pop_hp_draw`, `pop_char_fore(KID)`, `pop_cd_clear`,
`pop_room_clip_borders`.

**Бюджет: ≤ 400 000 тактов (растровый кадр = 430 000).**

| состояние | циан |
|---|---:|
| покой, Кид пропущен (`pop_char_skip_mask`) | 20 550 … 28 700 |
| Кид перерисовывается, кусков нет | 107 000 … 193 000 |
| **пик каскада (6 кусков в воздухе + Кид)** | **632 000 (1,6× бюджета)** |

---

## 1. Раскладка (замер 2026-08-17, `c312e4a`)

### 1.1 Подфазы (три готовых `PROF(6)`: 0x4BCE / 0x4C26 / 0x4C93)

| участок | покой | пик (кадр 20) | максимум |
|---|---:|---:|---:|
| `pop_check_mirror` + `pop_loose_mob_draw` (куски ПОД Кидом) + соперник | 23 250 | 34 950 | **154 512** |
| `pop_char_draw(KID)` + `pop_loose_mob_draw_over` + `pop_fore_needed` + HP | 3 726 | **445 284** | 445 284 |
| `pop_char_fore(KID)` + `pop_cd_clear` + чистка бортов | 1 722 | **150 978** | 150 978 |

### 1.2 Блиты кусков

Блитов в циане — **19 на кадр**: шесть кусков × три части спрайта
(`env 74` = 32×3, `env 70` = 32×13, `env 72` = 26×16, порт `draw_mob`
seg007:13E5 / индексы `loose_fram_*[10]`).

| | такты |
|---|---:|
| Σ 19 блитов | **313 758** |
| на вызов | **16 273** |

То есть **половина фазы — это девятнадцать вызовов `pop_blit_b`.**

### 1.3 Внутри одного `pop_blit_b` (157 замеров быстрого пути, зонды b1..b5)

| участок | такты | доля |
|---|---:|---:|
| `atlas_image` + `gfx_w0_map` + чтение габарита | 1 086 | 7 % |
| ядро блита (libbgi, `gfx_blit_noclip`) | 10 422 | 64 % |
| **`pop_cd_touch` — пометка «фон тронут»** | **4 502** | **28 %** |
| `gfx_w0_unmap` + возврат | 264 | 2 % |
| ИТОГО | 16 273 | |

Для сравнения, клипованный путь (227 замеров, полоса у потолка): ядро
`blit_b_clip` **14 088**, итого на вызов **16 409**.

По модели `blit_cost_model` «железный» минимум передачи для этих трёх
спрайтов — 5 000 … 6 200 тактов.  Остальные ~10 000 на вызов — накладные.

### 1.4 `pop_char_fore(KID)` вырастает в каскаде на два порядка

В покое 1 722, в кадрах каскада **150 978**.  Кид стоит у правого края и НЕ
двигается, плиты падают в колонках 2..7 — то есть либо пропуск персонажа
(`pop_char_skip_mask`) гасится пометками `pop_cd_touch` от кусков, либо окно
fore-клипа расширяется и в него попадают лишние тайлы.  **Не разобрано** —
см. C4.

### 1.5 Кодоген

| функция | стековый кадр | обращений `(ix)` | ожидаемо тактов |
|---|---:|---:|---:|
| `blit_b_clip` (резидент) | **22 Б** | **211** | ~9 700 |
| `pop_blit_b` (резидент) | 6 Б | 78 | ~3 600 |
| `pop_cd_touch` (резидент) | — | 30 | ~1 380 |
| `mob_draw_pass` (bank 7) | 18 Б | 20 | ~900 |
| `mob_render` (bank 7) | — | 1 | — |

Одно `-N(ix)` ≈ 19 номинальных тактов ≈ 46 замеренных
(memory `sprinter_wait_states_2x`).

---

## 2. Способы ускорения

По убыванию отдачи.

### C1. Убрать избыточный `pop_cd_touch` в `mob_render`

**Отдача: −81 000 (13 % фазы).  Самая дешёвая правка из всех.**

`pop_loose_mob_tick` уже помечает **весь коридор куска** одним вызовом
`pop_cd_touch(MOB_X0(m->x), m->y - 27 + POP_YOFF, MOB_W, 64)` — с запасом на
путь, пройденный за кадр.  А потом три блита внутри `mob_render` помечают
подмножества этого же прямоугольника, по 4 502 такта каждый: 3 × 4 502 × 6
кусков = **81 000 тактов впустую**.

Механизм уже есть: `pop_cd_batch_begin()` / `pop_cd_batch_end()` (в
`pop_tile.c`, применяется в `draw_tile`) — в пакете `pop_cd_touch` только
копит общий прямоугольник четырьмя сравнениями.  Обернуть `mob_render` в
скобку.

Осторожно: пометка обязана покрывать **весь коридор heal'а**, а не габарит
спрайта — иначе персонаж, попавший в расширенную часть коридора, стирается,
но перерисовать себя не просит и исчезает с экрана (ровно этот баг ловили
2026-08-13: в комнате 23 после падения гряды пропадал Кид).  Поскольку
коридорную пометку из тика мы НЕ трогаем, инвариант сохраняется.

### C2. `pop_cd_touch` — байтовые аргументы

**Отдача: часть от 4 502 на вызов; после C1 в циане останется 6 вызовов
(по одному на кусок), но в зелёной фазе и в fore-проходе их больше.**

Четыре `int`-аргумента на вызов, 30 `(ix)` внутри.  `w`/`h` заведомо ≤ 255
(габарит спрайта ≤ 56×63), `x`/`y` — экранные, 16-битные.  Это позиция (а)
задачи OPT-BLIT.

### C3. `blit_b_clip` — 22 Б кадра, 211 `(ix)`

**Отдача: 14 088 → ~10 500 на клипованный блит.**  В циане клипованный путь
берут спрайты у краёв поля и весь fore-проход; в зелёной фазе — все блиты
полосы у потолка.  Подробнее — [`perf_green_phase.md`](perf_green_phase.md) §G3.

`sx/sy/dw/dh` → `uint8_t`, `dx/dy` оставить 16-битными.  Прецедент: тот же
приём в `pop_blit_b` (коммит `c312e4a`) дал −19 % на клипованном пути.

### C4. Разобрать `pop_char_fore(KID)`: 1 722 → 150 978

**Отдача неизвестна, но это 24 % фазы — мерить обязательно.**

Гипотезы (проверять зондами, не рассуждением — memory
`defer_unexplained_quirks`):

1. пометки `pop_cd_touch` от кусков гасят `pop_char_skip_mask` для Кида, хотя
   куски падают в других колонках — проверить `pop_cd_dmask` в кадре;
2. `mob_mark_neighbour` ставит `pop_set_redraw_fore` на 1–2 тайла на каждый
   кусок каждый кадр (порт `draw_mob`, seg007:1147), и `pop_fore_needed`
   перерисовывает передние части 6–12 тайлов;
3. окно fore-клипа Кида расширено под клинок и брызги, и в него попадает
   больше тайлов, чем нужно — известный пункт 1 в `perf_backlog.md`
   («футпринт персонажа — брать из физики»): оригинал расширяет футпринт
   только на одну колонку при вынутом мече и объединяет с футпринтом прошлого
   кадра, а мы расширяем окном клипа.

Зондов на подфазы циана больше нет — понадобятся временные `pop_dbg_*`
вокруг `pop_fore_needed` и `pop_char_draw`, то есть пересборка (после неё
ВСЕ адреса зондов меняются, брать заново из `roomtest.map`).

### C5. Один `gfx_w0_map`/`unmap` на группу блитов

**Отдача: 1 086 + 264 = 1 350 на вызов; три части одного куска лежат в одной
странице атласа → −2 700 на кусок, −16 000 на кадр.**

Позиция 3 старого `perf_backlog.md`.  Нужна форма «открыть страницу, N
блитов, закрыть»; мешает то, что `pop_blit_b` — общий лист для всех
вызывающих.  Для `mob_render` (три блита из одного атласа `pop_env`) частный
случай тривиален.

### C6. Размеры ленты — из каталога атласа

**Отдача: часть от 1 086 на вызов.**  Позиция 2 старого `perf_backlog.md`:
`fw`/`fh` уже лежат в записи каталога (8 байт: `offset u16, fw u8, fh u8,
nx u8, ny u8, резерв u16`), и у всех фоновых лент `nx = ny = 1`, то есть они
в точности равны `w`/`h` из шапки.  `atlas_image` их читает и выбрасывает.

### C7. objtable вместо отдельного fore-прохода на персонажа

Позиции 5 и 6 старого `perf_backlog.md` — большой рефакторинг, браться только
если после C1–C5 бюджет всё ещё не выполняется.  Оригинал кладёт персонажей и
куски в `objtable` и рисует их при обходе тайлов
(`draw_objtable_items_at_tile`), а порядок окклюзии получается сам; у нас
отдельный fore-проход НА КАЖДОГО персонажа.

---

## 3. Что НЕ делать

- **Не ставить W3-скобку из кода с `--w3`** — белый экран
  (memory `gfx_blit_noclip_fast`).
- **Не ускорять передачу пикселей** — предел железа
  (memory `blit_cost_model`).
- **Не возвращать клип куска по `clip.right = 40`** оригинала
  (`add_mob_to_objtable`, seg007:1161): единицы этого поля не выяснены,
  буквальные 40 экранных пикселей срезают правый задний угол плиты
  (прогон 2026-08-13).

---

## 4. Журнал правок

| дата | что сделано | циан: покой / Кид / пик | коммит |
|---|---|---|---|
| 2026-08-17 | базовый замер (до правок этой серии) | 20 550 / 193 000 / **632 000** | `c312e4a` |