Sound (TFMX) geloest: MIT-lizenzierter Player eingebunden, Titelmusik in Intro-Sequenz

tools/intro_sequence.py

@@ -45,6 +45,7 @@ import time
 
 sys.path.insert(0, os.path.dirname(__file__))
 from kellogg_formats import DATContainer, load_pcc
+import tfmx_audio
 
 import pygame
 
@@ -214,6 +215,18 @@ def run_once(screen, clock, assets):
         return True
 
     # 5) Kellogg's-Logo + "praesentiert"-Palettenfade
+    # Titelmusik (TITEL.TFX/.SAM) setzt hier ein und laeuft geloopt weiter
+    # bis zum Ende der Sequenz (Original hat vermutlich durchgehende
+    # Titelmusik ueber Logo+Titelbild+Karte -- noch nicht per Referenz-
+    # Sichtung bestaetigt, aber plausibelste Annahme fuers erste v1).
+    try:
+        if pygame.mixer.get_init():
+            titel_wav = tfmx_audio.render_wav(assets.container, 'TITEL', seconds=60)
+            pygame.mixer.music.load(titel_wav)
+            pygame.mixer.music.play(-1)
+    except Exception as exc:
+        print(f'[intro_sequence] Titelmusik konnte nicht geladen werden: {exc}', file=sys.stderr)
+
     kw, kh, kidx, kpal = assets.pcc('KELLOGGS')
 
     def show_kelloggs(t):
@@ -260,7 +273,14 @@ def run_once(screen, clock, assets):
 
 def main():
     once = '--once' in sys.argv
+    pygame.mixer.pre_init(44100, -16, 2, 512)
     pygame.init()
+    try:
+        pygame.mixer.init()
+    except pygame.error as exc:
+        # Kein Audio-Device vorhanden (z.B. headless VM/Container ohne
+        # Soundkarte) -- Sequenz laeuft stumm weiter statt abzustuerzen.
+        print(f'[intro_sequence] Audio nicht verfuegbar, laeuft stumm: {exc}', file=sys.stderr)
     screen = pygame.display.set_mode((WINDOW_W, WINDOW_H))
     pygame.display.set_caption("Tony & Friends in Kellogg's Land -- Intro (Remake)")
     clock = pygame.time.Clock()
@@ -271,6 +291,8 @@ def main():
     while not quit_requested and not once:
         quit_requested = run_once(screen, clock, assets)
 
+    if pygame.mixer.get_init():
+        pygame.mixer.music.stop()
     pygame.quit()
 
 

tools/tfmx_audio.py

@@ -0,0 +1,73 @@
+"""
+Duenner Python-Wrapper um das MIT-lizenzierte `tfmx_player/render_tfmx`
+(siehe tools/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 raw/ und extracted_dat/) --
+liegen nur lokal im Cache-Verzeichnis.
+"""
+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')
+_CACHE_DIR = os.environ.get('KELLOGG_AUDIO_CACHE', '/home/aria/kellogg_remake/audio_cache')
+
+
+def _ensure_binary():
+    if os.path.exists(_BINARY):
+        return
+    subprocess.run(['bash', os.path.join(_PLAYER_DIR, 'build.sh')], check=True)
+
+
+def render_wav(container, name, seconds=20, force=False):
+    """container: kellogg_formats.DATContainer; name: z.B. 'TITEL' (ohne Extension).
+    Gibt den Pfad zur gerenderten (gecachten) WAV-Datei zurueck."""
+    os.makedirs(_CACHE_DIR, exist_ok=True)
+    out_path = os.path.join(_CACHE_DIR, f'{name}.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)
+
+    result = subprocess.run(
+        [_BINARY, tfx_path, sam_path, out_path, str(seconds)],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        raise RuntimeError(f'render_tfmx failed for {name}: {result.stderr}')
+    return out_path
+
+
+if __name__ == '__main__':
+    # Kleiner CLI-Test: python3 tfmx_audio.py <DAT_PATH> <NAME> [seconds]
+    sys.path.insert(0, _HERE)
+    from kellogg_formats import DATContainer
+    dat_path = sys.argv[1]
+    name = sys.argv[2]
+    seconds = int(sys.argv[3]) if len(sys.argv) > 3 else 20
+    c = DATContainer(dat_path)
+    path = render_wav(c, name, seconds, force=True)
+    print(f'rendered: {path}')