home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaMiscModsCD3.iso / _PROGRAMME / TOOLS / ps3mrec.lha / PS3Mrec.doc < prev    next >
Encoding:
Text File  |  1997-12-17  |  6.0 KB  |  196 lines
  1. ***************************************************************************
  2.                            PS3M recorder v2.1
  3.                     -- FREEWARE --
  4. ***************************************************************************             
  5.  
  6. PS3M recorder is a program that loads several kinds of music module formats
  7. and turns them into IFF, AIFF or RIFF WAVE samples.  The usage:
  8.  
  9. PS3Mrec <module> <dest> <mode> <rate> <boost> <W/S> [pan]
  10.  <module>: module to be recorded (MOD/FT/XM/S3M/MTM/DB)
  11.  <dest>: destination filename
  12.  <mode>: sample type to be created...
  13.     0 = IFF 8-bit stereo
  14.     1 = IFF 8-bit surround
  15.     2 = IFF 8-bit stereo separated
  16.     3 = IFF 8-bit mono
  17.     4 = AIFF 16-bit stereo
  18.     5 = AIFF 16-bit surround
  19.     6 = AIFF 16-bit mono
  20.     7 = RIFF WAVE 16-bit stereo
  21.     8 = RIFF WAVE 16-bit surround
  22.     9 = RIFF WAVE 16-bit mono
  23.  <rate>: sampling rate in Hz (5000-60000)
  24.  <boost>: volume boost (0-999)
  25.  <W/S>: W = write to disk, S = simulate, calculate optimal volume boost
  26.  [pan]: panning value for surround modes (1-99)
  27.  
  28.  
  29. <module>
  30. --------
  31. The module must be unpacked or XPK packed and one of the following formats:
  32. Protracker (MOD), Fasttracker I (FT), Fasttracker II (XM), Screatracker III
  33. (S3M), Multitracker (MTM), DigiBooster (DB).
  34.  
  35. ** NOTE:  If you want to load XPK packed modules you must have the
  36. xpkmaster.library and some sublibs installed in Libs:.
  37.  
  38. ** NOTE:  DigiBooster modules are first converted to Fasttracker I format.
  39. This means that samples over 64kB will be truncated and non-PT commands are
  40. ignored (including finetune).  All DB mods will not convert properly, watch
  41. out.  Also watch out the memory requirements, at least 2x the module size
  42. is needed.  Conversion routine by Antti Lankila (STL/Damage).  Thanks!
  43.  
  44.  
  45. <dest>
  46. ------
  47. Destination filename.
  48.  
  49.  
  50. <rate>
  51. ------
  52. Rate is the sampling rate to be used.  The higher the better sound quality
  53. (and longer rendering time).  
  54.  
  55.  
  56. <boost>
  57. -------
  58. With volume boost you can boost up the volume, obviously.  Too high a value
  59. can cause 'clipping', decreasing the sound quality.  0 means no boost, 100
  60. means double volume, 200 triple etc.
  61.  
  62.  
  63. <W/S>
  64. -----
  65. W = Write the output to disk.
  66. S = Simulate, don't write.  With this switch you can find out the optimal
  67.     volume boost value (max volume without clipping) for each module and mode.
  68.     To get the best sound quality you should first find out the best volume
  69.     boost with simulate and then record using that boost value.
  70.  
  71. ** NOTE:  Every mode (with different panning parameters) can have different
  72.           optimal boost values.
  73.  
  74.  
  75. [pan]
  76. -----
  77. For the surround modes only (1, 5, 8)!
  78. The greater pan value, the louder will the left side be mixed to the right
  79. side and vice versa.  Value 1 is near stereo, and 99 near mono.
  80.  
  81.  
  82.  
  83. Operation
  84. ---------
  85. When recording there will be a progress indicator showing the module time
  86. and how many kilobytes have been recorded.  The process will stop when the
  87. module ends, the user presses CTRL+C (break) or some error occurs.
  88.  
  89. Remember that you will need lot's of hd space.  Example:  A tune lasting
  90. 3:49 with sampling rate 28000 would take (3*60+49)*28000*2=12.2 megabytes
  91. hd space, and twice as much with 16-bit output.
  92.  
  93.  
  94.  
  95. IFF & AIFF & RIFF WAVE
  96. ----------------------
  97. PS3M recorder offers three different sample formats:
  98.  
  99. IFF 8SVX 8-bit mono/stereo (the Amiga sample format by Electronic Arts),
  100. AIFF 16-bit stereo (used on Apple and SGI),
  101. RIFF WAVE PCM 16-bit stereo (Microsoft Windoze sample format).
  102.  
  103. The stereo modes have the left and right side separated, and surround modes
  104. have the right side mixed to the left and vice versa according to the pan
  105. value.  The mono modes have the both sides mixed together.
  106.  
  107. IFF stereo separated (mode 2) creates two IFF samples, one for the left and
  108. one for the right side.
  109.  
  110. The surroud and mono modes will cause a slight decrease in sound quality
  111. due to additional mixing.
  112.  
  113. The mixing routines use 16-bit calculations.
  114.  
  115.  
  116.  
  117.  
  118. Who needs it?
  119. -------------
  120. Those who don't have enough CPU to play all those PC modules with good
  121. quality and at the same time have big hds.  Or, if you want to transfer
  122. modules directly onto audio CDs.  That's the reason for this program to
  123. exist.
  124.  
  125.  
  126.  
  127. Requirements
  128. ------------
  129. Any Amiga, ANY kickstart (even kick1.1 should work :) and some storage
  130. media, preferably a HD.
  131.  
  132. PS3Mrec is quite memory hungry.  You will need about 820kB memory for the
  133. program only, and some more for the module.  But as they say, bigger tables
  134. make faster programs ;-)
  135.  
  136.  
  137.  
  138. Bugs?
  139. -----
  140. Haven't encountered anything serious. Reports appreciated.
  141.  
  142.  
  143.  
  144. Credits
  145. -------
  146. Code by K-P Koljonen / Hippopotamus Design
  147. PS3M 0.960 replayers and mixing system by Jarno Paananen (Guru/Sahara Surfers)
  148. DigiBooster -> FastTracker conversion routine by Antti Lankila (STL/Damage)
  149. Requested by Hst-Bullah / Hard Disk Cafe
  150.  
  151.  
  152.  
  153. Contact
  154. -------
  155. E-mail: kpk@cc.tut.fi
  156.     k-p@s2.org
  157.  
  158. WWW:    http://www.students.tut.fi/~kpk
  159.  
  160. Snail:    K-P Koljonen
  161.     Torikatu 31
  162.     FIN-40900 Säynätsalo
  163.     Finland
  164.  
  165.  
  166.  
  167. History
  168. -------
  169. v1.0            Seems to work.
  170. v1.1 (30.3.1996)    Initial release.
  171. v1.2               A bug fixed, pos/len-counter added,
  172.             AIFF 16-bit support added
  173. v1.3 (2.4.1996)        All in one.
  174. v1.4 (11.4.1996)    Sampling rate used exactly as given.
  175.             Mode 3: separate IFF files for both sides.
  176. v1.5 (20.4.1996)    AIFF stereo mode.
  177.             Real 16-bit mixing for AIFF instead of 8-bit.
  178. v1.6 (24.4.1996)    Added RIFF WAVE (PCM) support.
  179.             Added IFF mono.
  180.             v1.5 mangled the 16-bit data, should work now.
  181.             Different versions for 8-bit and 16-bit mixing.
  182.             Min. sampling rate lowered to 5000.
  183. v1.7 (26.4.1996)    A proper volume boost system for all modes.
  184.             Simulate mode for finding out the optimal boost.
  185.             IFF mode now creates only one file.
  186. v1.8 (12.5.1996)    AIFF MONO and RIFF WAVE MONO added.
  187. v1.9 (22.6.1996)    User-specified destination filename.
  188.             XPK packed files support with xpkmaster.library.
  189.              No need to enter all the zeroes anymore.
  190.             Panning for surround modes.
  191.             000/010 and 020+ optimizations.
  192. v2.0 (2.10.1996)    DigiBooster module format support.
  193.             Some bugs in the replayers fixed.
  194. v2.1 (17.12.1997)    Sound distortion problem removed.
  195.             Some optimizations.
  196.