home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / GAMES / HR / HOMERUN.TXT < prev    next >
Encoding:
Text File  |  1993-12-19  |  14.4 KB  |  345 lines
  1.                 HomeRun Version 1.00 18th December, 1993
  2.               - A Card Solitaire for the Psion Series 3a -
  3.  
  4.                 Copyright 1993 Right Hand Software Ltd.
  5.  
  6.               45, Kenilworth Gardens, London SE18 3JB, UK
  7.                         Phone/Fax : 081-319-8576
  8.  
  9.                                - Email -
  10.                      righthand@cix.compulink.co.uk
  11.                      chennings@cix.compulink.co.uk
  12.                        100010,511@compuserve.com
  13.  
  14.  
  15. 1)  Introduction
  16.  
  17.     HomeRun is a traditional card solitaire for the Psion Series 3a. The
  18.     game can also be played in by 2 players in competition mode. Game
  19.     play, rules and scoring are described below.  HomeRun offers a full
  20.     graphical display of the pack of cards, animation, digital sounds,
  21.     highscore tables and player statistics.  Have Fun!
  22.  
  23. 2)  Shareware
  24.  
  25.     HomeRun is shareware which means you are granted a limited license
  26.     to evaluate the program.  If after a fair and reasonable period of
  27.     evaluation (no more than 14 days should be considered reasonable),
  28.     you wish to continue to use the program you must register it.
  29.  
  30.     Registration is important.  It means that you are actively
  31.     supporting the development of low cost, high quality software for
  32.     the Psion range of computers.
  33.  
  34.     In recognition of this, registered users receive an access code
  35.     which will :
  36.  
  37.     a) Enable the facilities for saving game setup and options,
  38.        highscores and player statistics to disk.
  39.  
  40.     b) Enable the "Undo Last Move" function.
  41.  
  42.     c) Remove the "reminder" dialogs.
  43.  
  44.     You can register your copy of HomeRun with a payment of a minimum of
  45.     10.00 ukp or $15.00 (US) or local equivalent.  Payment should be by
  46.     cheques drawn on UK Banks or Building Societies made payable to
  47.     Right Hand Software Ltd, in cash or via the Compuserve shareware
  48.     registration service (Go SWREG). Please contact us if you wish to
  49.     discuss other forms of payment.
  50.  
  51.     Please read the full Terms & Conditions of use that are set out in
  52.     the following section.
  53.  
  54. 3)  Terms & Conditions
  55.  
  56.     a) HomeRun comprises the files HOMERUN.APP, HR1.WVE, HR2.WVE,
  57.        HR3.WVE, HR4.WVE, HR5.WVE, HR6.WVE, RHS.WVE and this file
  58.        HOMERUN.TXT. HomeRun is copyright material of Right Hand Software
  59.        Ltd. and all ownership rights are retained.
  60.  
  61.     b) You may use and distribute HomeRun only in accordance with the
  62.        terms and conditions stated here.
  63.  
  64.     c) You may NOT modify HomeRun in any way.
  65.  
  66.     d) You may use HomeRun free of charge ONLY for a fair and reasonable
  67.        period of time (14 days) in order to evaluate the program. For
  68.        all and any subsequent use of the program, you must register your
  69.        copy as described in section (2) above.
  70.  
  71.        You may use HomeRun only in a personal and private capacity. Use
  72.        within commercial, corporate or government institutions requires
  73.        a commercial users licence.
  74.  
  75.     e) You may distribute HomeRun only provided that :
  76.  
  77.        i)   All the original files are included (in particular these
  78.             terms and conditions).
  79.  
  80.        ii)  NO charge is made other than to cover the fair and
  81.             reasonable costs of distribution.
  82.  
  83.        Any distribution of HomeRun that renders any form of commercial
  84.        advantage (financial or otherwise) to the distributor, requires a
  85.        commercial distributors license.
  86.  
  87.     f) While appropriate care has been taken in the creation of HomeRun,
  88.        Right Hand Software Ltd. does not warrant that the software is
  89.        error free.  Indeed, Right Hand Software Ltd. disclaims all and
  90.        any warranties relating to the software.
  91.  
  92.     g) Under no circumstances shall Right Hand Software Ltd. be liable
  93.        for consequential, incidental or indirect damages of any kind
  94.        arising from the use of the HomeRun software.
  95.  
  96. 4)  Installation & Logistics
  97.  
  98.     a) Setup
  99.  
  100.        Copy the file HOMERUN.APP to any directory on any drive and use
  101.        PSION-I to install HomeRun to the system screen. Alternatively,
  102.        place HomeRun in an \IMG\ directory so that it can be launched
  103.        from the RUNIMG filelist.
  104.  
  105.        HomeRun is a type 0 application and so has no filelist on the
  106.        system screen.
  107.  
  108.        HomeRun uses various .WVE files to provide digital sound. These
  109.        files should be copied to a \HOMERUN\ directory located below
  110.        where the main .APP resides. Alternatively the .WVE files can be
  111.        copied to a \WVE\ directory on any drive.  If you don't
  112.        want HomeRun use digital sound, simply rename or delete the .WVE
  113.        files.  HomeRun will then use simple tones to provide sound
  114.        effects.  Sound effects can be fully disabled using the Game
  115.        Options dialog.
  116.  
  117.     b) Files
  118.  
  119.        HomeRun uses 2 types of file.  Firstly, HomeRun is resource based
  120.        (English language resources are embedded in the main .app) and
  121.        HomeRun will look for foreign language resource files in a
  122.        \HOMERUN\ (or whatever you rename HOMERUN.APP to) directory that
  123.        must be located under the directory from which the app is
  124.        launched.  No foreign language resource files currently exist but
  125.        if anyone is interested in doing the translation work, we will be
  126.        happy to supply them.
  127.  
  128.        Secondly, for registered users, HomeRun will save various setting
  129.        to the file HOMERUN.INI. If the drive from which HomeRun was
  130.        launched can be written to and is not a FLASH SSD, the .INI file
  131.        will be created in a \HOMERUN\ directory under the directory from
  132.        which the program was launched. Alternatively, the .INI file will
  133.        be created in LOC::M:\RHS\.  
  134.  
  135.     c) General Operation.
  136.  
  137.        To launch HomeRun, make sure that the .APP has been installed as
  138.        described above and that it is showing on the System screen.
  139.        Select HomeRun and press enter.
  140.  
  141.        HomeRun has supports online help.  Press the HELP key for details
  142.        of how to use the various facilities available.
  143.  
  144.        A summary of the active keys is shown below :
  145.  
  146.        Cursors : The Left, Right, Home and End cursor keys are used to
  147.                  select a card to play.
  148.  
  149.        Space   : The Space key plays a card.
  150.  
  151.        Enter   : The Enter key is equivalent to pressing the Home key
  152.                  followed by the Space key and has the effect of playing
  153.                  a new card from the pack.
  154.  
  155.        Menu    : Brings up the menu bar.
  156.  
  157.        Help    : Brings up the help system.
  158.  
  159.        Psion-N : Starts a new game.
  160.  
  161.        Psion-S : This presents a dialog from which you can Setup the
  162.                  type of game to play - the number of players and who
  163.                  they are and for a 2 player game the number of hands
  164.                  over which the competition is to run.
  165.  
  166.        Psion-O : This presents a dialog from which you can control the
  167.                  game Options regarding animation and sound effects.
  168.                  Note: if card animation is turned on, the initial the
  169.                  pack dealing routine will always go at the maximum
  170.                  speed.
  171.  
  172.        Psion-H : Displays the highscore table.
  173.  
  174.        Psion-C : Deletes the current highscore table (to give others
  175.                  less skilled than yourself a chance to get their name
  176.                  in lights).
  177.  
  178.        Psion-P : Displays various statistics relating to the current
  179.                  players.
  180.  
  181.        Psion-R : Use this to register your copy of HomeRun.
  182.  
  183.        Psion-U : For registered users only, this will undo the last move
  184.                  except when that move resulted in an end game.
  185.  
  186.        Psion-A : Displays copyright and program version information.
  187.  
  188.        Psion-X : Exits the program.
  189.  
  190. 5)  HomeRun - The Game
  191.  
  192.     On startup, the program information screen is displayed and once
  193.     cleared, the game begins.
  194.  
  195.     HomeRun is played with a standard pack of 52 playing cards PLUS up
  196.     to 4 Jokers.  At the start of a game you have all 4 Jokers.
  197.  
  198.     The game starts with 35 cards being dealt into 7 ranks of 5 cards. A
  199.     single card is then dealt and placed in the bottom left hand corner.
  200.     The remaining cards are placed face down in the top left hand
  201.     corner.
  202.  
  203.     The basic game play involves taking cards from the front of any of
  204.     the ranks and placing them on the layout card in the bottom left
  205.     hand corner.  However you can only do this if the face value of the
  206.     card is 1 greater than or 1 less than that of the layout card - so
  207.     you are looking to make runs of cards such as 3 4 5 or K Q J 10 or
  208.     even 4 5 4 5 4 5.  Aces are low. Jokers can have any value so any
  209.     card can be placed on them and they can go on any card - so they are
  210.     very useful!
  211.  
  212.     If it is not possible to move any of the cards from the 7 ranks you
  213.     can play a new layout card from the pack in the top left hand
  214.     corner.
  215.  
  216.     The objective of the game is simply to clear all the 35 cards in 7
  217.     ranks while gaining as many points and bonuses as possible.
  218.  
  219.     If you do clear all 35 cards, the pack is redealt and your turn
  220.     continues.  However, 1 Joker is removed, making it harder to clear
  221.     the next set of cards.
  222.  
  223. 6)  Scoring and Bonus Points
  224.  
  225.     For each card you play from the 7 ranks, points are awarded
  226.     according to its face value. The values are :
  227.  
  228.                     King, Ace          = 8 points
  229.                     Queen, Jack, 3, 2  = 6 points
  230.                     10, 9, 5, 4        = 4 points
  231.                     8, 7, 6            = 2 points
  232.                     Joker              = 0 points
  233.  
  234.     Additionally, if you manage to make a pure run of 4 or more cards,
  235.     you get 10 bonus points for each card in the run after the 3rd card.
  236.     A pure run is an ascending or descending "straight" ie 3, 4, 5, 6 or
  237.     Q, J, 10, 9.  Sequences such as 4, 5, 4, 5 are not eligable for
  238.     bonus points but are obviously important for clearing all 35 cards
  239.     and completing the hand.  In some situations you will need to make a
  240.     judgement as to whether to go for bonus points or for a sequence
  241.     that has a better chance of getting to the end of the hand.
  242.  
  243.     If you clear all 35 cards you are awarded various additional
  244.     bonuses.  You get 20 bonus points for completing the hand.  You get
  245.     10 points for each card remaining unused in the pack and you get 50
  246.     points for any unused Jokers.
  247.  
  248.     You now enter the "Bonus Gamble" section.  A single card is dealt
  249.     and you are offer a chance to increase your bonus score by betting
  250.     as to whether the next card is higher or lower.  A dialog shows the
  251.     points on offer and you can choose to collect you current bonus or
  252.     go for the higher value by going high or low.
  253.  
  254.     If you bet and you're right you get the higher bonus and can bet
  255.     again.  If you're wrong that ALL your bonus points are lost.  If the
  256.     next card has the same value as the one showing, you collect your
  257.     current (lower) bonus.
  258.  
  259.     Once you have more than 240 bonus points, winning the gamble gains
  260.     you an extra Joker for the next hand (ie the number of Jokers is
  261.     not reduced) - this is the best way to get really high scores as
  262.     fewer Jokers makes it a lot harder to clear the ranks.
  263.  
  264. 7)  The End Game
  265.  
  266.     If you have cleared all the ranks and the bonus gamble routine has
  267.     completed, your score plus bonuses are added to the players total
  268.     shown in the information window. If the if the score for the game is
  269.     good enough, its position in the highscore table is shown. If the
  270.     score is not a highscore but is still a personal best, the player
  271.     statistics dialog is displayed.  The pack is then redealt and the
  272.     players turn continues.
  273.  
  274.     If you cannot play a card, the game ends and any highscore or
  275.     personal best is notified.  If you are playing a single player game,
  276.     you will now need to do a Psion-N to start a new game.  If you are
  277.     playing a 2 player game, the cards are redealt automatically and
  278.     play passes to the next player.  Once player 2 has completed the
  279.     number of games in the competition (as defined in the Setup New Game
  280.     dialog), the competition is over and you will now need to do a
  281.     Psion-N to start a new competition.
  282.  
  283. 8)  The Information Window
  284.  
  285.     The Information window is located at the bottom of the screen and
  286.     shows then number of unplayed cards in the pack, the number of
  287.     unplayed Jokers, the current hand score and bonus for the current
  288.     player and the running total over several hands in a game and games
  289.     in a competition for the 2 players.  Note the diamond marker
  290.     indicates the current player.
  291.  
  292. 9)  That's all folks ... Have Fun!
  293.  
  294. === End of HomeRun v1.00 Documentation ===================================
  295.  
  296.  
  297.  
  298.  
  299.  
  300. VERSION HISTORY ...
  301.  
  302. === HomeRun v1.00 Changes from v0.92b ====================================
  303.  
  304. *  Added further / finalised sounds.
  305.  
  306. *  .WVE files REALLY correctly handled in a APP\HOMERUN\ directory
  307.  
  308. *  Opted for blank background to cleared ranks
  309.  
  310. *  Game Options settings correctly saved to disk (for reg'd users)
  311.  
  312. *  "Press Esc or Enter" prompt shortened to "Press Enter"
  313.  
  314. === HomeRun v0.92b Changes from v0.91b ===================================
  315.  
  316. *  .SHD file amended to show HomeRun as the app name on the system
  317.    screen rather than "Runner" - the original working title.
  318.  
  319. *  .WVE files correctly handled in a APP\HOMERUN\ directory
  320.  
  321. *  Improved control options for sound/animation fx on dealing
  322.  
  323. *  Increased cursor blink rate for better visibility
  324.  
  325. *  Home/End keys now sensitive to empty ranks
  326.  
  327. *  Build card routine uses G_TRMODE_SET rather than G_TRMODE_REPL to
  328.    stop losing pixels in suit icons through overwriting on cards where
  329.    suit icons are densely packed eg 9s and 10s
  330.  
  331. *  New display for empty ranks instead of simple grey fill
  332.  
  333. *  Enter key is used instead of Shift+Space to play a pack card
  334.  
  335. *  Game now correctly recognises end game situation and does not process
  336.    cursor keys, Space or Enter - these were previously active and would
  337.    panic or muck up subsequent play if pressed once a game completed.
  338.  
  339. *  UNDO last move feature added (only for registered users) - I'm
  340.    actually very pleased with this 'cos I keep doing silly things.
  341.    There's no penalty for using this so I guess it'll be up to you to
  342.    declare it's use when you are boasting about highscores!
  343.  
  344. === End of Version History ==============================================
  345.