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