ù+* Zwerg Zwack of Pentagon Art Departement *+ù

                          is proud to present


                            ZZPLAY v1.00
                                ----

                 (a MODplayer for Gravis UltraSound)

                     (C)1993 by Christian Kuendig



First a little disc-lamer:
--------------------------

You are NOT allowed to use this program without the written permission of
the author in any commercial production or whatever. 


What is ZZPlay
--------------

ZZPlay plays standard MOD-files on your Gravis Ultrasound.
ZZPlay processes four, six and eight channel modules.
ZZPlay only works with 386 and higher processors.


How to use ZZPlay
------------------

ZZPlay <filename.ext> [-options]

these are the different options:

        -Pxxx   If you have problems with the autodetect for GUS, use
                this option. For xxx, just enter the base port of your 
                GUS in hex.

        -Vxx    With this option, you can set the playbackvolume.
                For xx enter a decimal value between 0-64.

        -A      If you have any old Amiga-MODs, use this option to play
                them correctly!

        -R      This option will play wildcarded files in random order.

For <filename.ext>, you can enter wildcards. If you enter a file without
extension a .MOD is added. ZZPlay will play all MOD-Files matching the 
wildcard. When a MOD is finished, the next will be loaded and played. 
If you exit to the DOS-Shell, the current MOD will be repeated.

Please report any bugs in ZZPlay ! If you're missing the support of some 
special effects, contact me with a (good) documentation and/or source! 
I need your help, to improve ZZPlay in the future.


Keys in ZZPlay:
---------------

        1-8 .................................... turn channel on/off
        +/- ............................................. volume +/-
        [/] .............................................. speed +/-
        {/} ................................................ BPM +/-
        ,/. ......................................... instrument +/-
        cursor up/down ........................select channel to pan
        cursor lft/rgt ..................... paning selected channel
        shift (right) .............. double playspeed (fast forward)
        D ............................................. shell to DOS
        N ......................................... play next module (*)
        I ................................... instrument info screen
        H .............................................. help screen
        P ..................................... play previous module (*)
        R ............................................ repeat on/off (*)
        ESC ............................................ exit to DOS

        * = only when using wildcards.


Technical reverence
-------------------

The player supports five octaves (0-4)  and all the following effects:

        þ arpeggio
        þ portamento up
        þ portamento down
        þ portamento to note
        þ vibrato
        þ portamento to note with volumeslide
        þ vibrato with volumeslide
        þ tremolo
        þ offset
        þ volumeslide
        þ position jump
        þ set volume
        þ pattern break
        þ fine volumeslide up
        þ fine volumeslide down
        þ set finetune
        þ cut sample
        þ delay sample
        þ delay pattern
        þ set speed
        þ set BPM

        þ set pan position of Channel
          no standard effect ...
          the effect number is 8E.
          0 = full left
          F = full right


To contact me:
--------------

        - write to:         Christian Kuendig
                            Lindenhofrain 12
                            8708 Maennedorf
                            Switzerland

        - or call:          The Lycaeum		
                            +41 (0)41 762 989	

			    and write a message to ZWERG ZWACK

        - or on InterNet:   chicken@ezinfo.vmsmail.ethz.ch
                           (not my account, write my name!)


Special thanks to:
------------------

        Cascada, Renaissance, Advanced Gravis, Chicken
        MahlzahnX, Melnorem, Otto Chrons, Silent Mode, ULi.


The .OBJ
--------

There's an object available, which you can use to include this MODplayer
into your own programs. The routines are 100% coded in assembler.

To get a registered version of this .OBJ, the registration fee is US$ 20 for 
Europe or US$ 25 for the rest of the world. 

(additional contributions are of course always welcome <g>)



        - Best way to pay is a international mandate (just ask at your
	  local post office for more information) or send it with your
	  order (at your own risk).
		   
        - After having recieved your order and the money, I will
          send you a disk with the .OBJ, the dox (on disk), and
          the newest version of ZZPlay.
          PS: there will be some example code on the disk.

          O  /
_ _ _ _ _ _\/_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
           /\
          O  \



   FILL OUT AND SEND TO:   Christian Kuendig
                           Lindenhofrain 12
                           8708 Maennedorf
                           Switzerland

                     OR:   chicken@ezinfo.vmsmail.ethz.ch


   NAME         __________________________________________

   ADDRESS      __________________________________________

                __________________________________________

                __________________________________________

                __________________________________________

   PHONE        __________________________________________

   INTERNET     __________________________________________

   OCCUPATION   __________________________________________

   LANGUAGES    __________________________________________


   IF YOU'RE IN A DEMO-GROUP AND ARE USING THE PLAYER IN YOUR PRODUCTIONS,
   PLEASE FILL OUT THIS FORM:


   ALIAS        __________________________________________

   GROUP        __________________________________________

   COMMENTS     __________________________________________



   IF YOU WANT TO USE THIS PLAYER IN A COMMERCIAL PRODUCTION YOU _HAVE_ TO
   GET IN CONTACT WITH ME (CHRISTIAN KUENDIG), THE AUTHOR OF ZZPLAY.