[rozensoftware]

Summary

Makes Amiga audio as convenient as graphics assets: compile-time #import music / #import sound, plus HAS-ABI wrappers in lib/audio.s over ptplayer.

Author experience

#import music "assets/title.mod" as mus_title;
#import sound "assets/laser.raw" as sfx_laser;
#import sound "assets/boom.iff" as sfx_boom vol=40 pri=120;

#include "../includes/audio_defs.has";

call InitAudio();
call PlayMusic(mus_title);   // const track ID
call PlaySound(sfx_laser);   // const sfx ID
call PauseMusic();
call ChangeMusic(mus_ingame);
call QuitAudio();

What landed

• #import music — ProTracker .mod → CHIP DATA_C fragment + const track ID
• #import sound — .raw / .iff / .8svx (via tools/extract_8svx.py) → CHIP sample + sfx_table entry; options period / vol / pri / channel
• Codegen emits music_table + sfx_table whenever any audio import is present
• lib/audio.s — InitAudio, QuitAudio, PlayMusic, ChangeMusic, StopMusic, PauseMusic, ResumeMusic, PlaySound, SetMusicVolume (frame pointer preserved when using a6=CUSTOM)
• Auto-link: audio.s → ptplayer.s
• Docs, changelog, ptplayer skill updated
• Regressions: import_audio_load_test.has, import_audio_iff_test.has

Validation

• Dual-CPU compile (68000 / 68020) of audio import tests
• vasmm68k_mot assemble of generated .s, lib/audio.s, lib/ptplayer.s
• tests/test_import_directive.py — 30 passed
• IFF 8SVX extract + #import sound path verified

Notes

• Import as labels are integer constants (table indices), not & pointers
• incbin paths are absolute so vasm can find assets when fragments are INCLUDEd from another directory