; SNDH file structure, Revision 2.10 ; Original SNDH Format devised by Jochen Knaus ; SNDH V1.1 Updated/Created by Anders Eriksson and Odd Skancke ; SNDH V2.0 by Phil Graham ; SNDH V2.1 by Phil Graham ; This document was originally created by Anders Eriksson, updated and ; adapted with SNDH v2 structures by Phil Graham. ; October, 2012 ; ; ; All values are in MOTOROLA BIG ENDIAN format ;--------------------------------------------------------------------------- ;Offset Size Function Example ;--------------------------------------------------------------------------- ;0 4 INIT music driver bra.w init_music_driver ; (subtune number in d0.w) ;4 4 EXIT music driver bra.w exit_music_driver ;8 4 music driver PLAY bra.w vbl_play ;12 4 SNDH head dc.b 'SNDH' ;--------------------------------------------------------------------------- ;Beneath follows the different TAGS that can (should) be used. ;The order of the TAGS is not important. ;--------------------------------------------------------------------------- ;--------------------------------------------------------------------------- ; TAG Description Example Termination ;--------------------------------------------------------------------------- ; TITL Title of Song dc.b 'TITL','Led Storm',0 0 (Null) ; COMM Composer Name dc.b 'COMM','Tim Follin',0 0 (Null) ; RIPP Ripper Name dc.b 'RIPP','Me the hacker',0 0 (Null) ; CONV Converter Name dc.b 'CONV','Me the converter',0 0 (Null) ; ##?? Sub Tunes dc.b '##04',0 0 (Null) ; TA??? Timer A dc.b 'TA50',0 0 (Null) ; TB??? Timer B dc.b 'TB60',0 0 (Null) ; TC??? Timer C dc.b 'TC50',0 0 (Null) ; TD??? Timer D dc.b 'TD100',0 0 (Null) ; !V?? VBL dc.b '!V50',0 0 (Null) ; YEAR Year of release dc.b '1996',0 0 (Null) SNHDv2 ; #!?? Default Sub tune dc.b '#!02',0 0 (Null) SNDHv21 ; #!SN Sub tune names dc.w x1,x2,x3,x4 None ; dc.b "Subtune Name 1",0 0 (Null) SNDHv21 ; dc.b "Subtune Name 2",0 0 (Null) SNDHv21 ; dc.b "Subtune Name 3",0 0 (Null) SNDHv21 ; dc.b "Subtune Name 4",0 0 (Null) SNDHv21 ; TIME (sub) tune time dc.b 'TIME' None SNDHv2 ; (in seconds) dc.w x1,x2,x3,x4 ; HDNS End of Header dc.b 'HDNS' None SNDHv2 ;--------------------------------------------------------------------------- ;Calling method and speed ;--------------------------------------------------------------------------- ;This a very important part to do correctly. ;Here you specify what hardware interrupt to use for calling the music ;driver. ; ;These options are available; ;dc.b '!Vnn' VBL (nn=frequency) ;dc.b 'TAnnn',0 Timer A (nnn=frequency) ;dc.b 'TBnnn',0 Timer B (nnn=frequency) ;dc.b 'TCnnn',0 Timer C (nnn=frequency) ;dc.b 'TDnnn',0 Timer D (nnn=frequency) ; ;VBL - Is NOT recommended for use. There is no change made to the ; VBL frequency so it will play at the current VBL speed. ; ;Timer A - Is only recommended if Timer C is not accurate enough. Use ; with caution, many songs are using Timer A for special ; effects. ; ;Timer B - Is only recommended if Timer C is not accurate enough. Use ; with caution, many songs are using Timer B for special ; effects. ; ;Timer C - The default timer if nothing is specified. Default speed ; is 50Hz. Use Timer C playback wherever possible. It hooks ; up to the OS 200Hz Timer C interrupt and leaves all other ; interrupts free for special effects. ; ; For songs with a replay speed uneven of 200Hz, SND Player ; uses a smart routine to correct for the wrong speed. The ; result is usually very good. If the result isn't good ; enough,then consider another Timer, but be careful with ; Timer collisions! ; ;Timer D - Is only recommended if Timer C is not accurate enough. ; Use with caution, many songs are using Timer D for ; special effects. ;--------------------------------------------------------------------------- ; Default Tune Tag (!#??) ;--------------------------------------------------------------------------- ; The !# Tag is followed by a two character ascii value signifying the ; default sub-tune to be played. If this tag is null then a sub-tune of ; 1 is assumed. ;--------------------------------------------------------------------------- ;--------------------------------------------------------------------------- ; Sub Tune Names (!#SN) ;--------------------------------------------------------------------------- ; The !#SN Tag is followed by a table of word offsets pointing to the ascii ; text of sub tune names. The base offset is the actaul !#SN tag. See ; example header below. ;--------------------------------------------------------------------------- ;--------------------------------------------------------------------------- ; TIME Tag ;--------------------------------------------------------------------------- ; The TIME tag is followed by 'x' short words ('x' being the number of ; tunes). Each word contains the length of each sub tune in seconds. If the ; word is null then it is assumed that the tune endlessly loops. ;--------------------------------------------------------------------------- ;--------------------------------------------------------------------------- ; HDNS Tag ;--------------------------------------------------------------------------- ; The HDNS signifies the end of the SNDH header and the start of the actual ; music data. This tag must be on an even boundary. ;--------------------------------------------------------------------------- ;--------------------------------------------------------------------------- ;Example of a complete SNDH header/file ;--------------------------------------------------------------------------- ; ; section text ; ; bra.w sndh_init ; bra.w sndh_exit ; bra.w sndh_vbl ; ; dc.b 'SNDH' ; dc.b 'TITL','Mindbomb - Digi Synth',0 ; dc.b 'COMM','Spaz',0 ; dc.b 'RIPP','Grazey/PHF',0 ; dc.b 'CONV','Quartet-2-SNDH (c) PHF',0 ; dc.b '##06',0 ; dc.b 'TC200',0 ; dc.b '!#01',0 ; even ;.subt dc.b '!#SN' ; Subtune names ; dc.w .t1-.subt ; Offset from .subt ; dc.w .t2-.subt ; dc.w .t3-.subt ; dc.w .t4-.subt ; dc.w .t5-.subt ; dc.w .t6-.subt ; ;.t1 dc.b 'What a Bummer',0 ;.t2 dc.b 'Paninaro',0 ;.t3 dc.b 'Fade to a Pinkish Red',0 ;.t4 dc.b 'Revenge of the Mutant Wafer Biscuits',0 ;.t5 dc.b 'Mind Bomb (Theme)',0 ;.t6 dc.b 'In The Night',0 ; ; even ; dc.b 'YEAR','1990',0 ; dc.b 'TIME' ; dc.w $e1,$60,$78,$11c,$40,$5f ; even ; dc.b 'HDNS',0 ; ; ;sndh_init: ; movem.l d0-a6,-(sp) ; bsr.w player ; movem.l (sp)+,d0-a6 ; rts ; ;sndh_exit: ; movem.l d0-a6,-(sp) ; bsr.w player+4 ; movem.l (sp)+,d0-a6 ; rts ; ;sndh_vbl: ; movem.l d0-a6,-(sp) ; bsr.w player+8 ; movem.l (sp)+,d0-a6 ; rts ; ; section data ; ;player: ; incbin 'replaycode.bin' ; even ;http://phf.atari.org ;(EOF)