



























                        D R A W    *   P O K E R
                               Minds Eye
                              Version 1.0
                        For Run On VAX/VMS VT200
                           Copyright (c)1996



                              INTRODUCTION

        "Draw Poker" was written in ADA and was directed twards the VAX/VMS
Operating System and VT200 Terminal Emulation.  Although, other terminal
emulations work quite well with the code (VT100+).  Other operating systems
that have an ADA compiler may be able to compile and run the program with
little or no change since there are no directed statements made just for VMS.
The only barrier should be langauge differences between compilers.

        The "Draw Poker" game comes in two forms.  Compiled executable and
source code.  We will explain how to use whichever version you have
obtained.

                             LICENCE/WARRENTY
        All algorithms used in Draw Poker are copyrights of Minds Eye
as well as the source code.  Feel free to modify the source or to rip
code you like as long as you give credit to Minds Eye.  There is no
warrenty on the program.

                                DISCLAIMER
        "Run At Your Own Risk."  If this program causes damage to computer
equipment, erases data, or anything that causes a problem to you or your
system, Minds Eye is NOT held responsible.  The code is Suppiled "AS IS" and
without Warrenty.  If you need to get in contact with us, email
secret@pgh.nauticom.net.
                         

                             
                               INSTRUCTIONS
        There is a demo of Draw Poker at "duncan.cup.edu".  Telnet there with
VT100+ terminal emulation set or login from a lab at California University.
When you reach the login prompt:

        USERNAME: SE_POKER
        Password: HOYLESS

        Yes, that's HOYLESS with TWO S's!  That is not a typo.  Once you are
 in, at the duncan$ prompt:

        duncan$ SET DEFAULT [.POKER]
        
        To enter the POKER directory.  The Executable and Source Code should
 be in that directory.  If the Executable (POKER.EXE) is not there, please
 referr to APPENDIX A "COMPILE SOURCE".  The directory contents should be:

       .ADALIB   - This may or may not be there.  It is not required to
                   run, but it is required to compile.  This is the
                   directory the ADA compiler uses to store it's libraries.

       POKER.EXE - This is the executable poker file.

       POKER.ADA - Main module of source code.

       MENU_PKG.PKG - Contains main menu for Draw Poker.

       TERMINAL_PKG.PKG - Contains Terminal Emulation functions for use
                          with other program functions.

       INIT_PKG.PKG - Contains initialization and uninitialization Functions.
                      Such are allocating and deallocating memory as well as
                      the title screen.

       DATA_PKG.PKG - Contains variable structures of the players and
                      other miscellaneous data.

       GAME_PKG.PKG - This is the game module.  It interacts with the user
                      and controls game play.

       GAME_PK2.PKG - This is the SubGame module.  It interacts with the user
                      and controls game play.  The Orignal GAME_PKG was
                      getting too large.

       POKER.TXT - The Electronic version of this help document.

       ** AMENDMENT **

       CARD_PKG.PKG - Not included in the original specification, this
                      package contains some screen updates and card hand
                      determination functions.

        RAN_PKG.PKG - Not included in the original specificaiton, this
                      package contains random number functions.
        
        Running Poker is simple. To Run, (Make Sure that POKER.EXE is in your
directory, else make sure that all the source code is in the directory and
referr to APENDIX A "COMPILE SOURCE") at the duncan$ prompt:

        duncan$ RUN POKER



                          INTERACTION

        Interaction with Draw Poker should be fairly simple and self
explainatory. The Draw Poker game directs you through the game with ease
of understandability.  At title screen, press enter.  At the Main Menu,
type 'P' to play, 'H' for help, or 'Q' to quit.  In help, just hit enter
after reading each help page.
      
        In Game play, you will be instructed what to type.  Drawing: Enter
a Number from 1-5 to toggle discard and not discard of your cards and 'P'
to Proceed.  During Betting: If no bets placed, hit 0-9, 0 means pass and
1-9 is the credit amount to bet.  If bet has already taken place, you may
hit C to call or R to raise.  If you call, you are auto bet the amount. If
you hit raise, you auto bet the amount, plus you get to add more to the bet.
Again, this is a number from 0-9.  If you hit 0 (You changed your mind).

        One final note about Draw Poker is, from ANY prompt in Draw Poker
(execpt the Title screen which recognizes no keystrokes) you may hit
H for Help or Q for Quit.  At any time during gameplay or from main menu.



                                  POKER
                       "A Quick HOW TO PLAY Reference"

        For those of you that don't know the first thing about poker,
this is a quick reference guide to get you started.  First, everyone
antes in to give the pot some money.  Usually this is only 1 credit,
chip, dollar or what ever you are playing with. Then everyone is dealt
5 cards.  You go around the table and place bets.  Once someone has placed
a bet, the other players have the option to raise.  If no one rasies, you go
to draw cards. If someone raises, it goes around once more the same deal.
Everyone must call, fold or raise again.  Fold means that you quit this
round. You may draw one.  You may draw none.  You may draw all Five!  After
drawing, you bet again.  Same as above.  When done with that betting round,
everyone shows cards and the winner is determined.  If more than one winner
the pot is split. (For Winning Hands, Please Referr to APENDIX B "WINNING
HANDS")



APENDIX A "COMPILE SOURCE"

NOTE:
    Here we give the instructions to compile the source on the VAX/VMS OS.
The instructions may and more than likely will differ if compiling on
another OS or Machine.  Please obtain a reference guide to your specific
OS and Compiler for more details on compiling the source.

        If you've obtained the source code for Draw Poker, here are a few
helpful instructions on how to go about compiling.  You need know nothing
about ada or the VAX/VMS to do this.  All that is required is:

    *    ADA Compiler for VAX/VMS

    *    VAX/VMS (You must have an account and
                  know how to log into it!)

    *    Enough Server Space for the Source, The Executable and
         the Ada Libraries.

    *    Draw Poker Source Code From MINDS EYE

       For start, you will have to extract the ADA Libraries (If
you have not done so already).  This is a simple command.  At the
"$" prompt type:

       host $ ACS /EXTRACT LIBRARY [.ADALIB]

        The "host" part means the name given to the Vax you are
logged onto.  This will extract the ADA libraries for use.  The next
step is to set the library directory on the ACS linker.   This is so
the Linker knows where to look for the Libraries when compiling.

       host $ ACS SET LIBRARY [.ADALIB]

       That will tell the ACS ADA linker where you have decided to put
your ada libraries.  Next Step, compile source code.   This is critical
that you compile in order.  If you fail to compile these files in order,
you will be noticed with errors from the ADA compiler.  Some of these
modules depend on the smaller functions and data types defined in other
modules to run.  And thus it is best to compile them first.

Here is a good compiling order:

 host $ ADA DATA_PKG.PKG
 host $ ADA TERMINAL_PKG.PKG
 host $ ADA RAN_PKG.PKG
 host $ ADA INIT_PKG.PKG
 host $ ADA CARD_PKG.PKG
 host $ ADA GAM2_PKG.PKG
 host $ ADA GAME_PKG.PKG
 host $ ADA MENU_PKG.PKG
 host $ ADA POKER.ADA

After you compile the source code, you will have to link the main module
to the packages.  This is done by:

 host $ ACS LINK POKER

And that is all!  Now, you may run and enjoy "Draw Poker" By Minds Eye.

 host $ RUN POKER

That will execute the game and off you go!




APENDIX B "WINNING HANDS"

   Here are what card hands win a Poker Game(From Highest To Lowest)

  
  Straight Flush - Five cards of the same suit in sequential
                   Order.
  Four Of A Kind - Four cards of same value.
  Full House - Three of one kind and a pair of
                    another.
  Flush - All cards same suit.
  Straight - Five cards in sequential order.
  Three Of A Kind - Three cards of same value.
  Two Pair - Two sets of cards with same value.
  Pair - Two cards of same value.
  High Card - Card with highest value.




APENDIX C "DRAW POKER BOARD"

        Here is a quick reference guide to the Draw Poker
game board. The <>'s Label what will be placed in those colomns.

 
  D R A W   P O K E R v1.0 (C)1996 Mind's Eye (VAX/VMS VT200+)
    PLAYER   DISCARD     FOLD              BALANCE
     YOU      <#>    <X or Nothing>   <Player Credits>
     COMP1    <#>    <X or Nothing>   <Player Credits>
     COMP2    <#>    <X or Nothing>   <Player Credits>
     COMP3    <#>    <X or Nothing>   <Player Credits>

                         JackPot: <Credits In JackPot>
                < User Messages Appear Here>
     CARD1       CARD2        CARD3       CARD4       CARD5

  <Graphic      <Graphic      <Graphic   <Graphic    <Graphic
    Card>         Card>         Card>      Card>       Card>




    <User Inputs Always Here>




APENDIX D "Software Developer"

 CREDITS
 -------
 * Toby Opferman



