home *** CD-ROM | disk | FTP | other *** search
/ ftp.4front-tech.com / ftp.4front-tech.com.tar / ftp.4front-tech.com / ossfree / snd-util-3.8.tar.gz / snd-util-3.8.tar / sndkit / dsp / str / Readme < prev    next >
Text File  |  1997-12-08  |  5KB  |  143 lines
  1. SparcTracker ver. 1.2 by Liam Corner and Marc Espie
  2. ===================================================
  3.  
  4. NOTE! This is an old and obsolete version. The latest version is
  5.       called tracker-3.19.
  6.  
  7. #ifdef linux
  8. This version contains some minor modifications for Linux by Hannu Savolainen
  9. (hannu@opensound.com) and Leif Kornstaedt (l_kornst@informatik.uni-kl.de).
  10.  
  11. Have a look at the options in the Makefile (e.g. the -m486 option) and at
  12. the str.h header file, in which you may configure some things.
  13.  
  14. Please edit DSP_SPEED in the file str.h before compiling. The default
  15. setting for output frequency is 23 kHz, which may be too fast for 386/386sx
  16. machines. At least you have to change it if there happens to be short
  17. pauses in playback.
  18. #endif
  19.  
  20. Well, here they are the first tracker module players for the Sun
  21. Sparcstations.  There are 2 players, one for the 15 sample modules and one for
  22. the 32 sample ones (or should that be 31 :-).  The code is not that different,
  23. but I could not be bothered to write an auto detection routine that worked on
  24. standard input.
  25.  
  26.  
  27. Usage
  28. -----
  29.  
  30. Usage is very simple, either give the player the filename of the module, or if
  31. the module is compressed(frozen) you can zcat(fcat) and pipe the result into
  32. the player thus :
  33.  
  34.         str32 -h
  35.         str32 [options] module ...
  36.         zcat module.z | str32 [options]
  37.         fcat module.F | str32 [options]
  38.  
  39. If you have a new module and are unsure of which player (str15 or str32) to
  40. use then try both.  If you choose the wrong one then you may get an error
  41. message or nothing at all will happen (except maybe a core dump :-).  For
  42. this reason I keep my trackers in separate directories so that I know which
  43. player to use.
  44.  
  45. Not many effects are implemented, so the result may not be exactly the same as
  46. an Amiga player, but it is usually OK.  The sound quality of the /dev/audio is
  47. not too hot, so some sounds are lost, usually the bass.
  48.  
  49. Options
  50. -------
  51.  
  52. This version acceps several command line options:
  53.  
  54.     -s kHz        Sets the playback speed. For example
  55.             str32 -s 20 plays the module with
  56.             22 kHz sampling frequency.
  57.     -S        Plays the module in stereo.
  58.     -c        Non-stop mode.
  59.     -q        Quiet.
  60.     -b bits        Sets the sample size (8 or 16 bits).
  61.     -o file        Redirects output to a file or
  62.             another device.
  63.  
  64. Errors
  65. ------
  66.  
  67. The only error not totally self-explanatory is the 'corrupt input file' one.
  68. This sometimes indicates that you have used the wrong player, but
  69. occassionally it may be that the module is too short by a few bytes.  I have
  70. only come accross this in a couple of cases and just appending a few null
  71. bytes to the end usually cures this.
  72.  
  73.  
  74. The Future
  75. ----------
  76.  
  77. I may get around to combining the players into a single program and enhancing
  78. the error detection a bit, but then again I might not :-).  If anyone else
  79. wants to add these functions, add more effects or correct any errors there may
  80. be in the current programs then please go ahead - I hope the code is
  81. understandable enough for you.
  82.  
  83.  
  84. Copyright Stuff
  85. ---------------
  86.  
  87. Most of the code is copyright me.  The convert routine is copyright Rich
  88. Gopstein and was borrowed from the iff2ulaw utility.  The code is freely
  89. distributable as long as this message and the copyright messages in the source
  90. are included.  You are welcome to update the source code.
  91.  
  92.  
  93.         Liam Corner - University of Warwick - 1st November 1991
  94.  
  95.         csubt@csv.warwick.ac.uk
  96.         zenith@dcs.warwick.ac.uk
  97.  
  98.  
  99.  
  100. Version 1.2 - 3rd November 1991
  101. -------------------------------
  102.  
  103. Thanks to Marc Espie for doing most of the first update.  There is now only
  104. one player str15 and a link from str32 to str15, so you will still have to
  105. choose the correct player for a given module.  There is now output showing
  106. module name, sample names and progress through the module as it plays.  More
  107. effects are implemented and a bug with the sample repeat loop has been fixed.
  108.  
  109.  
  110. Patch 08/27/92 by Hannu Savolainen
  111. ----------------------------------
  112.  
  113. Modified to use integer arithmetic.
  114.  
  115.  
  116. Version 1.5 - 31st January 1993 by Leif Kornstaedt
  117. --------------------------------------------------
  118.  
  119. - Now all standard NoiseTracker 1.0 effects should be implemented correctly,
  120.   as well as some bugs fixed (and the step_table calculations more accurate).
  121.  
  122. - Some command line options have been added, namely:
  123.  
  124.     -v        verbose: the score is shown while playing
  125.     -z        zcat is applied to the files before playing
  126.  
  127. - You can now give a default path to search modules when they are not found
  128.   in the current working directory.  E. g. using /bin/bash do
  129.  
  130. $ export MODPATH=/usr/local/lib/mod/tracks15:/usr/local/lib/mod/tracks32
  131.  
  132.  
  133. TODO:
  134.  
  135. - automatically determine the number of instruments instead of having
  136.   str15 and str32 (by testing 'M.K.' sig)
  137. - insert a shuffle mode: let the player play all songs in the module
  138.   path, but shuffled like a CD player does.
  139.  
  140.  
  141. Please let me know if you find something to ameliorate. -- L. K.
  142. l_kornst@informatik.uni-kl.de
  143.