Files
Sylpheed/tools/re-capture/fade_decompose.sh
sylph-decoder e823cfe6fa re: a third menu-outgoing gap, and leaving the archive costs no extra black
sylpheed-port's BLOCKED row asks for a second value on one outgoing screen --
what would make "the gap tracks the outgoing screen" predictive rather than a
restatement of the data.

First, a correction their ask surfaced without needing a run: THE MENU ALREADY
HAD TWO VALUES AND THEY DIFFER -- 0 leaving for the title, 1 leaving for EXTRAS.
So "the outgoing screen determines the gap" was too strong and is withdrawn; what
holds is an ordering, not a determination. Also recorded: their ask is answerable
only from the menu, since the title's sole exit is (A) to the menu and EXTRAS's
sole exit is (B) to the menu.

Then took a third menu-outgoing measurement, to a screen outside GP_TITLE.
Confound named in advance rather than after: that transition leaves the ARCHIVE,
so a pak load could inflate the gap for reasons unrelated to the outgoing screen.

Result: outgoing quad rises across frames 24-28 (4-5 frames, matching build 5's
declared 10-unit close), then ONE empty frame at 30. Gap = 1, identical to
menu -> EXTRAS. So the confound is measured ABSENT -- leaving the archive costs no
extra black, which is worth having on its own.

Six transitions now group as: menu {0, 1, 1} over three different destinations
including another pak, EXTRAS {2}, title {3, 3, 3}. The ordering rests on 3+1+3
measurements and the menu's three agree to within one frame.

Still not predictive: outgoing closes are 5, 5, 4 frames against gaps {0,1}, {2},
{3}, and EXTRAS has n=1 with no way to obtain a second value.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wuu56cE8vJGTBtn1ppsk8v
2026-08-30 18:42:51 +00:00

187 lines
9.5 KiB
Bash
Executable File

#!/usr/bin/env bash
# Decompose a screen transition's ~0.4 s fade-out into RAMP + HOLD, at the
# emulator's own frame granularity.
#
# docs/re/screen-transitions.md measures the fade-out as ~0.4 s (~24 units) while
# `pteff00.prm`'s final declared ramp is 70->80 = 10 units. The remainder is
# currently ARITHMETIC THAT FITS -- "the other 14 units must be the black hold"
# -- and that page says so itself. This measures it instead.
#
# The design point: arm the UI draw capture ON THE MAIN MENU, then press (B).
# One capture window then contains
# * the menu's fade-OUT -- the unknown, and
# * the title's fade-IN -- whose ramp IS decoded from the file (build 4's
# pteff00.prm, t=16 a=255 -> t=261 a=0, 245 units),
# so the run carries its own control: an instrument that cannot reproduce the
# known fade-in cannot be trusted on the unknown fade-out.
#
# Traps inherited from menu_draw_capture.sh, both already paid for:
# * F10 arms the capture AND opens the emulator menu bar; any Xenia UI makes
# IsUIActive() true and every later guest keystroke is swallowed. Click the
# game surface to dismiss before touching the pad.
# * a 0.12 s tap gets missed; hold (B) 0.5 s and confirm [RE-INPUT] delivery.
#
# WHERE=menu (default) arms on the main menu and presses (B) -> menu -> title.
# WHERE=title arms on the boot title and presses (A) -> title -> menu.
# WHERE=extras navigates to EXTRAS, arms there, presses (B) -> menu.
# WHERE=menu2extras navigates to EXTRAS, (B)s back to the menu with focus
# restored, arms there and presses (A) -> EXTRAS. The
# REVERSE pair, to test whether the black gap is a property
# of the screen pair or of the direction.
# Tests whether "(B) has no black interval" is a rule or
# one screen pair -- sylpheed-port's BLOCKED.md ask #1.
# The two transitions have DIFFERENT declared fade-ins for the incoming screen --
# build 4 is 0->16 (16 units, 8 frames), build 5 is 0->12 (12 units, 6 frames) --
# which is what makes the pair a discriminator rather than a fit.
#
# Usage: WHERE=title fade_decompose.sh [out_dir]
set -u
export HOME=/sylph-home/re SDL_AUDIODRIVER=dummy DISPLAY=:98
SD="$(cd "$(dirname "$0")" && pwd)"
OUT="${1:-/sylph-home/re/fadecap}"
mkdir -p "$OUT"; rm -f "$OUT"/xenia_re_ui_draws_*.log
alive(){ ps -o pid=,stat= -C xenia_canary 2>/dev/null | awk '$2 !~ /^Z/ {print $1}'; }
shot(){ screenshot "$1" >/dev/null 2>&1; }
screen(){ shot /tmp/fdc.png; python3 "$SD/screen_id.py" /tmp/fdc.png | awk '{print $1}'; }
( cd "$OUT" && nohup run-canary --mem_watch=false --log_ui_draws=true \
--ui_draw_capture_frames="${FRAMES:-260}" \
--ui_draw_capture_max="${MAXDRAWS:-400000}" \
--logged_profile_slot_0_xuid=B13EBABEBABEBABE \
>"$OUT/canary.stdout" 2>"$OUT/canary.stderr" & )
sleep 8
until xdotool search --name "Xenia-canary" >/dev/null 2>&1; do
[ -n "$(alive)" ] || { echo "EMULATOR GONE"; exit 4; }; sleep 1
done
win="$(xdotool search --name "Xenia-canary" | tail -1)"
# 1. wait for the boot title; do not tap through the intro (a run that tapped
# every 4 s delivered 88 presses and ended on a black screen).
deadline=$(( SECONDS + ${TITLE_WAIT:-420} )); s=""
while [ $SECONDS -lt $deadline ]; do
s="$(screen)"; echo "t=${SECONDS}s $s"
[ "$s" = "title" ] && break
sleep 4
done
[ "$s" = "title" ] || { echo "NEVER REACHED THE TITLE"; exit 1; }
WHERE="${WHERE:-menu}"
if [ "$WHERE" = "menu" ]; then
BRANCH="menu: (A) on the boot title -> arm on the MENU -> press (B)"
# 2. one (A) on the boot title -> main menu; we arm THERE and press (B).
python3 "$SD/pad.py" tap A 0.5
for _ in 1 2 3 4 5 6; do
sleep 4; s="$(screen)"; echo " after A: $s"
[ "$s" = "menu" ] && break
done
[ "$s" = "menu" ] || { echo "NO MENU (screen=$s)"; exit 2; }
BTN=B
elif [ "$WHERE" = "menu2other" ]; then
# A THIRD value for the menu as outgoing screen. The menu is the only screen in
# GP_TITLE with more than one exit, so it is the only place the port's ask -- a
# second value on one outgoing screen -- can be tested at all. Here we take an
# exit that LEAVES the archive (NEW GAME / LOAD / TUTORIAL / OPTIONS), which the
# discriminator reports as "neither" with a collapsed margin.
BRANCH="menu2other: arm on the MENU with focus on a non-EXTRAS item -> press (A)"
python3 "$SD/pad.py" tap A 0.5
for _ in 1 2 3 4 5 6; do
sleep 4; s="$(screen)"; echo " after A: $s"
[ "$s" = "menu" ] && break
done
[ "$s" = "menu" ] || { echo "NO MENU (screen=$s)"; exit 2; }
# Confirm the focused item is NOT extras: press (A), check, (B) back. If it WAS
# extras, step the cursor once so the armed press goes somewhere else.
python3 "$SD/pad.py" tap A 0.5; sleep 5
shot "$OUT/probe.png"
w="$(python3 "$SD/which_title_screen.py" "$OUT/probe.png")"
echo " probe: $w"
python3 "$SD/pad.py" tap B 0.5; sleep 6
case "$w" in extras*) echo " focus was EXTRAS — stepping once"
python3 "$SD/pad.py" dpad UP 0.3; sleep 2;; esac
shot "$OUT/armed-on-menu.png"
echo " arming on: $(python3 "$SD/which_title_screen.py" "$OUT/armed-on-menu.png")"
BTN=A
elif [ "$WHERE" = "extras" ] || [ "$WHERE" = "menu2extras" ]; then
BRANCH="extras-family: navigate to EXTRAS"
python3 "$SD/pad.py" tap A 0.5
for _ in 1 2 3 4 5 6; do
sleep 4; s="$(screen)"; echo " after A: $s"
[ "$s" = "menu" ] && break
done
[ "$s" = "menu" ] || { echo "NO MENU (screen=$s)"; exit 2; }
# EXTRAS is the only main-menu button that stays inside GP_TITLE, and initial
# focus varies boot to boot, so search: press (A), ask which screen we got, and
# if it is not EXTRAS come back with (B) and step the cursor. screen_id.py
# cannot tell EXTRAS from the main menu -- both are dark blue GP_TITLE screens
# -- so the check is which_title_screen.py, whose control separates them by
# ~11 RMSE against ~18 within-class.
found=""
for try in 1 2 3 4 5 6; do
python3 "$SD/pad.py" tap A 0.5; sleep 5
shot "$OUT/try$try.png"
w="$(python3 "$SD/which_title_screen.py" "$OUT/try$try.png")"
echo " try $try: $w"
# ⚠️ REQUIRE A MARGIN. The first version accepted any line starting
# "extras", but which_title_screen.py returns a nearest-match even for a
# screen outside GP_TITLE entirely -- where the margin collapses to ~0.1.
# A bare prefix test would then accept a wrong screen on a coin flip. The
# control puts a true match at ~10-11; require > 5.
m=$(echo "$w" | sed -n 's/.*margin \([0-9.]*\).*/\1/p')
ok=$(awk -v m="${m:-0}" 'BEGIN{print (m>5)?1:0}')
case "$w" in extras*) [ "$ok" = 1 ] && { found=1; break; }
echo " (rejected: margin ${m:-?} <= 5)";; esac
python3 "$SD/pad.py" tap B 0.5; sleep 5
python3 "$SD/pad.py" dpad UP 0.3; sleep 2
done
[ -n "$found" ] || { echo "NEVER REACHED EXTRAS"; exit 3; }
if [ "$WHERE" = "menu2extras" ]; then
# We are ON extras. (B) returns to the menu with focus RESTORED on EXTRAS
# (measured 4/4, menu-navigation-semantics.md), so arming there and pressing
# (A) gives the menu -> EXTRAS transition: the exact reverse of the pair
# already measured at a 2-frame gap.
python3 "$SD/pad.py" tap B 0.5; sleep 6
shot "$OUT/back-on-menu.png"
echo " back on menu: $(python3 "$SD/which_title_screen.py" "$OUT/back-on-menu.png")"
BTN=A
BRANCH="menu2extras: back on the MENU with focus restored -> press (A)"
else
BTN=B
BRANCH="extras: arm on EXTRAS -> press (B)"
fi
else
BRANCH="title: arm on the BOOT TITLE -> press (A)"
# arm on the title itself and press (A): the incoming screen is then build 5,
# whose declared fade-in is 12 units where build 4's is 16.
BTN=A
fi
shot "$OUT/armed-on-$WHERE.png"
# 3. arm the capture, dismiss the menu bar F10 opened, then press (B).
# Everything between F10 and (B) is spent inside the capture window, so keep
# it short: the window is FRAMES submitted frames, not seconds.
# ── EFFECTIVE CONFIGURATION ──────────────────────────────────────────────────
# Printed from the variables actually in force, NOT from $WHERE. A three-part
# patch once left a branch condition unapplied, so WHERE=menu2extras silently ran
# the `title` branch and produced a well-formed capture of a different transition.
# The data looked fine; only the ABSENCE of this branch's log lines gave it away.
# So: every run states what it is really about to do.
echo "── EFFECTIVE CONFIG ──────────────────────────────"
echo " requested WHERE = ${WHERE}"
echo " branch taken = ${BRANCH:-<none — no branch set itself, this is a BUG>}"
echo " button to press = ${BTN}"
echo " arming on = $(screen)"
echo "──────────────────────────────────────────────────"
[ -n "${BRANCH:-}" ] || { echo "REFUSING: no branch announced itself"; exit 5; }
xdotool windowactivate --sync "$win"; sleep 1
xdotool key F10; sleep 0.6
xdotool mousemove 900 400 click 1; sleep 0.6
echo "-- ($BTN) at $(date +%S.%N) --"
python3 "$SD/pad.py" tap $BTN 0.5
sleep 12
shot "$OUT/after-press.png"; echo "screen after $BTN: $(screen)"
grep -c "RE-INPUT" "$OUT/canary.stdout" 2>/dev/null | sed 's/^/[RE-INPUT] lines: /'
ls -l "$OUT"/xenia_re_ui_draws_*.log 2>/dev/null || echo "NO CAPTURE LOG"
grep -i "UI-CAP" "$OUT/canary.stdout" | tail -3
echo "FADE CAPTURE DONE (emulator left running)"