Frostbyte's 1980s DOS Shareware Collection

home *** CD-ROM | disk | FTP | other *** search

/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / KAND / LABELLE3.ZIP / LABELLE.DOC next >

Wrap

Text File | 1989-09-16 | 15.6 KB | 334 lines

LA BELLE LUCIE A Solitaire Game Release 3.00 September 1989 Gellman Software 431 Fifth Street, S.E. Washington, DC 20003 Programming by George Leotti and Robert Gellman. The program and accompanying source codes are in the public domain. La Belle Lucie is a simple but interesting game of solitaire. Although the game appears to be easy to win, it requires considerable thought and planning (and some luck) in order to be successful. The game is much more engaging than the more familiar Klondike solitaire. One reference describes La Belle Lucie as a "fascinating game that pays handsome dividends to intelligent planning." All of the program testers became addicted to the game very quickly. La Belle Lucie is especially well suited for playing on a computer. The game requires repeated shuffling and positioning cards, and the computer handles these mechanical tasks readily. La Belle Lucie is also known as Clover Leaf, Midnight Oil, and Three Shuffles and a Draw. ************************************************************************** * PLAYING THE GAME * ************************************************************************** To start the program, just enter LABELLE at the DOS prompt. If the file is on a floppy disk, enter A:LABELLE if appropriate. After the opening screen, there will be a prompt. Select the H (help) option and read the screen. Play the game for a few minutes, and any uncertainty about the rules will disappear. It will take a little longer to become a good player. The program will run under DOS 2.0 or better. The program requires less than 256K and is compatible with both color and monochrome monitors. A graphics card is not needed. If you have a color monitor, but prefer to play the game in black and white, enter LABELLE/B at the DOS prompt. A reminder of this switch is provided if you play on a color monitor. This new feature with Release 3.0 was added in response to a problem reported by a user. If you want to start playing, go ahead. Nothing in this short DOC file is vital. Read it once, but the documentation is not worth printing. The file was created with margins at 5 and 75. There are form feeds approximately every 60 lines. ************************************************************************** * RULES * ************************************************************************** The layout consists of a tableau and a foundation. When the game begins, all 52 cards are shuffled and dealt into 17 piles of three cards each and one pile with 1 card. This is the tableau. Four foundation piles appear above the tableau as the game progresses. The object of the game is to move all the cards from the tableau piles to the foundation piles. Only the top, or right-most, card in each tableau pile is available for play. Any available card may be played either to a foundation pile, or moved within the tableau. Foundation piles start with Aces and build in ascending order (two, three, four, etc.), according to suit. Cards moved within the tableau may only be played to the top card of another tableau pile in descending order, according to suit. Thus, the seven of spades goes on the eight of spades, the six on the seven, and so forth. Kings may only be played to their respective foundation piles. Kings cannot be moved among the tableau piles. When no more moves are possible or moves would be fruitless, you may reshuffle the cards in the tableau. You are allowed two re-shuffles. After the second re-shuffle, you are allowed a one-time option. On the first move, you may draw any card from the tableau and move it to any legal space in the foundation or the tableau. This is the only time you can move a card that is not on the top of a pile in the tableau. ************************************************************************** * HOW TO MOVE CARDS * ************************************************************************** The card to be moved is designated by a two character notation. The ace of clubs is AC. The two of spades is 2S. The ten of hearts is TH. The jack of diamonds is JD. The queen of hearts is QH. The king of clubs is KC. You must hit the ENTER key at the end of the input. You may use the backspace key to erase. When you select a card, the computer will first attempt to move it to a foundation. If this is not possible, the computer will then search the tableau for a legal move. If no move is possible, the computer will let you know you have made a mistake. For example, if you enter TC and the ten of clubs is available for play, the computer will first check the clubs pile in the foundation. If the nine of clubs is the top card, the ten will be moved on the nine. If the nine of clubs is not on the foundation pile, the computer will search the top card of the tableau piles. If the jack of clubs is on top of a pile, the ten will be moved there. If a card can be moved to a foundation pile, the computer will scan the tableau looking for the next eligible card in that suit. Thus, if the ten of clubs can be placed on the nine in the foundation, the computer will look for the jack of clubs. If the jack is available (i.e. on the top of a tableau pile), the jack will also be moved to the foundation. The computer will keep searching for and moving cards in sequence until the next card is no longer available. The automatic move feature has been provided because there is no reason to leave a card in the tableau if the card can be moved to the foundation. The automatic move feature saves many keystrokes during the course of play. ************************************************************************** * HOW TO FIND CARDS * ************************************************************************** A new feature has been added with Release 3.0. If you designate a card in the tableau to be moved, and the card cannot be moved anywhere, the card will be highlighted on the screen by a small arrow appearing above the card for a second or so. This feature was included because the game calls for a considerable amount of searching for cards. When there are a lot of cards on the screen, it can be difficult to spot the card you want. The computer will now find the card for you. But you must be careful. If you enter a card that can be moved, the computer will move it. If you are still thinking and haven't made up your strategy yet, this can be a big mistake. Since it is relatively simply to see the cards on the top of a pile, you should scan the piles before using the highlight feature. This will be easier than it sounds once you have played the game a few times. You may, of course, ignore the card finding feature if you find it to be confusing or disruptive. ************************************************************************** * OTHER COMMANDS * ************************************************************************** To shuffle the deck, enter S at the prompt. For help, enter H at the prompt. To quit the game, enter Q. The Q command will bring up another menu that allows you to exit to DOS, start a new hand, or return to the existing game. All entries can be in upper or lower case. Illegal keystrokes are not recognized by the program. If you make an illegal entry, the program will let you know with a light click and an error message. The message disappears on its own after a second and a fraction. ************************************************************************** * STRATEGY * ************************************************************************** Move all available cards to the foundations immediately. When moving a card within the tableau, consider how the move might block other important cards. The basic strategy is to THINK and PLAN AHEAD. Remember that you can't move kings except to a foundation. Thus, a card under a king is generally blocked, at least for a while. Identify blocked cards and learn how to use them to some advantage. The free move after the last re-shuffle must be selected with great care. Any card blocked by a king of the same suit must be moved or the game cannot be won. If two such cards are blocked, then failure is assured. The original documentation suggests that a good player will win about ten percent of the time. I haven't kept track of my results, but you should be able to do that well after you get the hang of the game. The scoring for each hand is totally artificial. The highest score possible is 100. It was added in order to provide an incentive to play after the last shuffle reveals that winning is not possible. Some players report that they like to maintain a particular average score. When you win a game, the computer also offers an audible cheer. If you are able to win without using one or both of the available shuffles, an extra cheer or two is provided. ************************************************************************** * HISTORY OF THE PROGRAM * ************************************************************************** This program started its existence as an interpreted BASIC program. The original author (George Leotti) rewrote the interpreted program using QuickBASIC 4.0. Because of the speed of the compiled version, it no longer needed an assist from machine language to display the cards quickly, (as did the interpreted version). The original compiled version was released in July 1988, along with the source code. I found LABELLE.ARC on a Washington, DC, bulletin board in October, 1988. I liked the game so much that I decided to rewrite it to make it easier to play. I reduced the required keystrokes for input by half, made the program a bit more efficient, rewrote the opening and help screens, and eliminated the need for color graphics. This allows the game to be played on just about any monitor. I also added an audible prompt at the second re-shuffle. This will remind you that a special option is available. There is also a visual prompt, but it is easily overlooked. The audible prompt is more noticeable. In making the revisions, I used the PROBAS library of QuickBASIC programming tools. PROBAS is a product of Hammerly Computer Services in Laurel, Maryland. If you don't have PROBAS, you will not be able to recompile the revised version (LABELLE3.BAS). LABELLE3.BAS was compiled under QuickBASIC 4.5. I am not sure if it can still be compiled under QB 4.0. The original "pure" QuickBASIC source code (LABELLE1.BAS) has been included to allow everyone the same chance I had to rewrite the program to suit his or her own needs. Those who have neither the interest nor capability to write programs in QuickBASIC can discard both source codes and save the disk space. The original author distributed a document file with his program. This file is based in part on his document. I am responsible for any errors or omissions in this document or in the revised program. Gellman Software does not normally release the source code of its programs. But since George apparently released his program into the public domain, I have followed in his footsteps and released my version as well. I want to make it clear that the algorithm is entirely George's. I took his code and played with it. He did all of the creative work. I never heard of La Belle Lucie before I found his program. Both versions follow the same, standard rules for La Belle Lucie. See Moyse, "150 Ways to Play Solitaire" 41-42 (1950) (United States Playing Card Company). I have not changed any of the rules. I just added (and subtracted) a few bells and whistles to George's algorithm. The program has minimal documentation. It took me quite a while to decipher the original algorithm. George's approach to programming the game is compact, obscure, and very clever. ************************************************************************** * OTHER GELLMAN SOFTWARE PROGRAMS * ************************************************************************** As of the date of this file, Gellman Software has released five programs. They are: POKER565 - Head to Head Draw Poker (freeware) 1POKER13 - Poker Solitaire (freeware) CALC12 - Calculation Solitaire (freeware) LABELLE3 - La Belle Lucie Solitaire (public domain, with QB source) SIXLTR30 - Six Letter Word Game (shareware) The last two programs were coauthored by other programmers. These programs are available from the Public (Software) Library, P.O. Box 35705, Houston, TX 77235. The latest versions are normally sent to PSL as soon as they are released. I recommend PSL to anyone interested in shareware or freeware. *************************************************************************** * FEEDBACK * *************************************************************************** If you find any errors in the program or the documentation, please let me know. Please be as specific as possible in describing the problem. I would also appreciate any other comments -- favorable or unfavorable -- from users. All suggestions will be considered. Authors of public domain programs do not ask you to pay for their work. A little feedback would be nice. If you find a bug or make a suggestion that I adopt, I will send you a copy of the new version. ************************************************************************** * LEGAL STUFF * ************************************************************************** This program and accompanying documentation are provided "as is" without warranty of any kind. The entire risk of using the program is assumed by the user. Gellman Software disclaims all warranties, either express or implied. In no event shall Gellman Software be liable for any damages whatsoever arising out of the use of or inability to use this program. The program is placed in the public domain. Therefore, it may be used or modified without any restriction. Please upload the program along with this documentation on computer bulletin boards anywhere. No registration or other fee is owed to the authors. Other Gellman Software products are freeware but are copyrighted. These other programs may be distributed by software clubs, computer bulletin boards, and shareware/freeware libraries at a standard charge for media and distribution. The maximum charge permitted without written permission from Gellman Software is $6.00. This restriction does not apply to La Belle Lucie because it is in the public domain. Gellman Software asks that software distributors comply with the same restrictions regardless.