home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / music / _coconizer / coconizer / _toolbox / readme / userguide
Encoding:
Text File  |  1993-08-19  |  8.2 KB  |  183 lines
  1.                ------------------------------------------
  2.                --  Information on Coconizer's ToolBox  --
  3.                ------------------------------------------
  4.  
  5. ==================
  6. =  Introduction  =
  7. ==================
  8.  
  9. The ToolBox contains Wimp revisions of the former Coconizer tools. They are
  10. bundled in one application now. A tool can be activated by selecting its
  11. menu item in the main menu.
  12.  
  13. A few things are different with the newer Coconizer. The old filetype &664
  14. for CocoSongs has been moved to &364, and a new filetype &365 for trackfiles
  15. (CocoTrak) has been invented. All the InstA-InstZ directories changed their
  16. names into a linear hex order from Inst00 to InstFF. Please settype your old
  17. songs and rename your directores *before* using the new package (and please
  18. note that Inst0A follows to Inst09, and Inst10 follows to Inst0F, it's hex).
  19.  
  20.  
  21. ===============
  22. =  The Tools  =
  23. ===============
  24.  
  25. The Locator:
  26. ¯¯¯¯¯¯¯¯¯¯¯¯
  27. Drag your first sample directory Inst00 to this window. The tool will then
  28. scan all the following sample directories in order to build the well known
  29. file "Location" which is essential for Coconizer and its applications.
  30. Please ensure to have ticked the 'harddisk' configure item correctly, ie if
  31. the samples are stored on floppy disks this menu item shouldn't be ticked!
  32. In the latter case please insert your sample disks always in drive 0. By the
  33. way, disabling the multitasking option speeds up the directory scanning
  34. quite a lot.
  35.  
  36. In contrast to the old Coco version you can put as many Inst directories on
  37. one disk as you want, provided they increase their hex number linear and all
  38. disks together do not use more than 256 dirs in total. Up to 256 disks can
  39. be handled. On a harddisk you have to put all your Inst-directories in one
  40. directory.
  41.  
  42.  
  43. The Amiga Soundtrack Converter:
  44. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  45. It converts Amiga Protracks to Coconizer trackfiles. As the ToolBox has to
  46. convert the song and its samples you'll need twice the amount of RAM the
  47. original track takes.
  48. On the Amiga several soundtrackers do exist, with Protracker being the most
  49. popular one. Still, although they all have a very similar basic format, some
  50. vary in the interpretation of certain commands and effects.
  51.  
  52. The ToolBox converts most things pretty correctly. Slight differences can
  53. occur with the slide command, because Amiga trackers store note values as
  54. periods. Sliding does modify this period by a variable step and the result
  55. changes the final output frequency logarithmically. Coco on the other side
  56. does use single note values which are translated into linear sample output
  57. frequencies. Anyway, the ToolBox does its best in order to convert all
  58. slides as accurate as possible. In most cases the results are fully OK.
  59.  
  60. Problems usually appear when you try to convert newer tracks which use the
  61. special effects of the Protracker, especially the put on 'E'-effects. Still,
  62. it's not the main aim of Coconizer to replay Amiga soundtracks.
  63.  
  64. New Protracker commands which aren't converted (yet) :
  65.  03 - Tone Portamento
  66.  04 - Vibrato
  67.  05 - Tone Portamento + Volume Slide
  68.  06 - Vibrato + Volume Slide
  69.  07 - Tremolo
  70.  09 - Set Sample Offset
  71.  0E - The put on E-effects
  72.  
  73. The reasons for not implementing them are:
  74.  a) the same effects can be achieved by mixing Coconizer effects manually,
  75.  b) we don't exactly know how they work,
  76.  c) no motivation to emulate Amiga's Paula.
  77.  
  78. If a Protrack has lots of the above effects, please keep the original track
  79. as well - as unknown effects are cleared by the ToolBox (oh dear, I know,
  80. lossy conversion..). Future versions of Coconizer can probably convert some
  81. more of these effects.
  82.  
  83. Please note that files with the official Acorn filetype &CB6 (for "Sound
  84. Tracker files"), as used by the commerical Archimedes !Tracker, are *not*
  85. Amiga SoundTracks at all but !Tracker files, with a different format and
  86. lost information.
  87. The ToolBox does only convert tracks in *real* Protracker format (filetype
  88. &001 we think). Hence you will usually get a "can't fetch enough memory"
  89. error or weird infos printed if you drag wrong files (including !Tracker
  90. ones) to the convert window. By the way, Teque Music soundfiles (type &CC5),
  91. as used by several commercial game companies, are true Protracks.
  92.  
  93.  
  94. The Unused Samples Wiper:
  95. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  96. When you delete songs there usually will rest some unused samples in your
  97. collection and this tool does detect and delete them. Please drag all your
  98. songs in the wiper window. Each song is scanned and its samples are marked.
  99. When you finished you can start the operation by clicking the 'Wipe' button,
  100. which pops up a savety request.
  101. Please be absolutely sure that *ALL* songs have been analysed in this phase,
  102. because the wipe operation will delete all samples which haven't been marked
  103. during analysing!
  104.  
  105.  
  106. The Coco Module Ripper:
  107. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  108. A former Coconizer tool made module files which contained a player routine,
  109. the song and its samples, all ready to be loaded as relocatable module. To
  110. convert such a module into a trackfile, drag it to the extract window. It's
  111. advisable to convert your old modules to trackfiles, as this is usually much
  112. handier (in case new versions of the player appear) and you've more control
  113. over them (via the central player module). Modules which have been converted
  114. to absolute (squeezed) files should be unpacked first of course.
  115.  
  116.  
  117. ===========================
  118. =  The Configure section  =
  119. ===========================
  120.  
  121. The five configure options can be saved permanently and take effect when the
  122. application is loaded. Apart from the item 'OutlineFonts' the others do also
  123. have immediate effect, ie during the usage of the application.
  124.  
  125. - Multitasking:
  126. Some tools support this. Ticking it slows down their working speed but will
  127. also increase the time available for other Wimp programs and hence gives a
  128. much better multitasking feeling.
  129.  
  130. - Show skips.
  131. If ticked, every skipped command/effect of the Protrack is shown each time
  132. it occurs. Disabling this option speeds up the window display quite a lot
  133. and just shows the number of skipped effects at the end of each pattern.
  134.  
  135. - Outline Fonts:
  136. If you own a multiscan monitor and are using RISC OS 3 you can tick this
  137. item to improve the outfit of the windows. Low res monitor users: Beware!
  138.  
  139. - Harddisk:
  140. If you have all your samples on the same media (ie harddisk or other) then
  141. please thick this item. It ensures that you aren't bothered with "Insert
  142. disk" messages and other things. On the other side you can really fool the
  143. Coconizer applications if you set this option wrong, say, you're dragging
  144. the Inst00 dir from a disk to the Locater whilst having set the harddisk
  145. option.
  146. When having located, the harddisk flag and the sample's root dir are saved
  147. together with the Location file, so that the !Coconizer editor and the Wimp
  148. !Player can also rely on this information.
  149.  
  150. - Logarithmic:
  151. This item specifies if the samples of the Amiga soundtrack will be converted
  152. from their signed linear format into the logarithmic one the VIDC needs (and
  153. hence Coconizer does so too). Usually you should let this tick on, but we've
  154. already seen some exotic Amiga tracks with logarithmic sample format. And by
  155. the way, you'll hear it very soon when the wrong format has been taken..
  156.  
  157.  
  158. ======================
  159. =  Copyright Notice  =
  160. ======================
  161.  
  162. The Coconizer !ToolBox and its documentation are copyrighted by Eduard Pfarr
  163. of Armaxess. The software is Freeware, which means you may use and copy it
  164. freely, provided *all* files are included *unaltered*, and not for any
  165. profit.
  166.  
  167. This software is provided 'as is'. Using it is entirely at your own risk.
  168.  
  169. The Coconizer package consists of the editor !Coconizer, the Wimp !Player
  170. and this !ToolBox. No application, except the Wimp !Player or its player
  171. module, is to be copied without the others included.
  172.  
  173.  
  174. This application is dedicated to Freddie Mercury and Queen, the Kings of
  175. Rock. The four guys: Freddie Mercury, Brian May, Roger Taylor and John
  176. Deacon. What a great band this was!
  177. Further cool music comes from: Bangles, Roxette, Enya (who does inspire so
  178. wonderfully), Dalbello, Shakespears Sister, ZZ Top, and some more. But
  179. still, nothing compares to Wolfgang Amadeus Mozart, Johann Sebastian Bach,
  180. Georg Friedrich Händel, Joseph Haydn, Ludwig van Beethoven, Franz Schubert,
  181. Robert Schumann, Johannes Brahms, Edvard Grieg, Anton Dvorák, and several
  182. more. Because this is real music.
  183.