duffyduckandClaude Opus 4.8
7aea2fac26
Referenzaufnahmen aus DOSBox (Xvfb) gemacht und danach:
- Rauser-Aufloesung gefixt: die nativen PCC-Assets werden jetzt EINMAL direkt
auf Endgroesse hochskaliert (Nearest) und der Screen direkt in Fenster-
aufloesung gerendert -- statt vorher 0.5x-Downscale (verwirft Pixel) + x3-
Upscale ueber eine 320er-Zwischenleinwand. Gleiche Groesse wie bisher (~33%
Bildbreite, gegen Referenz gemessen), aber gestochen scharf. Zusaetzlich das
tuerkise "!"-Kaestchen nachgebaut (im Original Engine-gezeichnet, in keinem
Asset enthalten).
- Titelbild-Reveal: Grau/Entsaettigung raus (Stefan "das gray raus"); die
Scanlines auf der unteren Haelfte loesen sich jetzt von der Mitte nach unten
auf ("scanlines ab der mitte getrennt weg") statt gleichmaessig auszufaden.
- Factor5: Logo haelt exakt so lange wie sein Sound (TITEL2 Song 1) spielt,
dann weiter zu Kellogg's.
- Leertaste ueberspringt jetzt den aktuellen Intro-Screen, ESC beendet das
ganze Intro (wait_or_skip gibt 'quit'/'skip'/None; run_once ist in Scenes
zerlegt).
HANG-FIX (dabei gefunden): das kompilierte render_tfmx-Binary war veraltet
(vor dem Song-Index-Feature aus render_tfmx.c gebaut) und renderte TITEL2 Song1
mit 180s statt 2.4s -- gekoppelt an die neue "Factor5-Dauer = Songlaenge"-Logik
haette das Intro 3 Minuten eingefroren. Fixes: audio._ensure_binary() baut jetzt
neu, wenn die Quelle neuer ist als das Binary (verhindert stale Binary nach git
pull); zusaetzlich FACTOR5_MAX_SECONDS als Sicherheits-Obergrenze.
Verifiziert: python -m game --once (headless) exit 0 in ~30s; Rauser/Titelbild
visuell gegen die DOSBox-Referenz gegengeprueft.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
122 lines
6.1 KiB
Python
122 lines
6.1 KiB
Python
"""
|
|
Duenner Python-Wrapper um das MIT-lizenzierte `tfmx_player/render_tfmx`
|
|
(siehe game/tfmx_player/LICENSE, Copyright Peter Fors) -- rendert ein
|
|
TFMX-Musikstueck (<NAME>.TFX + <NAME>.SAM aus PCKELL.DAT) einmalig zu einer
|
|
WAV-Datei und cached das Ergebnis, damit die Intro-Sequenz die Musik per
|
|
pygame.mixer abspielen kann.
|
|
|
|
Warum Subprocess statt reinem Python-Reimplement: TFMX ist ein komplexes
|
|
Amiga-Tracker-Format (siehe tfmx.h, ~95KB reine Player-Logik). Das
|
|
MIT-lizenzierte C-Referenztool duerfen wir direkt nutzen (im Gegensatz zum
|
|
lizenzlosen C#-Referenzprojekt fuer PCX/BOB/MAP, das wir bewusst nur als
|
|
Format-Wissen genommen und selbst neu geschrieben haben). Fuer Musik-
|
|
Wiedergabe ist der Sound selbst das Ziel, nicht der Decoder-Code -- ein
|
|
funktionierender, korrekt lizenzierter Renderer ist hier der pragmatische
|
|
Weg statt TFMX in Python neu zu erfinden.
|
|
|
|
Gerenderte WAVs sind urheberrechtlich das Original-Spielmaterial (Musik),
|
|
werden daher NICHT ins Git-Repo committed (wie game/original/ und extracted_dat/) --
|
|
liegen nur lokal im Cache-Verzeichnis.
|
|
|
|
MEHRERE SONGS PRO MODUL (Fund 22.07.2026 abends, Stefans Hinweis "das Spiel
|
|
hat noch wesentlich mehr Lieder"): ein einzelnes TFX-Modul kann intern
|
|
MEHRERE Songs buendeln (tfmx.h's v_songs[]/v_songs_count, ausgewaehlt per
|
|
start_song-Index). Stichprobe per Debug-Tool ergab:
|
|
TITEL.TFX -> 3 Songs (song0/1 lang/loopend >15s, song2 ~8.0s)
|
|
TITEL2.TFX -> 2 Songs (song0 ~2.04s = Rauser-Bling, song1 ~2.40s = Factor5-
|
|
Brausen -- Laenge passt zu Stefans "nur ein bisschen laenger
|
|
als der Rauser-Sound")
|
|
ONGAME2.TFX -> 14 Songs (>15s-Tracks vermutlich Level-Musik, song3/11/12
|
|
sehr kurz (0.16-1.36s) vermutlich Jingles/Stinger, song2/13
|
|
~10.3s). Noch nicht im Detail zugeordnet -- fuer die
|
|
spaetere Gameplay-Musik relevant, siehe NOTES.md.
|
|
render_wav() nimmt jetzt optional `song_index` entgegen und reicht ihn als
|
|
5. CLI-Arg an render_tfmx durch. Der Cache-Dateiname enthaelt den Song-Index
|
|
NUR wenn er nicht der Default (0/None) ist, damit bereits vorhandene Caches
|
|
fuer Song 0 (z.B. TITEL.wav) gueltig bleiben.
|
|
"""
|
|
import os
|
|
import subprocess
|
|
import sys
|
|
|
|
_HERE = os.path.dirname(os.path.abspath(__file__))
|
|
_PLAYER_DIR = os.path.join(_HERE, 'tfmx_player')
|
|
_BINARY = os.path.join(_PLAYER_DIR, 'render_tfmx')
|
|
_PROJECT_ROOT = os.path.dirname(_HERE)
|
|
_CACHE_DIR = os.environ.get('KELLOGG_AUDIO_CACHE', os.path.join(_PROJECT_ROOT, 'audio_cache'))
|
|
|
|
|
|
def _ensure_binary():
|
|
'''Baut render_tfmx, wenn das Binary fehlt ODER aelter ist als eine der
|
|
Quelldateien. Das "aelter als die Quelle"-Kriterium ist wichtig: nach einem
|
|
git pull (z.B. dem Song-Index-Feature in render_tfmx.c) blieb sonst ein
|
|
veraltetes Binary liegen, das falsche/zu lange WAVs rendert -- das hat am
|
|
24.07.2026 einen 180s-statt-2.4s-Render und damit einen Intro-Hang
|
|
verursacht (Factor5-Dauer haengt an der Songlaenge).'''
|
|
srcs = [os.path.join(_PLAYER_DIR, f)
|
|
for f in ('render_tfmx.c', 'tfmx.h', 'paula.h', 'player_api.h')]
|
|
if os.path.exists(_BINARY):
|
|
bmtime = os.path.getmtime(_BINARY)
|
|
if all(not os.path.exists(s) or os.path.getmtime(s) <= bmtime for s in srcs):
|
|
return # Binary ist aktuell
|
|
subprocess.run(['bash', os.path.join(_PLAYER_DIR, 'build.sh')], check=True)
|
|
|
|
|
|
def render_wav(container, name, seconds=180, force=False, song_index=None):
|
|
"""container: kellogg_formats.DATContainer; name: z.B. 'TITEL' (ohne Extension).
|
|
song_index: optional -- welcher der ggf. mehreren in <name>.TFX gebuendelten
|
|
Songs gerendert werden soll (siehe Modul-Docstring). None/0 = Default-
|
|
Verhalten wie bisher (erster/einziger Song). Gibt den Pfad zur gerenderten
|
|
(gecachten) WAV-Datei zurueck.
|
|
|
|
WICHTIG (Fix 22.07.2026 abends): `seconds` ist nur noch eine Sicherheits-
|
|
OBERGRENZE, keine Ziel-Laenge! render_tfmx erkennt das natuerliche Song-
|
|
Ende/den Loop-Punkt selbst (tfmx.h real_song_end) und schneidet dort ab --
|
|
z.B. ist TITEL (song 0) tatsaechlich ~109s lang, ONGAME2 (song 0) ~123s,
|
|
TITEL2 song0 (Rauser-Sting) nur ~2.04s. Vorher wurde hart bei `seconds`
|
|
abgeschnitten. Der Default hier (180s) ist bewusst grosszuegig ueber die
|
|
laengsten bekannten Stuecke hinaus gewaehlt, damit nichts abgeschnitten
|
|
wird; im Normalfall stoppt render_tfmx laengst vorher von selbst.
|
|
|
|
ACHTUNG Cache: der Dateiname ist `<name>.wav` (song_index None/0) bzw.
|
|
`<name>_song<N>.wav` fuer N>0. Wird `seconds` kleiner gewaehlt als die
|
|
echte Songlaenge, MUSS `force=True` gesetzt werden, sonst liefert diese
|
|
Funktion einen ggf. laenger/kuerzer gerenderten alten Cache-Treffer
|
|
zurueck, egal was `seconds` diesmal sagt."""
|
|
os.makedirs(_CACHE_DIR, exist_ok=True)
|
|
suffix = f'_song{song_index}' if song_index else ''
|
|
out_path = os.path.join(_CACHE_DIR, f'{name}{suffix}.wav')
|
|
if os.path.exists(out_path) and not force:
|
|
return out_path
|
|
_ensure_binary()
|
|
|
|
tfx_data = container.entries[name + '.TFX']
|
|
sam_data = container.entries[name + '.SAM']
|
|
tfx_path = os.path.join(_CACHE_DIR, f'{name}.TFX')
|
|
sam_path = os.path.join(_CACHE_DIR, f'{name}.SAM')
|
|
with open(tfx_path, 'wb') as f:
|
|
f.write(tfx_data)
|
|
with open(sam_path, 'wb') as f:
|
|
f.write(sam_data)
|
|
|
|
cmd = [_BINARY, tfx_path, sam_path, out_path, str(seconds)]
|
|
if song_index:
|
|
cmd.append(str(song_index))
|
|
result = subprocess.run(cmd, capture_output=True, text=True)
|
|
if result.returncode != 0:
|
|
raise RuntimeError(f'render_tfmx failed for {name} (song_index={song_index}): {result.stderr}')
|
|
return out_path
|
|
|
|
|
|
if __name__ == '__main__':
|
|
# Kleiner CLI-Test: python3 -m game.audio <DAT_PATH> <NAME> [seconds] [song_index]
|
|
sys.path.insert(0, _PROJECT_ROOT)
|
|
from game.formats import DATContainer
|
|
dat_path = sys.argv[1]
|
|
name = sys.argv[2]
|
|
seconds = int(sys.argv[3]) if len(sys.argv) > 3 else 20
|
|
song_index = int(sys.argv[4]) if len(sys.argv) > 4 else None
|
|
c = DATContainer(dat_path)
|
|
path = render_wav(c, name, seconds, force=True, song_index=song_index)
|
|
print(f'rendered: {path}')
|