home *** CD-ROM | disk | FTP | other *** search
/ Secret Service 38 / SSERV_38_CD.bin / utils / sharewar / amp13.arj / AMP.TXT < prev    next >
Text File  |  1996-03-31  |  8KB  |  208 lines
  1.     ==============================================================
  2.                 A M P   1.3
  3.       The module player for Sound Blaster AWE32 and compatibles
  4.     (c) 1995-1996 by Lada Kopecky a.k.a. Grinus / Torture Of Music
  5.     ==============================================================
  6.  
  7.  
  8. FEATURES
  9.  
  10.  - plays XM modules (FT2.0x, format version $0104)
  11.  - plays S3M modules (ST3.0 - 3.21)
  12.  - plays MOD/NST modules (M.K.  FLT4  nCHN  nnCH  OCTA  N.T.)
  13.  - plays MTM modules
  14.  - plays multiple modules (using wildcards and/or listfiles)
  15.  - up to 32 channels and 30 sounding notes
  16.  - makes no clicks!
  17.  - the strict compatibility with the FT2.06 and ST3.21 playback routines!
  18.  - can play in Windows, even in background!
  19.    Just increase the Priority (using PIF editor) in Windows 3.x or decrease
  20.    the Idle Sensitivity (in Properties of AMP icon) in Windows 95 to achieve
  21.    the continuous playback.
  22.    However, the background playback may be affected by running other tasks.
  23.  - supports the animated messages using sample names
  24.  - can report all suspicious events! (during the module load and playback)
  25.  - fast forward mode, pattern skip in both directions
  26.  - forced tempo mode
  27.  - settings taken from AMP.INI or the command line
  28.  - can play if not enough AWE memory
  29.  - no problems with memory or extenders (68-200 KB of DOS memory is enough)
  30.  - does not change the Sound Blaster mixer settings
  31.  - and of course, the maximal sample upload speed :)
  32.  
  33.  
  34.  
  35. SWITCHES  (preceded by '/' or '-')
  36.  
  37.   V     verbose mode
  38.       - all info shown in Log window, incl. unsupported effects in runtime
  39.       - message colors: INFOS - white, WARNINGS - yellow, ERRORS - red
  40.  
  41.   S     single mode
  42.       - no module looping, no batch looping
  43.  
  44.   P     pause mode
  45.       - waits at the end of each module in single mode
  46.         (you can continue switching and scrolling the screens)
  47.  
  48.   F     force play if not enough AWE RAM
  49.       - some samples will be ignored
  50.  
  51.   I     show numeric pan values 0 to F and M (instead of L/M/R)
  52.  
  53.   Xn    force the EMU8000 base port (in hex, e.g. 620 or 640)
  54.       - if you include this switch, AMP won't use the 'BLASTER' variable
  55.             nor autodetect routine
  56.  
  57.   Nn    default panning from the middle (0..127, default 72)
  58.       - this is the initial panning of the left/right MOD/S3M channels
  59.         (something like 'n' switch in DMP player)
  60.  
  61.   Mn    initial volume 0..64 (default is the automode)
  62.       - in automode the initial volume depends on the number of channels
  63.  
  64.   Rn    initial reverb level (0..255, default 36)
  65.  
  66.   Cn    initial chorus level (0..255, default 0)
  67.  
  68.   En    reverb type (0..7, default 4)
  69.  
  70.   On    chorus type (0..7, default 0)
  71.  
  72.   Bn    initial bass level   (0..11, default 5)
  73.  
  74.   Tn    initial treble level (0..11, default 5)
  75.  
  76.      n      Bass/Treble       Reverb Type      Chorus Type
  77.     ---     -----------       -----------      -----------
  78.      0        -12 dB          Room 1           Chorus 1 (*)
  79.      1         -8 dB          Room 2           Chorus 2
  80.      2         -6 dB          Room 3           Chorus 3
  81.      3         -4 dB          Hall 1           Chorus 4
  82.      4         -2 dB          Hall 2 (*)       Feedback Delay
  83.      5          0 dB (*)      Plate            Flanger
  84.      6         +2 dB          Delay            Short Delay
  85.      7         +4 dB          Panning Delay    Short Delay Feedback
  86.      8         +6 dB
  87.      9         +8 dB
  88.     10        +10 dB
  89.     11        +12 dB
  90.  
  91.  All switches above can be used in AMP.INI, one option per line.
  92.  The command line switches take precedence over the INI file settings
  93.  (but the On/Off switches V/F/S/P/I can't be reset from the command line).
  94.  AMP.INI must be placed in the same directory as AMP.EXE !
  95.  
  96.  
  97.  
  98. MODULES AND LISTFILES
  99.  
  100.  You can specify one or more modules and/or listfiles in the command line.
  101.  You can use wildcards in module names. The extensions may be omitted.
  102.  The listfile is the list of modules to play, one filename per line.
  103.  The lines with leading ';', '#' or space will be ignored (also in AMP.INI)
  104.  
  105.  
  106.  
  107. KEYBOARD
  108.  
  109.   F1            Help Screen
  110.   F2            Log Screen (in verbose mode only)
  111.   F3            Channels Screen
  112.   F4            Instruments Screen
  113.   PgDn PgUp     scroll channels or instruments
  114.  
  115.   Enter         fadeout and the next module in batch
  116.   ->            pattern forward (the remaining pattern data are ignored)
  117.   <-            pattern back
  118.   Up            fast forward (4-times faster)
  119.   Ctrl Down/Up  forced tempo down/up (the remaining tempo changes are ignored)
  120.  
  121.   Esc           fadeout and exit to DOS
  122.   spacebar      pause/resume
  123.  
  124.   -  +          volume down/up
  125.   F5  F6        EMU equalizer bass level down/up
  126.   F7  F8        EMU equalizer treble level down/up
  127.   F9  F10       reverb level down/up
  128.   F11 F12       chorus level down/up
  129.   1-9 A-P       channel 1-25 on/off  (no more free letters)
  130.   R  S          all channels off/on
  131.  
  132.  
  133.  
  134. REQUIREMENTS
  135.  
  136.  - at least PC 286  (but not tested on 286)
  137.  - EGA/VGA
  138.  - Sound Blaster AWE32 or a compatible sound card with EMU8000
  139.     (at least 2 MB of on-board sample RAM is strongly recommended)
  140.  - no AWE32 drivers are needed 
  141.  - 68..220 KB of free DOS conventional memory (no EMS/XMS required)
  142.  
  143.  
  144.  
  145. UNSUPPORTED EFFECTS
  146.  
  147.  - set filter             (unsupported by ST3/FT2, Amiga HW specific one)
  148.  - old ST stereo control  (unsupported by ST3, anybody knows the function?)
  149.  - funk repeat            (unsupported by ST3/FT2, never seen it)
  150.  - set fine tune          (unsupported by ST3, never seen it)
  151.  
  152.  
  153.  
  154. FUTURE PLANS
  155.  
  156.  - professional quality downsampling of highest samples to prevent the
  157.    EMU8000 pitch overflows and for you with less sample memory  :-)
  158.    (resampling with the high quality anti-aliasing filter and with
  159.    the original pitch of a short-looped samples precisely preserved)
  160.  
  161.  
  162.  
  163. WHAT YOU CAN'T EXPECT
  164.  
  165.  I'm not planning to implement the DOS shell and file selector...
  166.  Use Windows or OS/2 instead of DOS shell and the association of modules
  167.  with AMP.EXE in your favorite disk/file manager. That's the way I use it. ;-)
  168.  
  169.  
  170.  
  171. FOR CUBIC PLAYER USERS
  172.  
  173.  Cubic Player (versions 1.6 and 1.666) does not initialize the EMU8000 chip
  174.  properly. If used after any program using the ADIP 2.52 style initialization
  175.  (e.g. AMP), some sounds are lost. The same problem persists with AWEMP player
  176.  by B.Boer (up to version 1.45).
  177.  For this reason I created a simple utility called AWERESET to reset the AWE32
  178.  in the style of ADIP 2.0. You'll need it to prepare the AWE32 hardware for
  179.  Cubic Player after AMP was used. Instead of my AWERESET utility you can use
  180.  the 'AWEUTIL /S' command as well (thanx to B.Boer ;-).
  181.  NOTE: There are no init problems when running CP or AWEMP under Windows 95.
  182.  
  183.  
  184.  
  185. SOMETHING ABOUT THE TREBLE SETTING
  186.  
  187.  When playing a module, there are 2 or 3 equalizers in chain:
  188.      1. the digital equalizer in EMU8000
  189.      2. the equalizer in AWE32 mixer (controlled by SB16SET or Windows mixer)
  190.      3. the equalizer in external amplifier
  191.  I think there should be used only last one in chain.  So I decided to set
  192.  the default bass & treble levels of the EMU8000 equalizer to zero.
  193.  But the AWE32 hardware defaults to the treble level approx. +10dB.
  194.  That's why you can hear some loss of high frequencies compared to other AWE32
  195.  players which use the hardware default.
  196.  However, you can use '-Tn' option to change it.
  197.  
  198.  
  199.  
  200. COMMENTS, SUGGESTIONS OR ANYTHING ELSE
  201.  
  202.  My Internet mail address is  kopecky@tsoft.cz
  203.  
  204.  If you use AMP, don't be lazy and send me at least a few words.
  205.  The player is released as freeware and I'd like to know of you :*)
  206.  
  207.  Also the future enhancements depend on feedback I'll get. It's up to you!
  208.