SNDH

From Atariki

(Różnice między wersjami)
Jump to: navigation, search
Wersja z dnia 19:00, 2 kwi 2013
Sikor (Dyskusja | wkład)
(tak na dobry początek)
← Previous diff		 Wersja z dnia 19:04, 2 kwi 2013
Sikor (Dyskusja | wkład)
(+format pliku)
Next diff →
Linia 2: Linia 2:
==Archiwum== ==Archiwum==
[http://sndh.atari.org/ Archiwum] muzyk z Atari ST w formacie SNDH, znaleźć tam można także opis narzędzi do tworzenia muzyki, linki do playerów, itp. [http://sndh.atari.org/ Archiwum] muzyk z Atari ST w formacie SNDH, znaleźć tam można także opis narzędzi do tworzenia muzyki, linki do playerów, itp.
 +==Format pliku SNDH==
 +Za stroną archiwum:
 +<pre>
 +; 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)</pre>
{{stub}} {{stub}}
[[Kategoria:Glosariusz]] [[Kategoria:Glosariusz]]

Wersja z dnia 19:04, 2 kwi 2013

Format muzyki na tzw. "syntetykach" w formacie chipu YM2149, stosowanego w Atari ST i pokrewnych.

Archiwum

Archiwum muzyk z Atari ST w formacie SNDH, znaleźć tam można także opis narzędzi do tworzenia muzyki, linki do playerów, itp.

Format pliku SNDH

Za stroną archiwum: 

; 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)

Ten artykuł to tylko zalążek. Możesz pomóc rozwojowi Atariki poprzez rozszerzenie go o więcej informacji.

Źródło: "http://atariki.krap.pl/index.php/SNDH"
Personal tools