home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / SOUNDUTILS / tracker.4.6.lzh / TRACKER4.6 / MAN / tracker.1 next >
Text File  |  1994-11-14  |  5KB  |  118 lines
  1. .TH TRACKER 1 "22 August 93"
  2. .SH NAME 
  3. tracker - play soundtracker modules on a Unix machine.
  4. .SH SYNOPSIS
  5. .B tracker 
  6. [\fB-help\fR]
  7. [\fB-new|old|both\fR]
  8. [\fB-verbose\fR]
  9. [\fB-quiet|scroll\fR]
  10. [\fB-sync\fR]
  11. [\fB-picky|tolerant\fR]
  12. [\fB-mono|stereo\fR]
  13. [\fB-mix \fIpercent\fR]
  14. [\fB-frequency \fIhertz\fR]
  15. [\fB-oversample \fIn\fR]
  16. [\fB-speed \fIhertz\fR]
  17. [\fB-transpose \fIhalftones\fR]
  18. [\fB-repeats \fInumber\fR]
  19. [\fB-start \fIpattern\fR]
  20. \fI filename\fR ...
  21. .SH DESCRIPTION
  22. \fItracker\fR plays soundtracker music modules on a Unix machine.
  23. Soundtracker modules originated on the amiga, where several composing
  24. playing programs are available, that give results mostly compatible with
  25. each other. \fItracker\fR just plays the specified files in sequence 
  26. according with the current options.
  27. .SH OPTIONS
  28. Options can usually be abreviated, and are case-insensitive, so that
  29. \fB-Over\fR will stand for \fB-oversample\fR, for instance.
  30. .IP "\fB-help\fR"
  31. Displays a small useful help message.
  32. .IP "\fB-new|-old|-both\fR"
  33. Selects which soundtracker format to read. Old trackers had only room for
  34. 15 samples, instead of the more modern ones with 31 samples. \fB-both\fR
  35. is the default behaviour, which tries to choose automatically between the
  36. old and the new format.
  37. .IP "\fB-verbose\fR"
  38. Shows a dump of the module samples section on loading.
  39. .IP "\fB-quiet|-scroll\fR"
  40. Selects whether a scrolling event table is displayed while the module is
  41. played. Default is to stay quiet.
  42. .IP "\fB-sync\fR"
  43. Tries to keep the audio output in sync with the scrolling display at the
  44. expense of more processor power.
  45. .IP "\fB-picky|-tolerant\fR"
  46. Selects \fItracker\fR's behaviour with regard to erratic problems in some
  47. modules. If you select \fB-picky\fR, only really clean modules will be
  48. played. If you select \fB-tolerant\fR, almost anything will get through
  49. tracker, including pure binary files not related with modules which will
  50. sound as so much white noise. Default behaviour lies somewhat in between.
  51. .IP "\fB-mono|-stereo\fR"
  52. Selects monaural or stereo output (provided your system has stereo capability).
  53. Keeping in mind that some amiga composers don't have stereo output, some modules
  54. will seem to float between the speakers when played in stereo. Also, stereo
  55. needs twice the output bandwidth and can consume much more cpu power.
  56. .IP "\fB-mix \fIpercent\fR"
  57. Sets amount of mixing between the left and right channels in stereo mode to
  58. \fIpercent\fR.
  59. Varies between 0 percent (monaural) to 100 percent (spatial stereo).
  60. .IP "\fB-frequency \fIhertz\fR"
  61. Sets output resampling frequency to \fIhertz\fR, in hertz. That frequency
  62. can be clipped according to your audio equipment ability. The useful range
  63. lies between 8000 and 48000 hertz. It's useless to go any higher since
  64. the amiga is limited at about 33000 hertz, and the human ear doesn't know
  65. the difference anyway. Default depends upon your equipment.
  66. .IP "\fB-oversample \fIn\fR"
  67. Sets oversampling to \fIn\fR. Resampling is used to pitch the sampled sounds
  68. at the right frequency. Oversampling can be used to smooth out aliasing
  69. problems, at the cost of more cpu power. Useful values lie between 2 and 4.
  70. Defaults to no oversampling.
  71. .IP "\fB-speed \fIhertz\fR"
  72. Sets playing speed to \fIhertz\fR ticks per second. The default value is 50,
  73. but 60 may be appropriate for pieces  composed in the united states.
  74. Note that changing the playing speed does not change the pitch.
  75. .IP "\fB-transpose \fIhalftones\fR"
  76. Transposes each note of the module by \fIhalftones\fR halftones up. This
  77. migh not work with some modules, or give out strange results since some effects
  78. will be approximate.
  79. .IP "\fB-repeats \fIn\fR"
  80. Repeats each module \fIn\fR times before playing the next. Default is to play
  81. each module once. \fI0\fR makes the next module play indefinitely.
  82. .IP "\fB-start \fIpattern\fR"
  83. Starts playing module at pattern number \fIpattern\fR instead of the default
  84. 0.
  85. .SH RUNTIME COMMANDS
  86. At play time, some keystrokes effect a limited control on tracker.
  87. .IP n
  88. Skip to next module.
  89. .IP p
  90. Skip to previous module / restart current module.
  91. .IP "x, e, q"
  92. Exits.
  93. .IP s
  94. Set speed to 50.
  95. .IP S
  96. Set speed to 60.
  97. .IP >
  98. Skip to next pattern in current module.
  99. .IP <
  100. Restart current pattern / Skip to previous pattern.
  101. .IP ?
  102. Toggle event scroller on.
  103. .IP !
  104. Toggle event scroller off.
  105. .SH SEE ALSO
  106. An Amiga. You just \fIhave\fR to see one.
  107. .SH BUGS AND FEATURES
  108. Since the soundtracker format is not a real format at all, some music
  109. modules may not sound as originally intended.
  110.  
  111. \fItracker\fR only supports soundtracker modules for the time being, not 
  112. soundtracker songs with external samples, nor MED or TFMX or StarTrekker8
  113. nor any other amiga-originated format.
  114.  
  115. Send all complaints/praise/real bug reports to espie@ens.fr
  116. .SH AUTHOR
  117. Marc Espie
  118.