home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / SWMP13.ZIP / SWMP.DOC < prev    next >
Encoding:
Text File  |  1995-05-16  |  6.7 KB  |  191 lines
  1.  
  2.  ┌────────────────────────────────────────────────────────────────────────────┐
  3.  │ Module Player V1.3      (c) 1994,1995 by Lord Excess of Sound Wizards Int. │
  4.  └────────────────────────────────────────────────────────────────────────────┘
  5.  
  6.  
  7.         Index for SWMP V1.3
  8.         ───────────────────
  9.  
  10.            I. General
  11.           II. Utilisation
  12.          III. Features
  13.           IV. Support
  14.            V. System Requirements
  15.           VI. Optimisations
  16.          VII. Thanks and Greets
  17.         VIII. Copyrights, Restrictions
  18.           IX. Info Addresses
  19.  
  20.  
  21.  
  22.  
  23.         I. General
  24.         ──────────
  25.  
  26.          Sound Wizards Module Player (SWMP) is on the one hand quite a
  27.         pretty module player with lots of extraordinary capabilities
  28.         and on the other hand a software development kit that gives you
  29.         access to the world of module files. Basically the drivers were
  30.         coded in pure assembler what makes them running very stable and
  31.         provides a maximum of speed.
  32.  
  33.  
  34.  
  35.         II. Utilisation
  36.         ───────────────
  37.  
  38.          If you want to know how to link the drivers into your code,
  39.         take a look at C.DOC, PAS.DOC or ASM.DOC. Here comes the
  40.         description of the demo player.
  41.  
  42.          SWMP.EXE is a command line player, i.e. you have to specify
  43.         modulefiles (sound files with extension .MOD) after you've
  44.         typed in the name of the player, for example:
  45.  
  46.                C:\SOUND>SWMP TECHNOLO.MOD RELAXING.MOD
  47.  
  48.          This will first play Technolo.Mod, which has to be in the
  49.         current directory (or else you have to add a path), and after
  50.         that continue with Relaxing.Mod. If you specify only one file
  51.         on the command line, the player will return to DOS when
  52.         finished playing. If multiple files are selected, SWMP will
  53.         play all files in order and then restart with the first one
  54.         (demo mode).  While playing you can use the following keys:
  55.  
  56.                 ESC:                    Quit player
  57.                 SPACE/RETURN:           Start next song
  58.                 CURSOR UP/DOWN,+,-:     Change volume settings
  59.                 CURSOR LEFT/RIGHT:      Change song position
  60.  
  61.          If the player refuses to play back a sound file, then the file
  62.         specified is either not of MOD-type, there is not enough memory
  63.         available or (in case you own a GUS) the DRAM size is too low.
  64.  
  65.  
  66.          A setup program is available if you start the player without
  67.         command line parameters. In most cases the automatic hardware
  68.         detection should work, but if you encounter any errors try to
  69.         setup the player with the correct configuration.
  70.  
  71.  
  72.  
  73.         III. Features
  74.         ─────────────
  75.  
  76.          - SWMP plays any 4,6 or 8 channel modules, no matter if 15 or
  77.         31 samples. All effects of ProTracker 2.3A/3.01 except of the
  78.         SetFilter- and InvertLoop command are implemented, including
  79.         extended speeds. I'm not going to list all compatible trackers
  80.         and effect commands, because this would take up pages...
  81.  
  82.          - Sample length is no more reduced to 64KB !!
  83.  
  84.          - GUS specials:  - *CORRECT* loops
  85.                           - calculated volume settings
  86.                           - UltraClicks (tm?) removed
  87.  
  88.          - SDKs are available for C, PASCAL & ASSEMBLER.
  89.  
  90.  
  91.  
  92.         IV. Support
  93.         ───────────
  94.  
  95.          Currently the following sound devices are supported:
  96.         
  97.                 - any SoundBlaster compatible card
  98.                 - any SoundBlaster Pro compatible card
  99.                 - Gravis UltraSound
  100.  
  101.          I have made the experience how much easier it is to program
  102.         the GUS and how much better the results in quality are,
  103.         therefore I'm not going to support non-wavetable cards in
  104.         future releases. GUS really sounds best as things are now.
  105.  
  106.  
  107.  
  108.         V. System Requirements
  109.         ──────────────────────
  110.  
  111.          Of course you need at least one of the soundcards listed
  112.         above. The PC-Speaker option is not available. In my opinion no
  113.         sound at all is better than this. Secondly your CPU has to be a
  114.         80286 or above, because I used the 286 instruction set.
  115.  
  116.  
  117.  
  118.         VI. Optimisations (coder's stuff)
  119.         ─────────────────────────────────
  120.  
  121.          Note: This affects only the SoundBlaster drivers.
  122.  
  123.          Primarily I've optimized the drivers for size and sound
  124.         quality. Instead of the ultra high speed block scaling routines
  125.         I 'only' used the normal high speed linear scaling procs. But
  126.         these are such tuned that you only notice a difference on 16MHz
  127.         machines. The result is a much smaller use of memory at
  128.         runtime.
  129.  
  130.  
  131.  
  132.  
  133.         VII. Thanks and Greets
  134.         ──────────────────────
  135.  
  136.          Many thanks to all my encouraged beta testers! First of all I
  137.         have to mention Oliver Eugster, having always time for a little
  138.         test and putting his schoolwork aside. Many thanks also to
  139.         Martin Schärer for reading and correcting the documentation.
  140.  
  141.          Greets go out to the cool guys at GRAVIS (Brad Craig) !
  142.  
  143.          A lot of thanks to all musicians composing these cool mods.
  144.         The two sound files located in the main archive were done by
  145.         Sound Wizards members.
  146.  
  147.  
  148.  
  149.         VIII. Copyrights & Restrictions
  150.         ───────────────────────────────
  151.  
  152.          This software is freeware. It may not be used in a commercial
  153.         way without permission. But you may copy and use it as long as
  154.         you do not modify the contents. In other words: If your sofware
  155.         will be freeware too that's ok. Further I'm not liable for any
  156.         damage this product could cause.
  157.  
  158.          All mentioned Trademarks and Copyrights are registered by
  159.         their respective owners.
  160.  
  161.          If you are using the drivers in your code, a credit would be
  162.         nice.
  163.  
  164.  
  165.  
  166.         IX. Info Addresses
  167.         ──────────────────
  168.  
  169.          In case you have any comments or questions concerning this
  170.         player or SOUND WIZARDS in general, here are our addresses:
  171.  
  172.           LORD EXCESS:                         AXEL:
  173.  
  174.           Beat Rigazzi                         Sound Wizards
  175.           Sandackerweg 3                       Reinacherstrasse 4
  176.           3363 Oberönz                         4147 Aesch
  177.           phone: +41-(0)63-614981              phone: +41-(0)61-7512287
  178.           e-mail: rigazzi@iamexwi.unibe.ch     fax:   +41-(0)61-7512287
  179.  
  180.  
  181.  
  182.  
  183.         last but not least:
  184.  
  185.          This piece of work is dedicated to my girlfriend Daniela, the
  186.         most beautiful girl of the world !!!
  187.  
  188.          
  189.                                                  Lord Excess in May '95
  190.  
  191.