home *** CD-ROM | disk | FTP | other *** search
/ PC Loisirs 18 / cd.iso / sharewar / swmp14 / swmp.doc < prev    next >
Encoding:
Text File  |  1995-09-18  |  7.3 KB  |  208 lines
  1.  
  2.  ┌────────────────────────────────────────────────────────────────────────────┐
  3.  │ Module Player V1.4      (c) 1994,1995 by Lord Excess of Sound Wizards Int. │
  4.  └────────────────────────────────────────────────────────────────────────────┘
  5.  
  6.  
  7.         Index for SWMP V1.4
  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. Changes from V1.3
  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. Changes from V1.3
  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.  
  163.  
  164.         IX. Copyrights & Restrictions
  165.         ─────────────────────────────
  166.  
  167.          This software is freeware. It may not be used in a commercial
  168.         way without permission. But you may copy and use it as long as
  169.         you do not modify the contents. In other words: If your sofware
  170.         will be freeware too that's ok. Further I'm not liable for any
  171.         damage this product could cause.
  172.  
  173.          All mentioned Trademarks and Copyrights are registered by
  174.         their respective owners.
  175.  
  176.          If you are using the drivers in your code, a credit would be
  177.         nice.
  178.  
  179.  
  180.  
  181.  
  182.         X. Info Addresses
  183.         ─────────────────
  184.  
  185.          In case you have any comments or questions concerning this
  186.         player or SOUND WIZARDS in general, here are our addresses:
  187.  
  188.           LORD EXCESS:                         AXEL:
  189.  
  190.           Beat Rigazzi                         Sound Wizards
  191.           Sandackerweg 3                       Reinacherstrasse 4
  192.           3363 Oberönz                         4147 Aesch
  193.           phone: +41-(0)63-614981              phone: +41-(0)61-7512287
  194.           e-mail: rigazzi@iamexwi.unibe.ch     fax:   +41-(0)61-7512287
  195.  
  196.  
  197.  
  198.  
  199.         last but not least:
  200.  
  201.          This piece of work is dedicated to my girlfriend Daniela, the
  202.         most beautiful girl of the world !!!
  203.  
  204.  
  205.                                                  Lord Excess in June '95
  206.  
  207. 
  208.