snark13
31b82661eb
Порт PoP переехал в applications/SprPoP — приложение, которое собирается само: код, оригинальные данные, конверторы ресурсов и сборка внутри одной папки. Наружу знает единственный путь — корень тулчейна (SPRINTER_ROOT, по умолчанию ../..). applications/PoP/roomtest ЗАМОРОЖЕНА и остаётся архивом закрытых задач, багов и исполненных планов. Скопировано из applications/PoP/roomtest@4b74478. Перенос проверен побайтово: собранный sprpop.exe совпал с roomtest.exe того же коммита, все 39 дисковых ресурсов и все 16 генерируемых заголовков — тоже, host- тесты зелёные (15/15). Раскладка: src/ рукописный C (roomtest.c -> sprpop.c) gen/ генерируемые заголовки, в репозитории assets/orig/ оригинальные данные игры, вне репозитория (копирайт) assets/packed/ то, что ложится на диск, в раскладке диска tools/ конверторы; все пути — в одном tools/paths.py build/ выход: exe, каталоги ресурсов, hdd/, промежуточные atl/ Сборка ресурсов: assets/packed и gen — версионируемые ВХОДЫ, а не то, что пересчитывается каждым make. Автоматика построена на ОТСУТСТВИИ файла, а не на таймстемпах: git не хранит времена, и в свежем клоне сравнение по времени превращалось бы в лотерею. Недостающий ресурс или заголовок чинится сам, рекурсивным вызовом в ветку генерации. Музыка собирается из любого из четырёх наборов записей (make music-mp3, music-mt32, ...); набор входит в имя stamp'а, поэтому смена набора сама делает музыку устаревшей. Длины реплик больше не захардкожены: упаковщик печатает их в gen/pop_music_ticks.h, и шкала сцены выражена через них — иначе mt32 (реплики на 6% длиннее) молча ломал катсцену. Тулчейн: в app.mk два обратносовместимых крючка (SRC_DIR/BUILD_DIR), HDD_IMG стал ?=; команда сборки roomtest не изменилась. Корневой make host-tests переключён на SprPoP. Подгонка тайминга катсцены с принцессой (PV_MAGIC_LEAD): сцена render-bound и идёт ~49 тиков/с вместо 60, из-за чего кода реплики приходила раньше молнии. Это обход, а не лечение; разбор с замерами — docs/BUGS_OPEN.md, записи SND-PACE-DEAD, PV-RENDER-BOUND, MUS-LEFT-TEAR. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
125 lines
5.5 KiB
Makefile
125 lines
5.5 KiB
Makefile
# app.mk — shared Makefile fragment for any standalone Sprinter ESTEX
|
||
# program — used both by libc feature tests under tests/ and by real
|
||
# applications under examples/.
|
||
#
|
||
# Usage in a per-program Makefile:
|
||
#
|
||
# PROJ_ROOT := $(abspath $(CURDIR)/../..)
|
||
# EXAMPLE := my_program # base name (matches my_program.c)
|
||
#
|
||
# # Optional overrides (any combination):
|
||
# # MEMORY := small # tiny | small | big | huge | manual
|
||
# # STACK_SIZE := 2048 # bytes reserved for the stack
|
||
# # EXTRA_SRCS := helper.c util.c # additional .c files in this dir
|
||
# # EXTRA_FLAGS := --crt0=minimal # passed through to sprinter-cc
|
||
# # EXTRA_DATA := test.txt # extra files to add to `make floppy`
|
||
#
|
||
# include $(PROJ_ROOT)/app.mk
|
||
#
|
||
# Pipeline (all driven by sprinter-cc):
|
||
# crt0 + EXAMPLE.c + EXTRA_SRCS --sdcc--> .ihx
|
||
# .ihx --mkexe--> EXAMPLE.exe
|
||
# linking against lib/sprinter.lib for libc.
|
||
#
|
||
# Targets provided:
|
||
# all build $(EXAMPLE).exe (default)
|
||
# clean remove build artefacts
|
||
# floppy build the example and pack it (alone, plus EXTRA_DATA) into
|
||
# mame/v306/IMG/mc.img — useful for trying a single program
|
||
# without rebuilding every example. Top-level `make floppy`
|
||
# (in the repo root) still packs all examples.
|
||
# run floppy + launch MAME
|
||
|
||
SPRINTER_CC := $(PROJ_ROOT)/bin/sprinter-cc
|
||
MKEXE := $(PROJ_ROOT)/toolchain/mkexe/mkexe
|
||
LIB := $(PROJ_ROOT)/lib/sprinter.lib
|
||
|
||
MAME_DIR := $(PROJ_ROOT)/mame/v306
|
||
FLOPPY_IMG := $(MAME_DIR)/IMG/mc.img
|
||
# ?= — приложение со своим каталогом выхода (applications/SprPoP) держит
|
||
# образ у себя и связывает его с MAME символьной ссылкой.
|
||
HDD_IMG ?= $(MAME_DIR)/IMG/test_hdd.chd
|
||
MAKE_DISK := $(MAME_DIR)/make_disk.py
|
||
MAKE_HDD := $(PROJ_ROOT)/toolchain/make_hdd.sh
|
||
RUN_MAME := $(MAME_DIR)/run_mame.sh
|
||
|
||
# Optional knobs — see top of file.
|
||
MEMORY ?= tiny
|
||
|
||
# SRC_DIR / BUILD_DIR — раскладка приложения, которое НЕ держит исходники и
|
||
# выхлоп в одной папке с Makefile (applications/SprPoP: src/ и build/). По
|
||
# умолчанию обе пусты, то есть всё как было: ./$(EXAMPLE).c → ./$(EXAMPLE).exe.
|
||
# Пустое значение обрабатывается отдельной веткой намеренно: "./prog.exe" и
|
||
# "prog.exe" — разные имена целей, и склеивать префикс безусловно нельзя.
|
||
SRC_DIR ?=
|
||
BUILD_DIR ?=
|
||
ifeq ($(strip $(SRC_DIR)),)
|
||
MAIN_SRC := $(EXAMPLE).c
|
||
else
|
||
MAIN_SRC := $(SRC_DIR)/$(EXAMPLE).c
|
||
endif
|
||
ifeq ($(strip $(BUILD_DIR)),)
|
||
EXE := $(EXAMPLE).exe
|
||
else
|
||
EXE := $(BUILD_DIR)/$(EXAMPLE).exe
|
||
endif
|
||
SOURCES := $(MAIN_SRC) $(EXTRA_SRCS)
|
||
# Аргументы упаковщика HDD. Обычно это exe и EXTRA_DATA; приложение со
|
||
# своей раскладкой каталогов может переопределить переменную до include.
|
||
HDD_PACK_ARGS ?= $(EXE) $(EXTRA_DATA)
|
||
|
||
CC_FLAGS := --memory $(MEMORY)
|
||
ifneq ($(STACK_SIZE),)
|
||
CC_FLAGS += --stack-size $(STACK_SIZE)
|
||
endif
|
||
CC_FLAGS += $(EXTRA_FLAGS)
|
||
|
||
all: $(EXE)
|
||
|
||
# runtime/*.s (crt0-семейство, bank.s, heap.s) собираются per-build
|
||
# внутри sprinter-cc — без этой зависимости их правка не перелинкует
|
||
# уже собранный exe (кусало: фикс bank.s не подхватился).
|
||
RUNTIME_DEPS := $(wildcard $(PROJ_ROOT)/runtime/*.s)
|
||
|
||
$(EXE): $(SOURCES) $(MKEXE) $(LIB) $(RUNTIME_DEPS)
|
||
$(if $(strip $(BUILD_DIR)),@mkdir -p $(dir $@))
|
||
$(SPRINTER_CC) $(CC_FLAGS) -o $@ $(SOURCES)
|
||
|
||
$(MKEXE):
|
||
$(MAKE) -C $(PROJ_ROOT)/toolchain/mkexe
|
||
|
||
# $(LIB) = lib/sprinter.lib (libc). Графика (bgi256.lib) собирает
|
||
# libbgi/Makefile; гоним и его — иначе standalone `make` в тесте с
|
||
# --gfx 256 не найдёт bgi256.lib при линковке. Оба инкрементальные,
|
||
# на повторном запуске ничего не пересобирают.
|
||
$(LIB):
|
||
$(MAKE) -C $(PROJ_ROOT)/libc
|
||
$(MAKE) -C $(PROJ_ROOT)/libbgi
|
||
|
||
clean:
|
||
rm -rf $(if $(strip $(BUILD_DIR)),$(BUILD_DIR),.sprinter-cc-* $(EXE))
|
||
|
||
# `make floppy` packs ONLY this program (+ optional EXTRA_DATA files) into
|
||
# the MAME floppy image, replacing whatever was there. Handy for trying a
|
||
# single program without rebuilding everything.
|
||
floppy: $(EXE)
|
||
python3 $(MAKE_DISK) $(FLOPPY_IMG) $(EXE) $(EXTRA_DATA)
|
||
@echo
|
||
@echo "Floppy ready: $(FLOPPY_IMG) (with $(EXAMPLE).exe$(if $(EXTRA_DATA), + $(EXTRA_DATA))) "
|
||
@echo "Run: cd $(MAME_DIR) && ./run_mame.sh"
|
||
|
||
run: floppy
|
||
cd $(MAME_DIR) && ./run_mame.sh
|
||
|
||
# `make hdd` packs this program (+ optional EXTRA_DATA files) into the MAME
|
||
# HDD image mounted as disk D: (-hard2 test_hdd.chd). Гораздо быстрее FDD —
|
||
# используется MCP-мостом к MAME (run_bridge.sh). После пересборки образа
|
||
# MAME ОБЯЗАН полный рестарт (chdman -f = новый inode; см. memory).
|
||
hdd: $(EXE)
|
||
$(MAKE_HDD) $(HDD_IMG) $(HDD_PACK_ARGS)
|
||
@echo
|
||
@echo "HDD (D:) ready: $(HDD_IMG) (with $(EXAMPLE).exe$(if $(EXTRA_DATA), + $(EXTRA_DATA)))"
|
||
@echo "ВНИМАНИЕ: перезапусти MAME (run_bridge.sh) — образ пересобран."
|
||
|
||
.PHONY: all clean floppy run hdd
|