home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 3 / AUCD3.iso / funland / emulators / c64 / sid2wav / !Sid2Wav / !Help < prev    next >
Text File  |  1997-07-05  |  5KB  |  142 lines
  1.  
  2.                    Sid2Wav 0.70
  3.                   --------------
  4.  
  5. Hi!  This is my attempt at porting the Sid2Wav/
  6. Sidplayer utilities to the Acorn platform. (About
  7. @%&$*! time, eh?)
  8.  
  9. This program is based on the portable Sid2Wav
  10. program by Michael Schwendt and others (see the
  11. copyright notice in the "docs" directory).  I
  12. changed as little as possible in the program.  All
  13. the emulation routines were left completely alone,
  14. I merely added a "direct replay" option and the
  15. code for it.
  16.  
  17. The software underlies the same copyrights as the
  18. original PC version.  The C64Voice module was
  19. written by me.  It is *not* PD.  You are allowed
  20. to copy and use it in conjunction with this port
  21. of the Sid2Wav software.
  22.  
  23. The "frontend" is based on the style of the MIDI
  24. replay tool !Timidity, thus the icon is more or
  25. less stolen from it. I hope I'm forgiven.  :)
  26.  
  27.  
  28. SYSTEM REQUIREMENTS:
  29.  
  30. Lots of memory and lots of speed.  :)
  31.  
  32. As of version 0.70 this program is based on a
  33. newer version of the emulator engine which sounds
  34. a lot better, but is, alas, also quite a bit
  35. slower.  On my A5000 it runs reasonably well with
  36. a sample frequency of 11025hz and the filter
  37. emulation turned off, but I'd better not try it in
  38. mode 28 or something like it.  To experience the
  39. full quality of the sound, I have to create a Wav
  40. file and play it with !SoundCon.  For this reason
  41. I have decided to keep the last version (V0.62)
  42. available for those of us who like to run SID music
  43. in the background in a taskwindow while doing
  44. something else. :)  You can find it at my homepage
  45. on the World Wide Web, under the URL:
  46. <http://enterprise.mathematik.uni-essen.de/~bastian/downloads/>
  47.  
  48. I'd like feedback about the performance of the
  49. program on other machines, like RiscPCs with or
  50. without StrongARM processors.
  51.  
  52.  
  53. USAGE:
  54.  
  55. The way Sid2Wav is preconfigured, doubleclicking 
  56. on a file of type &063 (or "SIDSong") will start
  57. the program and attempt to play the song directly. 
  58. In the !Boot file the configuration can be changed. 
  59. You can choose either direct replay or Wav
  60. generation as the default action, and in the 
  61. corresponding Obey files "MakeWav" and "Replay"
  62. you can choose between singletasking or multitasking
  63. in a taskwindow.
  64.  
  65. Basically all this is just a small front for the
  66. Sid2Wav application - you could delete all of it and
  67. use the program on its own.  The direct replay
  68. option requires the C64Voice module to be present.
  69.  
  70. When replaying, there will be numbers flashing at
  71. the bottom of the window.  These show the size of
  72. the Buffer chunk currently being filled.  The first
  73. chunk is, of course, the size of the entire buffer
  74. and may take some time to fill, particularly on a
  75. slow machine (like mine).  During replay you can
  76. press the number keys from 1-9 and letters from a-z
  77. to choose song 1-35.  The "+" and "-" keys cycle
  78. forwards and backwards through the songs.  You can
  79. also set the starting song via the "-o" option in
  80. the <Sid2WavR$Options> system Variable.
  81.  
  82.  
  83. SYNTAX:
  84.  
  85.  SID2WAV [-<commands>] [<datafile>|-] [outputfile]
  86.  commands: -h         display this screen
  87.            -f<num>    set frequency in Hz 
  88.                       (default: 22050)
  89.            -16        16-bit (default: 8-bit)
  90.            -s         stereo (default: mono)
  91.            -ss        enable stereo surround
  92.            -u         au output (8000Hz mono 8-bit 
  93.                       u-law)
  94.            -o<num>    set song number 
  95.                       (default: preset)
  96.            -a         improve PlaySID compatibility 
  97.                       (not recommended)
  98.            -a2        bank switching mode 
  99.                       (overrides -a)
  100.            -nf        no SID filter emulation
  101.            -n         enable NTSC-clock speed for VBI 
  102.                       tunes (not recommended)
  103.            -m<num>    mute voices out of 1,2,3,4 
  104.                       (default: none)
  105.                       example: -m13 (voice 1 and 
  106.                       3 off)
  107.            -t<num>    set seconds to play 
  108.                       (default: 60)
  109.            -fin<num>  fade-in-time in seconds 
  110.                       (default: 0)
  111.            -fout<num> fade-out-time in seconds 
  112.                       (default: 2)
  113.  
  114. Rather straightforward, actually.  In direct replay,
  115. the -t option sets the size of the buffer to n
  116. seconds.  You should take care that it is set to
  117. something suitable, like 5-15 seconds.  The default
  118. of 60 seconds would get rather large (although it
  119. won't grab more than 640k, no matter what the set
  120. time is).
  121.  
  122.  
  123. CAUTION:
  124.  
  125. This is merely a beta release or something like
  126. that.  I am far from finished with this thing - 
  127. when I am, it will be a fully integrated WIMP task
  128. with lots of knobs on and a better sound system 
  129. (four separate channels for the C64 voices, instead
  130. of one mixed one).  Handle with care and FOR GOD'S 
  131. SAKE don't use it while doing something important. 
  132. it may crash at any time - and I would appreciate
  133. bug reports about such times (address see below).
  134.  
  135. Otherwise I hope you have fun with this - I know I
  136. had.
  137.  
  138. Sebastian Weinberg
  139.  
  140. E-Mail:
  141. <bastian@enterprise.mathematik.uni-essen.de>
  142.