snark13
844fa6d767
Порт seg003:0798..08A9 + seg004:0239 + seg002:081D/1131 + seg006:1945. - is_obstacle (pop_map.c): ветка зеркала — Кид, кадры бегового прыжка 39..43, направление ВЛЕВО -> modif = 0x56, pop_jumped_mirror = -1, препятствия нет (пролетает насквозь). - mirror_image / jump_through_mirror / pop_check_mirror (pop_map.c): отражённый Char уходит в слот Guard как CHARID_1_SHADOW, guardhp = hitp_max, у Кида hitp_curr = 1. savekid НЕ делается — как в оригинале, отражается только копия. Полосы HP перерисует pop_hp_draw сам. - pop_check_mirror() зовётся из главного цикла ПЕРЕД отрисовкой персонажей (в оригинале — первая строка draw_people, seg008:228A). - autocontrol_shadow + autocontrol_shadow_level4 + clear_char (guards.c): тень идёт СВОЕЙ веткой целиком, к стражьему ИИ не сводится — на уровне 4 она не дерётся, а бежит влево и при x < 80 исчезает. АТЛАС ТЕНИ — вскрылось при чтении seg006:0532. Тень вне боевых кадров 150..189 ходит по таблице КИДА, и image оттуда индексирует спрайты Кида, а не стража. Выбор атласа в pop_cdraw шёл по СЛОТУ, то есть тень рисовалась бы спрайтами стража. Условие вынесено в pop_frame_tbl_is_guard() (pop_kid.c) — его теперь читают и load_frame, и отрисовка, разъехаться не могут. Заодно из pop_load_fram_det_col выделен pop_load_frame() без determine_col: jump_through_mirror берёт ось отражения из curr_col, и пересчёт колонки по x там был бы вреден. Константы MIRROR_* и DIR_56_NONE переехали в pop_guard.h — нужны и постановке тайла (банк 6), и ИИ тени (банк 1). Звука sound_45_jump_through_mirror в порте нет, пропущен. Шаг 5 (клип тени слева от зеркала) НЕ сделан и оказался не однострочником: в pop_cdraw есть клип сверху/снизу/справа, левого нет вовсе — нужен новый примитив либо срез исходных колонок. Расписано в TASKS_OPEN. Цена: _CODE +18 Б, банк 1 2311 -> 2367, банк 3 10328 -> 10551, банк 4 8243 -> 8267. tests-host: все 5 наборов прошли. НЕ ПРОВЕРЕНО В MAME — сценарий проверки записан в TASKS_OPEN. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
220 lines
13 KiB
C
220 lines
13 KiB
C
/*
|
||
* pop_guard.h — СОСТОЯНИЕ стража и точки входа в его логику.
|
||
*
|
||
* Разделение по окнам (docs/layout_plan_v2.md §4, подтверждено пробником
|
||
* tests/w3bankgfx):
|
||
* - СОСТОЯНИЕ живёт здесь, в W1/W2. Писучие статики __banked-модуля
|
||
* линкуются В СТРАНИЦУ БАНКА и снаружи не читаются, поэтому банк —
|
||
* только код;
|
||
* - ЛОГИКА (ИИ, боёвка) — в guards.c, собираемом как --bank 1=guards.c;
|
||
* - ОТРИСОВКА стража — в pop_cdraw.c (банк 4), общая на всех Char: её зовёт
|
||
* только главный цикл, а из банка резидент недостижим. Так код
|
||
* отрисовки не занимает дефицитные W1/W2 (куча).
|
||
*
|
||
* Поля char_type — как в оригинале (types.h:302), чтобы порт seg005/seg006
|
||
* ложился один в один.
|
||
*/
|
||
#ifndef POP_GUARD_H
|
||
#define POP_GUARD_H
|
||
|
||
#include <stdint.h>
|
||
#include "kid_data.h" /* kframe */
|
||
#include "pop_char.h"
|
||
#include "pop_geom.h" /* pop_rnd_t — сид бросков боёвки */
|
||
|
||
/* seqids (types.h:1052+) — последовательности боя и стойки. */
|
||
#define SEQ_55_DRAW_SWORD 55
|
||
#define SEQ_56_GUARD_FORWARD 56 /* шаг вперёд с мечом (страж) */
|
||
#define SEQ_57_BACK_WITH_SWORD 57
|
||
#define SEQ_58_GUARD_STRIKE 58
|
||
#define SEQ_60_TURN_WITH_SWORD 60
|
||
#define SEQ_61_PARRY_AFTER_STRIKE 61
|
||
#define SEQ_62_PARRY 62
|
||
#define SEQ_66_STRIKE_AFTER_PARRY 66
|
||
#define SEQ_71_DYING 71
|
||
#define SEQ_75_STRIKE 75 /* удар (Кид) */
|
||
#define SEQ_63_GUARD_ACTIVE_AFTER_FALL 63 /* стойка АКТИВНОГО (скелет) */
|
||
#define SEQ_77_GUARD_STAND_INACTIVE 77
|
||
#define SEQ_88_SKEL_WAKE_UP 88 /* скелет встаёт (спецсобытие) */
|
||
#define SEQ_80_STAND_FLIPPED 80
|
||
#define SEQ_86_FORWARD_WITH_SWORD 86 /* шаг вперёд с мечом (Кид) */
|
||
#define SEQ_87_GUARD_BECOME_INACT 87
|
||
#define SEQ_90_EN_GARDE 90
|
||
#define SEQ_92_PUT_SWORD_AWAY 92
|
||
#define SEQ_93_PUT_SWORD_AWAY_FAST 93
|
||
|
||
/* frameids (types.h:911+) и состояния меча (types.h:332). */
|
||
#define FRAME_150_PARRY 150
|
||
#define FRAME_151_STRIKE_1 151
|
||
#define FRAME_152_STRIKE_2 152
|
||
#define FRAME_153_STRIKE_3 153
|
||
#define FRAME_157_WALK_WITH_SWORD 157
|
||
#define FRAME_158_STAND_WITH_SWORD 158
|
||
#define FRAME_161_PARRY 161
|
||
#define FRAME_162_BLOCK_TO_STRIKE 162
|
||
#define FRAME_165_WALK_WITH_SWORD 165
|
||
#define FRAME_166_STAND_INACTIVE 166
|
||
#define FRAME_167_BLOCKED 167
|
||
#define FRAME_168_BACK 168
|
||
#define FRAME_169_BEGIN_BLOCK 169
|
||
#define FRAME_170_STAND_WITH_SWORD 170
|
||
#define FRAME_171_STAND_WITH_SWORD 171
|
||
#define SWORD_0_SHEATHED 0
|
||
#define SWORD_2_DRAWN 2
|
||
|
||
/* charids (types.h:320) — нужны хотя бы для «скелет не убивается читом». */
|
||
#define CHARID_0_KID 0
|
||
#define CHARID_1_SHADOW 1
|
||
#define CHARID_2_GUARD 2
|
||
#define CHARID_4_SKELETON 4
|
||
#define CHARID_5_PRINCESS 5
|
||
|
||
/* dir_56_none (types.h:402): «направления нет» — им clear_char убирает
|
||
* персонажа со сцены. Значение 0x56 в int8_t = 86, то есть заведомо не
|
||
* dir_0_right (0) и не dir_FF_left (-1). */
|
||
#define DIR_56_NONE 0x56
|
||
|
||
/* Спецсобытие «зеркало» (custom->mirror_*, дефолты SDLPoP): уровень 4,
|
||
* комната 4, колонка 4, верхний ряд. Здесь, а не в pop_trob.c: константы
|
||
* нужны и постановке тайла (банк 6), и ИИ тени (банк 1). */
|
||
#define MIRROR_LEVEL 4
|
||
#define MIRROR_ROOM 4
|
||
#define MIRROR_COL 4
|
||
#define MIRROR_ROW 0
|
||
#define MIRROR_TILEPOS (MIRROR_ROW * 10 + MIRROR_COL)
|
||
|
||
/* Градаций мастерства стража (seg002: таблицы вероятностей по 12 записей). */
|
||
#define NUM_GUARD_SKILLS 12
|
||
|
||
/* Тип персонажа — в pop_char.h (общий с Кидом и Char). */
|
||
|
||
extern pop_char_t Guard; /* страж ТЕКУЩЕЙ комнаты (как в оригинале) */
|
||
extern uint8_t guardhp_curr, guardhp_max;
|
||
extern int8_t guardhp_delta; /* <0 = в этом кадре отняли HP */
|
||
|
||
/* take_hp (seg006:06BD): отнять count HP у АКТИВНОГО персонажа (Char) —
|
||
* Киду из `hitp_*`, любому другому из `guardhp_*`. Возврат 1 = HP кончились
|
||
* (для вызывающего это «умер»); саму дельту применяет pop_do_delta_hp раз в
|
||
* кадр, как в оригинале.
|
||
*
|
||
* Живёт в резиденте W1/W2, потому что зовут ОБА банка: боёвка (guards.c,
|
||
* банк 1) и физика (pop_map.c, банк 3) — раньше у каждого была своя копия,
|
||
* причём у pop_map неверная (правила hitp_curr напрямую, мимо дельты, и не
|
||
* знала про не-Кидов). Чит бессмертия ловится здесь же. */
|
||
uint8_t pop_take_hp(uint8_t count);
|
||
|
||
/* Взводится в кадре, когда СТРАЖУ убавили HP (guardhp_delta < 0 оригинала):
|
||
* по нему pop_char_draw рисует «брызги» удара, как draw_guard в seg008:1654.
|
||
* Снимает главный цикл после отрисовки — стража могло не оказаться в
|
||
* отрисованной комнате, и тогда флаг обязан просто пропасть. */
|
||
extern uint8_t pop_guard_hurt;
|
||
|
||
/* Видит ли страж Кида (порт can_guard_see_kid, seg003:688):
|
||
* 0 — не видит, 1 — видит, но не пойдёт (между ними loose/чомпер/дыра),
|
||
* 2 — видит и пойдёт. Считает pop_check_can_guard_see_kid (банк) раз в
|
||
* кадр ДО логики персонажей; читают ИИ (autocontrol_*) и боёвка. */
|
||
extern int8_t can_guard_see_kid;
|
||
|
||
/* Кид «нашумел» (порт is_guard_notice, seg000:364): заставляет неактивного
|
||
* стража обернуться, даже если Кид у него за спиной. Ставит источник шума,
|
||
* снимает сам ИИ. */
|
||
extern int8_t is_guard_notice;
|
||
|
||
/* Боевые таймеры/уровень мастерства (seg000:295..311). Все убывают раз в
|
||
* кадр в autocontrol_opponent — как в оригинале.
|
||
* guard_skill — 0..11, из данных уровня; индекс в таблицы вероятностей;
|
||
* guard_refrac — «отдышка» стража: пока >0, он не атакует и не наступает;
|
||
* justblocked — Кид только что парировал (влияет на вероятность блока);
|
||
* kid_sword_strike — Кид только что бил (стража это придерживает). */
|
||
extern uint8_t guard_skill;
|
||
extern int8_t guard_refrac, justblocked, kid_sword_strike;
|
||
|
||
/* Состояние меча КИДА (seg005/seg006):
|
||
* offguard — меч убран НАМЕРЕННО (вниз в бою): пока стоит, Кид не
|
||
* достаёт клинок автоматически, даже видя стража;
|
||
* holding_sword — клинок в руке (для индикатора HP стража). */
|
||
extern int8_t offguard, holding_sword;
|
||
|
||
/* Сид бросков боёвки (свой домен последовательности, см. pop_geom.h). */
|
||
extern pop_rnd_t pop_fight_seed;
|
||
|
||
/* Луч видимости стража — раз в кадр, ДО тиков персонажей (в оригинале
|
||
* check_can_guard_see_kid стоит в play_frame перед play_kid_frame). */
|
||
void pop_check_can_guard_see_kid(void) __banked;
|
||
|
||
/* check_skel (seg002:1042) — СПЕЦСОБЫТИЕ уровня 3: скелета нет в данных
|
||
* уровня (guards_tile пуст во всех комнатах), он поднимается сам, когда Кид
|
||
* доходит до нужной колонки комнаты 1 при открытой двери уровня. Звать раз
|
||
* в кадр, ДО логики персонажей (порядок play_frame, seg000:868). */
|
||
void pop_check_skel(void) __banked;
|
||
|
||
/* Боёвка: пометить попадания (обе стороны) и применить их. Порядок в
|
||
* кадре как в play_frame: hurting -> hurt -> do_delta_hp. */
|
||
void pop_check_sword_hurting(void) __banked;
|
||
void pop_check_sword_hurt(void) __banked;
|
||
|
||
/* Текущий кадр стража (порт cur_frame для Char): заполняет логика в W1/W2,
|
||
* читает отрисовка в резиденте W3. image == 255 — рисовать нечего. */
|
||
extern kframe pop_gframe;
|
||
void pop_guard_load_frame(void);
|
||
|
||
/* check_guard_fallout (seg002:0241): убрать персонажа слота Guard, если он
|
||
* провалился ниже комнаты. Звать раз в кадр после физики и HP — как
|
||
* play_frame (seg000:884). */
|
||
void pop_guard_fallout(void);
|
||
|
||
/* Есть ли живой страж в отрисованной комнате (для главного цикла). */
|
||
uint8_t pop_guard_present(void);
|
||
|
||
/* Атласы стража (GUARD\\g0..g4.atl) — грузить ДО initgraph, как Kid.
|
||
* 0 — OK, -1 — ошибка (тогда страж просто не рисуется). */
|
||
int pop_guard_load(void) __banked;
|
||
void pop_guard_free(void) __banked;
|
||
|
||
/* Вход в комнату: поднять стража из данных уровня (порт enter_guard,
|
||
* seg002:0112) либо убрать его, если в комнате стража нет. */
|
||
void pop_guard_enter(uint8_t room);
|
||
|
||
/* Запомнить стража УХОДЯЩЕЙ комнаты (порт leave_guard). Звать в начале
|
||
* enter_room, пока Guard ещё держит прежнего. */
|
||
void pop_guard_leave(void);
|
||
|
||
/* Страж идёт ЗА КИДОМ в соседнюю комнату — порт ветки стража из exit_room
|
||
* (seg002:0340) + follow_guard (seg002:039E). Звать ВМЕСТО пары
|
||
* leave/enter при смене комнаты: 1 = страж уже перенесён в new_room (ни
|
||
* leave, ни enter звать нельзя), 0 = остаётся в старой (всё как раньше).
|
||
* side — куда ушёл КИД: 0 left, 1 right, 2 up, 3 down. */
|
||
uint8_t pop_guard_follow(uint8_t new_room, uint8_t side);
|
||
|
||
/* Полоса HP (Кид слева, страж справа) в статус-полосе. Рисует главный цикл
|
||
* ПОСЛЕ персонажей — она ничего не перекрывает. */
|
||
void pop_hp_draw(void) __banked;
|
||
/* Полоса стёрта перерисовкой фона (вход в комнату) — обновить обе страницы. */
|
||
void pop_hp_invalidate(void) __banked;
|
||
|
||
/* Цвет стража — подменой 16 слотов палитры (порт set_chtab_palette,
|
||
* seg003:257): спрайты лежат в индексах POP_GUARD_PAL_BASE + v, а цвет
|
||
* задаёт level.guards_color[room-1] (1..7; 0 = не менять). Звать ДО
|
||
* отрисовки комнаты, как это делает redraw_screen. */
|
||
void pop_guard_set_palette(uint8_t color) __banked;
|
||
|
||
/* Отрисовка соперника — общая на всех Char: pop_char_draw(POP_CH_OPP) и
|
||
* компания, см. pop_cdraw.h. Метрики его последнего кадра (в т.ч. ширина
|
||
* спрайта для char_width_half) — pop_cd[POP_CH_OPP]. */
|
||
|
||
/* Убрать стража со сцены (смена комнаты / инициализация). */
|
||
void pop_guard_reset(void);
|
||
|
||
/* Чит «убить стража» (seg000:786, K): скелета не берёт. Вызывать только
|
||
* при включённых читах — проверку делает вызывающий. */
|
||
void pop_guard_kill(void);
|
||
|
||
/* do_delta_hp (seg003): применить дельту HP, накопленную за кадр. Звать
|
||
* раз в кадр ПОСЛЕ тиков персонажей (в оригинале — в play_frame). */
|
||
void pop_do_delta_hp(void);
|
||
|
||
/* Тик логики стража — В БАНКЕ (guards.c). Состояние берёт отсюда. */
|
||
void pop_guard_tick(void) __banked;
|
||
|
||
#endif
|