home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Misc / MUSICX24.DMS / in.adf / File_Format.doc < prev    next >
Encoding:
Text File  |  1994-04-06  |  5.8 KB  |  252 lines
  1. **********************************************************************
  2. * This following  section of text  was accidentally  left of out the *
  3. * Notator-X users manual, Appendix C.  It fits  between the sections *
  4. * "The format of the chunks" & "The standard event structure".       *
  5. **********************************************************************
  6.  
  7.  
  8.  
  9.  
  10. A chunk starts with a four byte header eg. "VRSN". Then follows a LONG
  11. WORD which specifies the  length of the chunk in bytes. (Not including
  12. the 4 byte header or the 4 byte length).
  13.  
  14.  
  15. A quick note about the format of the following documentation:
  16.     If the symbol "0x" is displayed preciding a value, this means that
  17.     the following value in Hexadecimal.
  18.  
  19.     The inch size measurments  are stored  in a UWORD value. The value
  20.     is multiplied by 100 to make it into an interger. Eg:A measurement
  21.     of 2.5inches is stored as 250 or 0x00FA.
  22.  
  23.  
  24.  
  25. VRSN
  26. ~~~~
  27. This structure is used to inform the  module what version of Notator-X
  28. was used to create this file, and what version of the  save module was
  29. used to save it. This is intended for future expansions  and should be
  30. saved as the first chunk.
  31. {
  32.     UWORD = Notator-X program version. Eg. 0x114 means 1.14
  33.     UWORD = File module version. Release 1 of Notator-X uses 0x104
  34. }
  35.  
  36.  
  37.  
  38. SSBA
  39. ~~~~
  40. {
  41.     UWORD = Smallest Staff Gap for Staff nn
  42.     UBYTE = Link and Brace Status for Staff nn
  43.     UBYTE = Pad
  44. }
  45. The structure is saved 18 times, 1 for each staff. Therefore the chunk
  46. length is : 18 * (4 bytes per structure) = 72 bytes long.
  47.  
  48. Link Status values in binary (x means not used):
  49.         Staff Not Linked    = xxxxxx00
  50.         Top of Link         = xxxxxx01
  51.         Middle of Link      = xxxxxx10
  52.         End of Link         = xxxxxx11
  53.         Brace None          = xxxx00xx
  54.         Brace Straight      = xxxx01xx
  55.         Brace Curly         = xxxx10xx
  56.  
  57.  
  58.  
  59. MSPL
  60. ~~~~
  61. The master  page layout  structure is used  to specify the size of all
  62. the pages and the master number of page setting.
  63. {
  64.     UWORD = Paper Width in Inches : Eg. 800 means 8.00 inches
  65.     UWORD = Paper Height
  66.     UWORD = Paper X Dots per inch. (Depends on the printer)
  67.     UWORD = Paper Y Dots per inch.
  68.     UWORD = Image Size
  69.     UWORD = Printer Density
  70.     UWORD = Master number of staves per group
  71.     UWORD = Smallest Staff Gap - Inches * 100
  72.     UWORD = Smallest Next Set of staves gap - Inches * 100
  73.     UWORD = Lyrics assigned to Staff (0-17)
  74.     UWORD = Lyrics offset from bottom of staff - Inches * 100
  75.     UBYTE = Show Lyrics (0 = NO)
  76.     UBYTE = Editing Lyric Verse (0-4)
  77.     CHAR[30]= Printer's Name
  78. }
  79.     The image sizes are : 0 = Miniture, 1 = Normal, 2 = Large.
  80.     The print density is in the range of 1-7.
  81.  
  82.  
  83.  
  84. MICH
  85. ~~~~
  86. {
  87.     UBYTE = Midi channel for track 1  : A midi channel is 0-15
  88.     ......
  89.     UBYTE = Midi channel for track 36
  90. }
  91.  
  92.  
  93.  
  94. TKNM
  95. ~~~~
  96. {
  97.     UBYTE = Show Track Names     ( 0 = NO)
  98.     UBYTE = Show Track Name left ( 0 = LEFT : 1 = RIGHT)
  99.     CHAR[40] = Name for track 1
  100.     ......
  101.     CHAR[40] = Name for track 18
  102. }
  103.  
  104.  
  105.  
  106. PLYT
  107. ~~~~
  108. {
  109.     UWORD = Page Number
  110.     UWORD = Number of staves drawn on this page
  111.     UWORD = Top Margin
  112.     UWORD = Bottom Margin
  113.     UWORD = Left Margin
  114.     UWORD = Right Margin
  115.     UWORD = Display Header / Footer Status
  116.  
  117. .This is then followed by the number of staff structures specified in
  118. the Number of staves variable specified above.
  119.  
  120. * A staff structure *
  121. {
  122.     UWORD = X1 position of staff
  123.     UWORD = X2 position of staff
  124.     UWORD = Y position of staff
  125. }
  126.  
  127.  
  128.  
  129. TMSG
  130. ~~~~
  131. {
  132.     UWORD = Bar Number
  133.     UBYTE = Time Signature top number
  134.     UBYTE = Time Signature bottom number
  135. }
  136.  
  137.  
  138.  
  139. KYSG
  140. ~~~~
  141. {
  142.     UWORD = Bar Number
  143.     UBYTE = Track Number
  144.     UBYTE = Key Signature
  145. }
  146. The key signature values are:
  147.          1-7  = Sharps from  to 7 of them
  148.          8    = C Major
  149.          9-15 = Flats from 1 to 7
  150.  
  151.  
  152.  
  153. [B] TKAS [N]
  154. {
  155.   UBYTE, UBYTE = Staff 1's Track A and B
  156.   .......
  157.   .......
  158.   UBYTE, UBYTE = Staff 18's Track A and B
  159.  
  160. }
  161. Its length is 18 tracks * 2 bytes per track = 36 bytes.
  162. If bit 7 of the first byte  of the track number of the  desired track
  163. is set then the staff will also  display the track B.  A track number
  164. is from 0-35.
  165.  
  166.  
  167.  
  168. BARS
  169. ~~~~
  170. {
  171.     UWORD = Bar Number
  172.     UBYTE = Bar Status
  173.     UBYTE = UnUsed
  174. }
  175. A Bars status  is only  saved  if the status  is  different  from the
  176. previous bar. The status for bar 1 is always saved.
  177.  
  178. Bar Status bit defs:
  179.         Bit 0 = First Time Ending
  180.         Bit 1 = Second Time Ending
  181.         Bit 2 = Third Time Ending
  182.         Bit 3 = Repeat Start
  183.         Bit 4 = Repeat End
  184.         Bit 5 = End Bar Line
  185.         Bit 6 = Double Bar Line
  186.         Bit 7 = Display Bar Number
  187.  
  188.  
  189.  
  190. EVTL
  191. ~~~~
  192. {
  193.     UWORD  = Track Number
  194.     Plus a continual list of the event data. See standard event data..
  195. }
  196.  
  197.  
  198.  
  199. FRAM
  200. ~~~~
  201. A list of all the frame structures is saved.
  202.  
  203.  
  204.  
  205. LYRV
  206. ~~~~
  207. This structure is used to store a verse for the lyrics. Notator-X will
  208. currently only print up to 5 verses
  209. {
  210.     UWORD = Verse Number
  211.     CHAR[] = Verse Text
  212. }
  213. The length of the text is got from the chunk's length - 2
  214.  
  215.  
  216.  
  217. HDFT
  218. ~~~~
  219. This  structure is  used to  store the  headers and  footers  text and
  220. position.
  221. {
  222.     UWORD = Name of structure
  223.     UWORD = X Offset (inches)
  224.     UWORD = Y Offset (inches)
  225.     UWORD = AscII Length
  226.     CHAR[] = Text
  227. }
  228. Following are the currently defined structure meanings :
  229.           Header Left   = HL
  230.           Header Centre = HC
  231.           Header Right  = HR
  232.           Footer Left   = FL
  233.           Footer Centre = FC
  234.           Footer Right  = FR
  235.  
  236.  
  237.  
  238. REPT
  239. ~~~~
  240. {
  241.     UWORD = Segno's Bar number
  242.     UWORD = Dal Segno's Bar Number
  243.     UWORD = Dal Segno al Coda's Bar Number
  244.     UWORD = To Coda Bar Number
  245.     UWORD = Segno / Coda etc.. Y Offset
  246.     UWORD = First 6 Third Repeat Endings Y Offset
  247.     CHAR[40] = First Time Ending Text. Normally "1."
  248.     CHAR[40] = Second Time Ending Text
  249.     CHAR[40] = Third Time Ending Text
  250. }
  251.  
  252.