home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / music / utils / trackconv / !TrackConv / !Help < prev    next >
Text File  |  1994-07-28  |  19KB  |  475 lines
  1. !Help file for !TrackConv by Chris Davis.
  2. =========================================
  3. Last updated 28th July 1994.
  4.  
  5. The !TrackConv directory should contain the following.
  6.  
  7. !Boot      -   Boot file.
  8. !Help      -   This file.
  9. !Notice    -   Legal notice.
  10. !Run       -   Run file.
  11. !RunImage  -   Main program.
  12. !Sprites   -   Standard res. application sprites.
  13. !Sprites22 -   High res. application sprites.
  14. !Sprites23 -   High res. mono application sprites.
  15. Formats    -   List of formats known by !TrackConv.
  16. History    -   History of TrackConv
  17. PackIt     -   Directory containing PackIt utils.
  18.  
  19.            :   Compress   -  Program to compress coconizer packets.
  20.                Decompress -  Program to decompress coconizer packets.
  21.                PackIt     -  PackIt module (must be loaded for the above).
  22.  
  23. Code       -   ARM Code routines used by the main application
  24. Templates  -   Standard 2D templates
  25. Templ3D    -   Risc OS 3 3D templates
  26. (Options)  -   This file contains the saved options so they are the same
  27.                when TrackConv is next loaded. It is not neccesary for this
  28.                file to be included as TrackConv will create a new one if it
  29.                is not found.
  30.  
  31. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  32.  
  33. TrackConv
  34. ---------
  35.  
  36. The purpose of TrackConv is to convert Tracker style music files to another
  37. similar format. e.g. Amiga Sountracker to Archimedes Tracker, Archimedes
  38. Coconizer to Amiga Soundtracker. It will also let you load and save samples
  39. into or from the file in memory and it will let you save patterns, as well
  40. as giving general information on the file.
  41.  
  42. Method
  43. ------
  44.  
  45. TrackConv works by loading the original file into memory and at the same
  46. time converting it to TrackConv's own format. When the file needs to be
  47. saved it is converted from this format to the required format. This means
  48. that individual routines needed to convert from one specific file format to
  49. another are not needed. Two seperate routines, a load and save, are used for
  50. each file format so once a routine has been created it can be used in
  51. conjuction with all the other routines immediately. The disadvantage of this
  52. is that TrackConv's own format has to support everything all the other files
  53. support so that an accurate conversion can always take place.
  54.  
  55. The many different Tracker style file formats all use volumes and samples.
  56. In some cases the volume values used are in linear format (0-64) and in
  57. other cases they are logarithmic format (0-255). A perfect conversion
  58. between these formats cannot be done (you don't get the original values if
  59. you do a linear to logarithmic conversion, then a logarithmic to linear
  60. conversion) so TrackConv keeps the original values in memory and sets a flag
  61. to denote their format. It then only converts them, if it needs to, when
  62. saving a file, still keeping the original values so that if the original and
  63. desiginated files use the same format an accurate conversion is done.
  64.  
  65. The same thing happens for samples. Samples are either Linear Signed,
  66. Logarithmic or sometimes Linear Unsigned. TrackConv keeps the orignal
  67. samples denoting their format and then converts them when it needs to.
  68. However, the original samples are not kept because of the amount of memory
  69. needed for a buffer.
  70.  
  71. Formats
  72. -------
  73.  
  74. Amiga SoundTracker:
  75. ==================
  76.  
  77. This is probably the most common file format found on Acorn machines,
  78. although the facilty to save to this format is not found on very many
  79. Archimedes programs. This reason for this is the vast amount of Amiga tunes
  80. written that get moved to the Archimedes in comparison to the few tunes that
  81. get actually get written on the Archimedes using Archimedes programs.
  82. Although this file format only allows for 16 commands it has a very good
  83. command set.
  84.  
  85. Archimedes Tracker:
  86. ==================
  87.  
  88. This was one of the first Archimedes tracker file formats. It contains more
  89. information about the music than Amiga STracker and for that reason are
  90. slightly larger. However, it has a limiting command set. This is also a very
  91. common file format.
  92.  
  93. Archimedes Coconizer:
  94. ====================
  95.  
  96. Coconizer is a freeware application for the Archimedes. It is very similar
  97. to Tracker but slightly more restrictive.
  98.  
  99. Coconizer 'song' files do not contain samples. The samples are stored in
  100. directories accessable to the main application. Also coconizer tunes are
  101. often in compressed 'packets'.
  102.  
  103. Coconizer 'Trackfiles' are very similar to the song files, expcept that they
  104. contain samples. 
  105.  
  106. There is also a tool that will allow you to create stand alone self playing
  107. relocatable modules from coconizer files. TrackConv will also load these.
  108.  
  109. Teque Music:
  110. ===========
  111.  
  112. Teque music are Amiga STracker files set-typed &CC5.
  113.  
  114. Digital Symphony:
  115. ================
  116.  
  117. Digital Symphony is a fairly recent application for the Archimedes and it's
  118. files are very sophiscated. It has the widest command set of all the
  119. supported formats and is designed to offer the wider command set of Amiga
  120. files on the Archimedes.
  121.  
  122. Musix:
  123. =====
  124.  
  125. Musix is a PD program which will enable you to write 4 track tunes.
  126. TrackConv will attempt to load and save these but I cannot be sure that they
  127. will convert properly.
  128.  
  129. Octalyser:
  130. =========
  131.  
  132. Octalyser is (I think) a program on the Amiga which will allow you to create
  133. music containing up to 8 channels.
  134.  
  135. OctaMED:
  136. =======
  137.  
  138. OctaMED is a program on the Amiga which will allow you to create music with
  139. up to 8 channels and will also support MIDI. TrackConv cannot support the
  140. MIDI aspects of the file but will convert the rest properly.
  141.  
  142. Scream Tracker:
  143. ==============
  144.  
  145. Scream Tracker is a four track file format on the PC, similar to Sound Tracker.
  146.  
  147. Arc ProTracker:
  148. ==============
  149.  
  150. Arc ProTracker is a PD application for the Archimedes which nearly has the
  151. full command set of Sound/Pro Tracker on the Amiga. It's files are very
  152. similar to Tracker but have subtle differences that cause some applications
  153. to crash.
  154.  
  155. PC 669:
  156. ======
  157.  
  158. PC 669 is an 8 track format for the PC. It has a volume for each event and
  159. so TrackConv will always add in volume commands if there is no other effect.
  160. 669 also has a default tempo (speed?) for each pattern and, at the moment,
  161. this is ignored by TrackConv.
  162.  
  163. Zool tunes:
  164. ==========
  165.  
  166. These are tunes found in the game 'Zool'. These must be loaded via the
  167. GuessType option.
  168.      Currently TrackConv assumes the ProTracker command set except it
  169. subtracts 1 off all speed values. As the default speed is 6 it also sets the
  170. speed to 5 near the beginning of the song (at the first empty command). This
  171. sounds wierd but it works the best! However, this is not right all the time
  172. and some tracks may sound too fast or too slow. It may be more sensible to
  173. insert a tempo command near the beggining of the track and keep the speed
  174. values the same ... but this is not really fair to users of programs like
  175. Tracker or Coconizer which don't have a tempo command.
  176.  
  177. Desktop Tracker:
  178. ===============
  179.  
  180. TrackConv will not currently load Desktop Tracker files properly...but it
  181. comes close(ish). It will load the samples correctly but mucks up the
  182. patterns a little (it ignores the commands and sometimes gets the notes
  183. wrong).
  184.  
  185. PPP Track:
  186. =========
  187.  
  188. This is TrackConv's own file format. It has no real advantages over other
  189. formats, except that there will be no data loss when using it. (i.e. it
  190. contains all the information TrackConv knows about the file at the time of
  191. saving).
  192.  
  193. Using !TrackConv
  194. ----------------
  195.  
  196. Loading and saving tunes:
  197. ========================
  198.  
  199. To load a file simply drag it on to the TrackConv icon on the icon bar. If
  200. the tune is in a recoginzed format, can be loaded and there is enough
  201. application memory reserved for TrackConv it will be loaded. If not all of
  202. this is true, either nothing will happen or an error will be generated.
  203.  
  204. Please note that the file must be set-typed correctly and that although it
  205. may be recognized it may not be loadable with this version of TrackConv. You
  206. can also use the GuessType feature to work out what format the music is in
  207. without set-typing it.
  208.  
  209. To save a file go to the 'Save' option on the icon bar menu and go through
  210. the various submenus. Then enter your file name and drag