Sprinter-SDCC/applications/PoP/docs/loose_floors_plan.md

Loose floors (проваливающиеся полы) — план порта

Разбор SDLPoP (seg007 loose/trob/mob, seg008 draw_loose). ПЛАН, ещё не реализовано. Тайл в комнате 1: [2,6] = 0x0B = tiles_11_loose.

1. Хранение состояния

• Тип тайла: curr_room_tiles[tilepos] & 0x1F == 11 (tiles_11_loose). Бит 0x20 = «solid» loose (авто-падающий вариант, ур.13 — от шага НЕ падает). После падения тайл → 0 (tiles_0_empty).
• Модификатор curr_room_modif[tilepos] = состояние анимации:
  • 0 — покой (обычный loose-пол);
  • 0x80..0x83 — трясётся (бит7); за ~4 кадра затухает обратно в 0;
  • 1..11 — обратный отсчёт до падения (на нём что-то стоит); достигает loose_floor_delay = 11 → падает.

2. Анимация тряски (shake) — когда включается

• Триггер = do_knock (seg007:0FE0): на ЖЁСТКОМ приземлении в кадрах посадки играет SEQ_KNOCK_DOWN → взводит knock → check_knock() → do_knock(room, curr_row − (knock>0)).
• do_knock(room, row): по всем колонкам ряда — если тайл loose → loose_make_shake().
• loose_make_shake() (seg007:0FB4): если modif==0 (и не ур.13) → modif = 0x80, add_trob(type 1).
• Отсюда кейс пользователя: Kid падает/приземляется на [2,4] → do_knock трясёт ВСЕ loose-тайлы ряда 2 → [2,6] трясётся. (Через knock-смещение ряда может задеть и соседний ряд.)
• animate_loose (кадрово): ++modif; при бите7 трясёт до >=0x84 → сброс в 0, trob.type=-1. loose_shake() играет звук (sound 20/21/22) по таблице loose_sound[].

3. Анимация падения (fall) — когда включается

• Триггер = make_loose_fall(1) (seg007:0EF6), вызывается когда:
  • Kid СТОИТ на loose-тайле — check_press() (seg006): кадр с FRAME_NEEDS_FLOOR над loose → make_loose_fall(1);
  • зацеп/подтягивание на loose (check_grab, check_jump_up);
  • пробой сверху: кадр 79 (jumphang) над loose → make_loose_fall(1);
  • авто-падающие (ур.13) — make_loose_fall(-(prandom&0x0F)).
• make_loose_fall(modifier): если НЕ solid (tiles & 0x20 == 0) и (sbyte)modif <= 0 → modif = modifier, add_trob(type 0).
• animate_loose: ++modif; когда modif >= 11 (loose_floor_delay) → remove_loose() (тайл → empty) + add_mob() (спавн падающего куска).

4. Падающий кусок (mob)

• add_mob() кладёт curmob в mobs[] (до 14). do_mobs() каждый кадр: move_mob() (гравитация, y растёт) + check_loose_fall_on_kid() (урон Киду/страже, если попал).
• Приземление куска → тайл под ним curr_room_tiles[...] = tiles_14_debris (seg007 move_mob:1053). Т.е. loose(11) упал → сверху empty(0), снизу debris(14).

5. Отрисовка по статусу

• Куски тайла: loose_fram_left[]={41,69,41,70,70,41,41,41,70,70,70,0}, loose_fram_right[]={42,71,...}, loose_fram_bottom[]={43,73,...} (env-спрайты, seg008:518/596/608).
• Индекс кадра = get_loose_frame(modifier) (seg008): 0 = ровный (41/42/43); 1..10 = дрожащие варианты (69–74); при бите7/большой задержке — низкие индексы.
• До падения: рисуем loose с get_loose_frame(modif) (0 = ровно, иначе колеблется). После: сверху empty, снизу debris(14) — обычная статическая отрисовка (у нас уже есть tile 0x0E/14 debris в tile_table).

6. Что нужно в нашем движке (сейчас НЕТ)

Наш pop_bg рисует комнату СТАТИЧЕСКИ один раз. Loose-полы требуют динамического тайлового слоя:

1. Массив модификаторов room_modif[30] (у нас есть bg[30] — можно переиспользовать/рядом) — состояние каждого тайла.
2. Очередь trob (список анимируемых тайлов) + animate_loose пер-кадр → перерисовка ТОЛЬКО изменившихся тайлов (как heal-прямоугольник Kid).
3. make_loose_fall / do_knock / loose_make_shake — триггеры (из физики Kid: приземление→knock, стойка на loose→fall).
4. mob-система (падающий кусок): минимум 1–2 mob'а, гравитация, приземление → debris. Урон Киду (check_loose_fall_on_kid) — можно Фазой 2.
5. Перерисовка тайла: draw_tile(row,col) у нас уже умеет loose (code==11, loose_fram_* в env) — нужно вызывать его выборочно с текущим модификатором (сейчас draw_tile берёт статический bg).

Порядок реализации (предложение):

• L1: room_modif[] + выборочная перерисовка тайла по модификатору (draw_loose с get_loose_frame) — статика→динамика одного тайла.
• L2: trob-очередь + animate_loose (тряска по do_knock на приземлении).
• L3: make_loose_fall (стойка на loose) + отсчёт + remove → empty.
• L4: mob (падающий кусок → debris снизу).
• L5: урон Киду от падающего куска.

Конкретика из SDLPoP (сверено 2026-07-18, готово к реализации)

Таблицы (seg008.c), индекс = get_loose_frame(modif):

• loose_fram_left[] = {41,69,41,70,70,41,41,41,70,70,70,0}
• loose_fram_right[] = {42,71,42,72,72,42,42,42,72,72,72,0}
• loose_fram_bottom[]= {43,73,43,74,74,43,43,43,74,74,74,0}
• get_loose_frame(m): если (m&0x80) (или delay>11) → m&=0x7F; if(m>10) return 1; → return m;
• y_loose_land[] = {2,65,128,191,254} (mob), loose_floor_delay = 11.

Триггеры (call-sites):

• make_loose_fall(modifier=1) — из check_press() (seg006): когда Kid СТОИТ на тайле (FRAME_NEEDS_FLOOR, action < hang_climb / turn / bumped) и get_tile_at_char()==11; ИЛИ frame==79 (прыжок вверх) и get_tile_above_char()==11 (пробой сверху). tile_is_floor(11)==1 — Kid стоит на loose (start_fall НЕ зовётся). Тело: if(!(tile&0x20) && (sbyte)modif<=0){ modif=modifier; add_trob(type0); }
• do_knock(row) — на ЖЁСТКОМ приземлении (SEQ_KNOCK_DOWN→check_knock, seg003): по всем колонкам ряда if(tile==11) loose_make_shake() (if(modif==0){ modif=0x80; add_trob(type1); }).
• animate_loose (каждый кадр, seg007:816): ++modif; если &0x80 (тряска): if(modif>=0x84){modif=0; trob=-1;}; иначе (отсчёт): if(modif>=11){ remove_loose(tile→0); trob=-1; add_mob(); } else shake.

Интеграция в наш движок (roomtest) — подход

Наш движок ПЕКЁТ комнату один раз (двойной буфер: своя ОЗУ-копия на страницу). Loose требует динамики + общего состояния pop_map↔pop_bg:

1. Общая МУТАБЕЛЬНАЯ копия комнаты: roomtest.c держит uint8_t room_fg[30] (копия room1_fg) и передаёт ОДИН указатель и в pop_room_draw, и в pop_map_set → мутации loose видны обоим. (Сейчас g_fg — const; сделать неконстантным.)
2. Состояние: uint8_t pop_loose_modif[30] (0 / 0x80.. / 1..11).
3. Модель (pop_map): check_press() в pop_phys_tick (make_loose_fall при стоянии на 11), animate каждый кадр.
4. Перерисовка (pop_bg, на back-странице каждый кадр):
   • тряска/отсчёт (код всё ещё 11): gfx_heal(tile rect) (вернуть печёный фон) + нарисовать loose-кадр (left/right/bottom по get_loose_frame) банком SPRITE;
   • падение (11→0): mutate g_fg[pos]=0 + «запечь пустоту» на ОБЕИХ страницах (bake-счётчик 2: чёрный bar + draw_tile empty банком NORMAL на текущей странице 2 кадра подряд) → дальше heal показывает пусто.
5. L4 mob: падающий кусок → debris(14) снизу (y_loose_land); пока отложено — упавший loose = пусто. L5 урон — позже.

Риск: перерисовка динамического тайла в двойном буфере (per-page heal + bake) — единственное тонкое место; остальное — прямой порт логики выше.

Связанные

Триггеры завязаны на физику Kid (pop_hang_state check_press/check_grab, приземление land/SEQ_KNOCK_DOWN). Отрисовка — pop_fore_layer / pop_background_strategy (draw_tile уже знает loose_fram_*).