snark13
8bbc6b4d07
Пункт 1 плана стражей. play_seq был прибит к Киду, поэтому страж стоял на захардкоженном кадре 166. Теперь как в оригинале: интерпретатор работает с АКТИВНЫМ персонажем Char, а вокруг стоят loadkid/savekid и loadshad/saveshad (порт seg006:809..825). Почему копия, а не указатель: так в оригинале, и на Z80 это быстрее — горячий цикл обращается к глобалу абсолютной адресацией, а 16-байтовое копирование платится один раз на переключение персонажа, тогда как указатель дал бы индексную адресацию в каждом обращении. Сопутствующее: - kid_t и pop_char_t слиты в один pop_char_t (pop_char.h): в оригинале char_type один на всех, и без этого общий интерпретатор невозможен. Kid получил поля room/charid/sword/alive — они и так нужны боёвке; - load_frame выбирает таблицу кадров по Char.charid (у стража своя, frame_tbl_guard с индексом frame + add_frame − 149, seg006:0293); - cur_frame разведён на два кэша: страж тикает ПОСЛЕ Кида, и без этого kid_draw брал бы кадр стража. savekid/saveshad раскладывают кадр по своему персонажу; - kid_set_seq пишет ИМЕННО Kid (его зовут pop_ctrl/pop_map вне окна Char, иначе loadkid затёр бы), для окна Char добавлен pop_char_set_seq — порт seqtbl_offset_char; - в pop_map 9 голых play_seq() заменены на pop_kid_play() (load+play+save); - страж входит в комнату через seq_77_guard_stand_inactive (seg002:0208), а не через прибитый кадр. Проверено в MAME: Kid бегает и упирается в стену как прежде, в комнате 12 плиты проваливаются со щебнем (правка задела 9 вызовов play_seq в физике), страж в комнате 3 рисуется в той же позе, но теперь curr_seq=0x19A9 и charid=2 — кадр получен прокруткой последовательности, а не константой. Бюджет (комната 3, 150 кадров): 380 292..381 282 тактов против 370 140..371 160 до правки, то есть +10 150 (+2.7 %). Основное — не копии Char, а то, что страж теперь реально крутит интерпретатор каждый кадр, а раньше стоял замороженным. 0.887 кадра, запас 48 718. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
111 lines
6.1 KiB
C
111 lines
6.1 KiB
C
/*
|
||
* pop_kid.h — движок анимации/движения Kid (Фаза K1): интерпретатор
|
||
* seqtbl (play_seq) + frame_table. Порт SDLPoP seg006.c. Данные —
|
||
* kid_data.h (pop_extract_kid_data.py).
|
||
*
|
||
* K1: только проигрывание последовательностей кадров с авторскими
|
||
* смещениями (движение = SEQ_DX/DY + frame.dx/dy). Управление (K2) и
|
||
* коллизия карты (K3) — отдельно.
|
||
*/
|
||
#ifndef POP_KID_H
|
||
#define POP_KID_H
|
||
|
||
#include <stdint.h>
|
||
#include "pop_char.h"
|
||
|
||
/* Состояние персонажа — общий тип для Кида, стража и Char (pop_char.h). */
|
||
extern pop_char_t Kid;
|
||
|
||
/* Флаг сотрясения (seg006 knock): +1 = KNOCK_UP (ряд выше), -1 = KNOCK_DOWN
|
||
* (свой ряд). Ставит play_seq, читает/сбрасывает pop_check_knock. */
|
||
extern int8_t knock;
|
||
|
||
/* Загрузить npages атласов Kid (kid0..kid{npages-1}.atl). ДО initgraph.
|
||
* 0 — OK, -1 — ошибка. */
|
||
int pop_kid_load(uint8_t npages);
|
||
|
||
/* Данные анимации (таблица кадров + seqtbl) — отдельная EMM-страница
|
||
* (kid_data.bin): в _CODE окна W1/W2 они занимали 3.5 КБ. Грузить ДО
|
||
* первого kid_init/play_seq. 0 — OK, -1 — ошибка (без них Kid не оживёт).
|
||
* Страница маппится в W0 внутри play_seq, раз за тик. */
|
||
int pop_kid_data_load(const char *path);
|
||
|
||
/* Прочитать кадр из таблицы страницы данных: tbl_off — KID_BIN_FRAMES_OFF
|
||
* (Kid) или KID_BIN_GFRAMES_OFF (страж, своя таблица frame_tbl_guard).
|
||
* Маппит страницу сама; для горячего цикла есть cur_frame. */
|
||
void pop_kid_data_frame(uint16_t tbl_off, uint8_t idx, uint8_t *out5);
|
||
void pop_kid_data_free(void);
|
||
|
||
/* Атлас chtab_0 «меч в руке» (sword.atl) — спрайт клинка поверх Kid в кадрах
|
||
* подъёма меча/убирания в ножны (add_sword_to_objtable, seg006:1798).
|
||
* Грузить ДО initgraph, как и страницы Kid. 0 — OK, -1 — ошибка (тогда
|
||
* кадры рисуются без клинка). */
|
||
int pop_sword_load(void);
|
||
void pop_kid_free(void);
|
||
|
||
/* Инициализировать Kid: последовательность seq_id, клетка col/row,
|
||
* направление dir (-1/0). Ставит x/y по x_bump/y_land. */
|
||
void kid_init(uint8_t seq_id, int8_t col, int8_t row, int8_t dir);
|
||
|
||
/* Один логический тик: play_seq() — продвинуть последовательность до
|
||
* следующего кадра (применить SEQ_DX/DY/ACTION/...). */
|
||
void kid_tick(void);
|
||
|
||
/* play_seq напрямую (для pop_map start_fall — переход в fall-seq в тот же
|
||
* physics-шаг, как оригинал). */
|
||
void play_seq(void); /* работает с Char — см. pop_kid_play ниже */
|
||
|
||
/* Активный персонаж (порт Char, seg006) и его загрузка/выгрузка.
|
||
* Интерпретатор последовательностей общий для Kid и стража: у них общая
|
||
* seqtbl, но РАЗНЫЕ таблицы кадров (load_frame выбирает по Char.charid). */
|
||
extern pop_char_t Char;
|
||
void pop_loadkid(void);
|
||
void pop_savekid(void);
|
||
void pop_loadshad(void);
|
||
void pop_saveshad(void);
|
||
|
||
/* Прокрутить последовательность персонажа целиком (load + play_seq +
|
||
* save). Звать вместо голого play_seq. */
|
||
void pop_char_set_seq(uint8_t seq_id); /* seq активного персонажа */
|
||
void pop_kid_play(void);
|
||
void pop_guard_play(void);
|
||
|
||
/* Поля текущего кадра kid_frames[Kid.frame] (pop_map, без дублирования
|
||
* таблицы во втором TU). */
|
||
int8_t kid_cur_dx(void);
|
||
uint8_t kid_cur_flags(void);
|
||
|
||
/* Сменить последовательность (Kid.curr_seq = kid_seq_off[seq_id]) — единая
|
||
* точка для pop_ctrl/pop_map (иначе каждый дублировал бы kid_seqtbl ~2.3КБ). */
|
||
void kid_set_seq(uint8_t seq_id);
|
||
|
||
/* Рендер-смещение Kid по ЛОГИЧЕСКОЙ X (порт xpos_in_drawn_room, seg004):
|
||
* когда комната Kid ≠ отрисованной (straddle у шва), спрайт рисуется со
|
||
* сдвигом ∓140 (левый сосед −140 / правый +140), при этом Kid.x/коллизия
|
||
* остаются в кадре комнаты Kid. 0 — комнаты совпадают (обычный случай).
|
||
* Влияет на kid_draw и метрики футпринта (fore) — heal берёт запомненный
|
||
* прямоугольник, поэтому согласован автоматически. */
|
||
void pop_kid_set_render_dx(int dx);
|
||
|
||
/* Нарисовать текущий кадр Kid (банк GFX_BANK_SPRITE — видео-ОЗУ, без
|
||
* теневой копии; запоминает прямоугольник для kid_heal). */
|
||
void kid_draw(void);
|
||
|
||
/* draw_hurt_splash (seg006:2003): «брызги» урона (image 218) поверх Kid —
|
||
* звать СРАЗУ после kid_draw в кадре, когда HP убавилось (pop_kid_hurt). */
|
||
void kid_draw_splash(void);
|
||
|
||
/* Восстановить фон (из теневой копии) на месте ПРЕДЫДУЩЕГО кадра Kid —
|
||
* вместо перерисовки всего экрана. Звать ПЕРЕД kid_tick/kid_draw. */
|
||
void kid_heal(void);
|
||
|
||
/* Метрики последнего kid_draw для футпринта fore-over-Kid (pop_bg
|
||
* pop_fore_over_kid): obj_x — ЛОГИЧЕСКАЯ X кадра (до ×8/7), obj_y — низ
|
||
* спрайта, w/h — размер кадра. */
|
||
int kid_fp_obj_x(void);
|
||
int kid_fp_obj_y(void);
|
||
uint16_t kid_fp_width(void);
|
||
uint16_t kid_fp_height(void);
|
||
|
||
#endif
|