SNDH file format question

[TheNameOfTheGame]

I was looking here https://sndh.atari.org/fileformat.php for an explanation of the SNDH file format.

Code: Select all

; 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

However, I am looking at a file now that has a header tag "FLAG" that is not listed in the description above.

Code: Select all

SNDH
TITLSound Magic.
COMMDolby.
RIPPGrazey/PHF.
CONVGrazey/PHF.
FLAG~ay.
TIME.
M
HDN

My question is where can I find an explanation of the "FLAG" tag? Is there a newer version of the file format other than the v2.10?

[evil]

Hello,

the file format is under a bit of an expansion and all details are not set yet, however the FLAG tag is in place, just not documented yet.

Here are the different flags:

Code: Select all

FLAG  Start of FLAG
~     If the first character is a tilde, it means that all subsongs share the same FLAG settings
a     MFP Timer A
b     MFP Timer B
c     MFP Timer C
d     MFP Timer D
e     STe/TT DMA sound
h     HBL
l     STe/TT LMC1992
p     AGA (Amiga specific)
s     Falcon DSP
t     BLiTTER
y     YM2149 PSG
NULL  End of FLAG

[TheNameOfTheGame]

Ah, thanks so much, that's very helpful.

[simonsunnyboy]

From my understanding addiitonal header tags shall not disrupt replay with the existing interfaces?

[evil]

From my understanding addiitonal header tags shall not disrupt replay with the existing interfaces?

Normally no.
But I guess a player could be made to not play if it finds something unknown in the header.