!*************************** AMUS Program Label ******************************
! Filename: VANNA.RUN                                       Date: 03/28/89   !
! Category: GAME         Hash Code: 057-436-052-342      Version: 1.3        !
! Initials: KON/AM       Name: MARC SHEPPARD                                 !
! Company: DIGITAL INNOVATIONS, INC.               Telephone #: 5167374468   !
! Related Files: VANNA.DAT, VANNA.HLP, VANNA.INI                             !
! Min. Op. Sys.: 1.0                           Expertise Level: BEG          !
! Special: Requires no externs, however may use INFLD.SBR (See Vanna.Hlp)    !
! Description: Box of Fortune.  Version 1.3 allows user selection of Old     !
!              or New Bonus Round Rules.                                     !
! Note: Will NOT run Op Sys 2.0 or greater !!!!  VANNA 2.0 Coming Soon !!!   !
!*****************************************************************************
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!                                                                        !!!
!!!                     VANNA...aka BOX OF FORTUNE                         !!!
!!!             Written By M. Sheppard (KON/AM) on 05-Mar-88               !!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!                                                                        !!!
!!!              Program Version 1.3 released on 28-Mar-89                 !!!
!!!                [*] = New or Modified for Version 1.3                   !!!
!!!                                                                        !!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


This program requires no external sub-routines and is therefore compatible
with any Alpha-Micro Computer.  HOWEVER, Extensive Line Drawing Graphics
are REQUIRED for the program to run properly, so not ALL CRT/TDV combinations
will produce the desired results!  However, any terminal supporting the more
commonly used TCRT calls (Line Drawing, Solid Block, Cross-Hatch Block, Blink,
Reverse, and Reverse Blink) should do very nicely.



                                  =========
                                  VANNA.DAT
                                  =========

The input file, "VANNA.DAT", is formatted sequentially for easy update and
Modem Transfer.  Record Format is Simple: PUZZLE,CATEGORY<CR/LF>
When adding puzzles, be certain to follow this format EXACTLY.  Commas
may ONLY BE USED to separate PUZZLES from CATEGORIES! Try to avoid erroneous
TABS and SPACES after each CATEGORY, as well as any BLANK LINES between
PUZZLES and at end of file !

You have the option of maintaining the file WITH or WITHOUT a header record.
The header record, if utilized, is the first record in the file and contains
the active puzzle count.  The advantage of using a header record is in the
fact that the program need not calculate the # of puzzles prior to starting
the game.  If you do not plan on adding multitudes of puzzles at a time, you
are best served maintaining a header record.  A facility is available to you
for verifying the accuracy of the header puzzle count (see VERIFY under the
VANNA.INI section).

Only Letters (A-Z), Hyphens (-), Apostrophes (') and Spaces are supported !
The only other restriction is that the PUZZLE ITSELF May Not Exceed 48 Chrs,
(Puzzle length MAY be 49 IF AND ONLY IF character in position 25 is a space)
and that no one line (maximum 2) may exceed 24 characters.  You MAY Find that
certain <=48 character combinations DO NOT work properly, as a line break is
calculated <24 characters and the remaining puzzle length exceeds 24.
Such Puzzles will be reported to you at run-time and subsequently bypassed.
Again, when Adding New Puzzles, BE SURE to UPDATE PUZZLE COUNTER on LINE 1
if you are using a header record ! Maximum # of puzzles in any file is 4096 !

                                  =========
                                  VANNA.INI
                                  =========

You may use a file named "VANNA.INI" to modify a few Parameters.  

The file may exist either LOCALLY (in each account where VANNA is 
being played) or GLOBALLY (in the system library account-DSK0:[7,0]).
If a GLOBAL file is found, then any game invoked in an account which 
does not contain an INI file will adhere to the parameters specified 
in the GLOBAL file.

The current modifiable parameters are:

BANKRUPT        Defines the # of BANKRUPTS on wheel in rounds 4 and 5.
                (Must be set to either 1 or 2 !!!)
                Note: Don't expect too many high scores when set to 2 !
                Default Value: 1

ODDS            Defines the odds (1:N) of WANNA missing a letter when she
                turns the puzzle over after it is solved.  ODDS must be
                expressed as POSITIVE INTEGERS ONLY!  Expect some surprises if
                she botches more than twice !!! (a 2 or 3 in this spot will
                produce amusing results)
                Default Value: 3

BONUS           Defines "BOTCH BONUS" ON or OFF.  Adds a bit more jazz to
                the game.  Base Jackpot for Bonus Round is $25,000. If ODDS
                set >1 and WANNA Botches Puzzle then the BONUS amount for
                that round is added to the Jackpot.  In Addition, if She
                botches more than once, each subsequent botch will add the
                BONUS for that round to the round winner's total dollars.
                Default Value: TRUE

BEEP            Defines Terminal Beep ON or OFF.  For best results, leave ON.
                Default Value: TRUE		

LOGIC           Defines Puzzle size logic ON or OFF.
                When enabled, this will force selection of larger Puzzles
                in rounds 4 and 5 and smaller Puzzles in Bonus Round, as
                defined by LOGMIN and LOGMAX.
                Default Value: TRUE

LOGMIN          Defines the minimum size of a puzzle for Rounds 4 and 5
                when LOGIC is TRUE. (Should Not exceed 44 and best results
                will be realized if between 30 and 40)
                Default Value: 25

LOGMAX          Defines the maximum size of puzzle for Bonus Round when
                LOGIC is TRUE. (Must me at least 12 and best results will
                be realized if at least 20)
                Default Value: 24

PASSES          Defines # of Attempts per puzzle to adhere to LOGIC
                parameters prior to a sequential search of the entire File.

                Puzzles are selected randomly, and duplicates are avoided 
                utilizing a file named "VANNA.BMP".  When a random selection
                points to a used puzzle another random selection is made.
                When a selected puzzle DOES NOT meet size requirements, all
                Puzzles from that point in the file to the lowest point 
                searched sequentially thus far are checked.  The NEXT puzzle 
                found which meets size requirements is then selected.  If None 
                are found, the random process begins again with another PASS.  
                Once the number of PASSES has been reached, a sequential 
                search of the entire file is Begun.  If no matching Puzzles 
                are found at this point, the user will be notified and LOGIC
                for the reaminder of the game will be nullified.

                The More PASSES allowed the more RANDOM the puzzle selection
                will be when using LOGIC.  However, increased PASSES may
                also mean increased Wait Time, especially as the number of
                puzzles-used approaches the number of puzzles-on-file.

                Note:  You may reset the used puzzle BITMAP by erasing the
                BITMAP file - "VANNA.BMP".  Be very careful to erase ONLY
                this file !

                Default Value: 7

DISPLAY         if LOGIC is TRUE you may set this parameter to TRUE to
                DISPLAY # of PASSES expired in finding logical Puzzle.
                You may wish to set this to TRUE temporarily when changing
                other LOGIC parameters.
                Default Value: FALSE

ATTEMPTS        Defines the # of Attempts allowed by the Winner to solve the 
                Bonus Round Puzzle.
                Default Value: 3		

SPEED           Defines the Wait Coefficient of the various Screen Output
                Routines.  The Higher the number, the shorter the wait,
                the faster the screen output.  Standard speed is 1.00.
                If your system is heavily loaded, you may find it desirable
                to increase this number !  If, on the other hand, you wish
                to slow it down you may set it <1 (eg. .5 will cut speed in
                half, 2 will double speed).
                Default Value: 1.00

ROTATE          Defines whether or not to rotate dollar positions on wheel
                after each round.
                Default Value: TRUE

CHAIN           Allows you to define a program or command file name to chain
                to upon exit of game.
                Default Value: None

VERIFY          if Header Record is used, you may set VERIFY to TRUE to verify
                the puzzle count prior to 1st Puzzle.  If puzzle count does
                not match the number of puzzles, the discrepency will be
                reported to you.  This parameter is ignored if no header 
                record is found.
                Default Value: FALSE

DATA            Defines the Name and, optionally, the location of the 
                Puzzle File.

                If you wish to maintain multiple data files you may use this
                parameter to avoid the confusion of constant file renaming.
                This is especially helpful should you decide to create special
                categorized files (eg you may wish to create 1 file containing
                MOVIE puzzles, another containing SCIENCE puzzles, etc).
                Note: This parameter defines the ROOT FILE NAME ONLY. Do not
                attempt to define a File Extension, as the puzzle file 
                extension will ALWAYS be ".DAT" and the corresponding bitmap 
                file extension will ALWAYS be ".BMP".  When renaming PUZZLE 
                FILES (".DAT") , be sure to rename the corresponding BITMAP
                FILES (".BMP")


                DATA may also be used to place your puzzle file in any 
                account on the system and have all games played from any 
                account access the global puzzle file (eg DSK0:VANNA[7,6]). 
                (See GLOBAL).

                Default Value: VANNA


        GLOBAL  If you have chosen to place your puzzle file in a global
                account you now have the option of maintaining HIGH SCORE and
                BITMAP Files either locally or globally.  By setting GLOBAL
                to TRUE, the BITMAP and HIGH SCORE files will be maintained
                in the same account as the puzzle file.  If GLOBAL is FALSE
                then all games will access the global puzzle file, however
                a separate BITMAP and HIGH SCORE file will be maintained in
                each Account in which the game is played.
   
                NOTE:   If GLOBAL is set to TRUE, you MUST have PRIV.SBR
                        on the system in DSK0:[7,6] and to assure file
                        integrity you MUST define a file locking mechanism
                        (See LOCK) !!!!!!!  FULL FILE SPECS ONLY (No Erz).
   
                Default Value: FALSE

        LOCK    If more than one user is allowed to access the BITMAP and
                HIGH SCORE files simultaneously (Either GLOBALLY or LOCALLY
                in the same account) it is HIGHLY RECOMMENDED that you define
                a file locking mechanism.  If LOKSER is currently installed
                on your system then LOCK=LOKSER will be your best bet.  If
                you are running without LOKSER then you may use LOCK=XLOCK 
                (be sure DSK0:XLOCK.SBR[7,6] is loaded into System Memory).
                Default Value: LOKSER

        INPUT   Although the Program requires no external subroutines, a 
                facility exists for defining an external input routine of your 
                choice.  If you have any such routines on your system, contact 
                me for further information. As of Version 1.2A INFLD has been
                added. 
                Default Value: BASIC

        STROBE  If you have defined an input routine which supports left and
                right arrows, STROBE=TRUE will enable a strobe oriented option
                list when choosing next move.
                Default Value: TRUE

[*]   NEWRULES  Under the new rules played in that other game (You know the
                one I mean, the one on the Tee-Wee), the letters N,T,S,R,L
                and E are given in the Bonus Round and then the player
                selects 3 more consonants and 1 more vowel.  If you wish
                to play under the OLD RULES, set NEWRULES to FALSE.
                Note:  Under the new rules, the player should be allocated
                fewer chances and/or less time to solve the Bonus Puzzle.
                Default Value: TRUE


  The following enhancement was suggested by Doug Vegge. These Parameters 
  will ONLY work if INPUT=INFLD and are otherwise ignored.


     TIMEOUT Enables or Disables the Timeout feature of INFLD
             Default Value: FALSE

  The following Time parameters may be set to 0 if you do not wish timeout 
  to be enabled for that phase of the game.


     BONTIM  Defines the number of seconds for each attempt at the bonus
             puzzle.  If you prefer to restrict time only, set ATTEMPTS
             to 1.  

     SLVTIM  Defines the number of seconds for each attempt at solving
             the various "round" puzzles. 

     PLYTIM  Defines the number of seconds for timeout in all other
             phases of the game.



BOOLEAN values may be expressed as ("TRUE" or "ON") or ("FALSE" or "OFF").
If no INI file is found, the default parameters will be used !

An example of an acceptable INI file:

LOGIC=TRUE                      ;(Set Puzzle-size Logic On)
LOGMIN=30                       ;(Set Min Puzzle-size rounds 4-5 to 30)
LOGMAX=24                       ;(Set Max Puzzle-size in Bonus Round to 24)
PASSES=10                       ;(Allow 10 Passes for Puzzle selection)
DISPLAY=FALSE                   ;(Don't Display # of Passes thus far)
BEEP=TRUE                       ;(Enable Terminal Beep)
BANKRUPT=1                      ;(1 bankrupt in rounds 4 and 5)
ODDS=2                          ;(Odds are 1:2 that wanna will botch puzzle)
BONUS=TRUE                      ;(Enable Botch Bonus)
ATTEMPTS=4                      ;(Allow 4 attempts at Bonus Puzzle)
SPEED=1	                        ;(Set Normal Screen Output Speed)
CHAIN=GAMMNU                    ;(chain to "GAMMNU.RUN" upon exit)
ROTATE=TRUE                     ;(Rotate $ Positions each round)
VERIFY=TRUE                     ;(Verify header record puzzle count)
DATA=DSK0:VANNA[7,6]            ;(Puzzle file: DSK0:VANNA.DAT[7,6])
GLOBAL=TRUE                     ;(Bitmap and High Score files in DSK0:[7,6])
LOCK=LOKSER                     ;(LOKSER enabled)
[*] NEWRULES=TRUE               ;enable new bonus round rules



Optional Additions to INI file w/INFLD:

INPUT=INFLD                ;(Enable INFLD as input routine)
TIMEOUT=TRUE               ;(Enable INFLD Timeout Feature)
BONTIM=45                  ;(Timeout in seconds for Bonus Round)
SLVTIM=30                  ;(Timeout in seconds for Puzzle Solution)
PLYTIM=00                  ;(Timeout in seconds for Other Play)
STROBE=ON                  ;(Inp Rtn Option Strobe ON)


We play 5 Rounds, and the winner goes on to the Bonus Round to attempt to add 
$25,000 (or More) to his/her score.  In the event of a tie, the players 
involved will play tie-breaker rounds until the tie is broken.

By the way, If you page through the sequential file and memorize the puzzles
you'll spoil all the Fun, so FIGHT THAT TEMPTATION!!


Well, that's about it.  The rest you probably already Know.  Have Fun !!!!!