home *** CD-ROM | disk | FTP | other *** search
/ Die Multimedia Power-CD / MULTIMEDIA.bin / modplay / vm2 / vm2.doc < prev    next >
Text File  |  1993-04-22  |  8KB  |  212 lines
  1.    Vectorballs Mod Player, v2.2, 04.93
  2.  
  3.    Written by Rhys of The Elven Nation.
  4.    Thanks to Codeblasters for Goldplay.
  5.  
  6. -----------------------------------------------------------------------------
  7.  
  8.    This program is postware...Send me a postcard from whereever you are
  9.    from and include your system specs.  (eg. 386/40, 5RAM-120HD,
  10.    SB-Pro (DMA:1, IRQ:7, PORT:$220), Tseng ET4K SVGA, DOS 5.0)
  11.  
  12.    See the end of this document for contact information.
  13.  
  14. -----------------------------------------------------------------------------
  15.    What it is...
  16. -----------------------------------------------------------------------------
  17.  
  18.    VM2 is Mod player for the PC... (Yes, another one :).  What sets this
  19.    player apart from the others is that it provides an inter-active
  20.    vectorball type of 3D environment with which to play during the music.
  21.  
  22.    Vectorballs are basically large 3D dots that compose a 3D object.  A Mod
  23.    is a convenient digital music format which originated on the Amiga.  It
  24.    has since migrated to various platforms, (thus the convience), and has
  25.    become widespread.
  26.  
  27.    The latest Mods can be found on internet at wuarchive.wustl.edu in the
  28.    /systems/amiga/incoming/mods directory.  A decent source for dated Mods
  29.    is snake.mcs.kent.edu in the /pub/SB-Adlib/ntmods directory.  Or, for
  30.    those without internet access...call the Sound Barrier BBS at
  31.    1-718-979-6629.
  32.  
  33. -----------------------------------------------------------------------------
  34.    How to start it...
  35. -----------------------------------------------------------------------------
  36.  
  37.    VM2 requires the file VM2.DAT.  It must be in a directory in your path 
  38.    and must have that exact name: VM2.DAT.
  39.  
  40.    VM2 also requires a configuration file.  Run VM2-CFG.EXE to create the
  41.    file.  Just answer the questions about your system's setup and VM2.CFG
  42.    will be saved.  VM2.CFG *must* reside in your path (sorry).
  43.  
  44.    To play a Mod, just use:
  45.      VM2 <Modname>
  46.    The .MOD extension is optional.
  47.    You will be prompted for your soundcard configuration:
  48.  
  49.    >Do you have a SoundBlaster Pro (DMA 1, IRQ 7, Port 220h)?
  50.    >Do you have a SoundBlaster (DMA 1, IRQ 7, Port 220h)?
  51.    If not...it will default to a PC Speaker.
  52.  
  53.    If you have a SB-Pro or SB, VM2 will default to 32K playback rate, or
  54.    16K for the PC Speaker.
  55.  
  56.  
  57.    If you do not have one of these standard configuration items, use
  58.      VM2 <Modname> C
  59.    This will take you through the GoldPlay configuration menus.  This is
  60.    tedious, I know; the next version should have a config file so you
  61.    won't need to go through the configuration menu every time.
  62.  
  63. -----------------------------------------------------------------------------
  64.    Keys During Play
  65. -----------------------------------------------------------------------------
  66.    
  67.    All of this information is available on-screen while the music is playing.
  68.    
  69.    S
  70.    This toggles between "scrunched" and "normal" mirrored balls.  This
  71.    gives more of a water effect (?).  Which setting do you prefer?
  72.    (Default is un-scrunched)
  73.  
  74.    escape
  75.    Quit the program.  (novel idea eh? :)
  76.  
  77.    +
  78.    Speed up the rotation.
  79.  
  80.    -
  81.    Slow down the rotation.
  82.  
  83.    left arrow
  84.    Rotate vectorballs clockwise. (default)
  85.  
  86.    right arrow
  87.    Rotate vectorballs counter-clockwise. 
  88.  
  89.    /
  90.    Display 16 vectorballs with mirror effect. (default)
  91.  
  92.    *
  93.    Display 8 vectorballs with mirror effect. (for slower machines)
  94.  
  95.    [
  96.    Decrease the master volume.  (Min is 0/Mute)
  97.  
  98.    ]
  99.    Increase the master volume.  (Max is 63)
  100.  
  101.    M
  102.    Toggles the sound on or off just like MUTE on your TV.
  103.    
  104.    1-4
  105.    Lock all vectorballs to channel 1-4.
  106.  
  107.    0
  108.    Set vectorballs to all channels. (default)
  109.  
  110.    F1-F7
  111.    Set vectorballs' method or pattern.  Just play with these to understand.
  112.    (F3 is default.)
  113.  
  114.    any other key
  115.    Stop the rotation if it is going--or start the rotation in the
  116.    opposite of its previous direction.
  117.  
  118. -----------------------------------------------------------------------------
  119.    Disclaimer
  120. -----------------------------------------------------------------------------
  121.  
  122.    Use this program at your own risk...I won't be responsible for anything.
  123.  
  124.    I have tested this program under Windows 3.1 (Windoze...) and it crashes.
  125.    Run it under DOS.  Or, could someone test it for me under OS/2 and let
  126.    me know the results?  Thanks.
  127.  
  128. -----------------------------------------------------------------------------
  129.    Revision History:
  130. -----------------------------------------------------------------------------
  131.  
  132.    Legend:
  133.        + added
  134.        - removed
  135.        = changed
  136.  
  137.    2.2 : 04.22.93
  138.        + Three more vectorball patterns/methods
  139.        + Configuration program/file (it took 3 days and a four-hour
  140.          optical physics exam to figure out how to stop crashing after
  141.          reading the config file - naturally it was a couple of
  142.          really stupid mistakes :)
  143.        + Future plans section in the doc file (see below)
  144.    
  145.    2.1 : 04.19.93 (not released)
  146.        + Changeable master volume (with display)
  147.        + Mute function
  148.        = Now displays what channel the vectorballs are locked to
  149.        = Quick configuration for PC Speaker said 16K but actually used 20K
  150.        = Checks if mod file exists *before* getting configuration
  151.        = Default vector method to F3.  (Merely my personal preference.)
  152.        = Default direction to clockwise.  (Personal preference again...)
  153.    
  154.    2.0 : 04.18.93 (First public release)
  155.        + Quick config for standard configurations
  156.        + [C] command-line option for non-standard configurations
  157.        + Speed up/slow down
  158.        + 8/16 vectorballs option
  159.        + Various vectorballs patterns/methods
  160.        + Locking vectorballs to different channels
  161.  
  162.    1.0 : 04.16.93 (Intial Version)
  163.  
  164. ---------------------------------------------------------------------------
  165.    Future Plans
  166. ---------------------------------------------------------------------------
  167.  
  168.    Thanks to those of you (few) people who gave me suggestions on how
  169.    to improve VM2...You know who you are.  Priorities are in parentesis
  170.    with '1' being first priority and '+', well you know...when I get
  171.    around to it. ;)
  172.  
  173.    (1) Show some information about the Mod.
  174.    (1) Add a help screen so the background is not so ugly.
  175.    (1) Better support for finding VM2.CFG and VM2.DAT, so they
  176.        don't have to reside in your path.
  177.    (2) Add additional vectorball methods...[This one is not so easy.]
  178.    (3) Use different (better) sound routines [maybe DSMI? & GUSMOD?]
  179.    (+) Additional card support. [like GUS, and PAS (directly)]
  180.    (+) Faster/smoother routines. [like rewriting this in assembler--
  181.        some year]
  182.  
  183.    Plus, whatever else I forgot to mention...Send ideas!
  184.  
  185. ---------------------------------------------------------------------------
  186.    Contact Info
  187. ---------------------------------------------------------------------------
  188.  
  189.    Send bug reports, suggestions, ideas, comments, gripes, etc. to:
  190.  
  191.    E-mail: (guaranteed valid until 12/93)
  192.       swalker@uhunix.uhcc.hawaii.edu
  193.       SWALKER@UHUNIX.BITNET
  194.  
  195.    Snail-Mail:
  196.       Mr. Sunny Walker
  197.       aka Rhys of The Elven Nation
  198.       PO Box 1424
  199.       Kamuela, HI  96743  USA
  200.       RE: VM2
  201.  
  202.  
  203.    Remember, please send the postcard with your system configuration.
  204.  
  205.    Don't hesitate to send better/faster/optimized code for MOD playing,
  206.    vectorball/solid-vector graphics or direct VGA programming. ;)
  207.    I know this program could be made a lot better if I knew how, so tell
  208.    me how I can do it.
  209.  
  210.  
  211. Hope you enjoy it.
  212.