Classic Solitaire V1.01 Copyright © 1992, 1993 by Perry Rosenboom Box 333 Wantirna South Victoria, 3152 Australia Documentation Version - August 1993 **************************************************************************** Note: Solitaire, Tut's Tomb, Golf and Aces Up have been completed as of the documentation date. Please do not register for the complete set of games (unless you are prepared to wait for the other games!). Users who register for Solitaire or Tut's Tomb will be able upgrade their registration when other games are available. **************************************************************************** Introduction Welcome to Classic Solitaire, also known in some countries as 'Klondike'. This version came about because I wanted to put some card games together in one package which are of a high quality and presentation, and which are easy to play. I'm confident that I have achieved my goals, and that you will enjoy Classic Solitaire. Classic Solitaire is the first of the six games in this package. Other games include Cruel, Tut's Tomb, Golf, Tri-Peaks and Cleopatra. More games may be added to the package as (or should I say, "if") I get motivated to write new ones. Registered users have special privileges - see the information about Registration near the end of this documentation file. A Note about this documentation This file accompanies both the Shareware version and Registered version of Classic Solitaire. Differences between the two versions will be specified wherever appropriate. This means that I only need to maintain one version of the documentation (mainly because I hate writing documentation). Having only one version of the documentation will also show Shareware Users what you are missing by not registering!!!! Systems Supported This game was developed and compiled using AMOS and AMOS Compiler (Copyright Euorpress) version 1.35, which supports Workbench 1.3, 2, and 3. This means that this game should work on A500, A600, A1200, A2000, A3000 and A4000 machines. I do my best to support machines available at the time of writing the game, however I obviously cannot test every aspect of the game on every machine. If for some reason the game doesn't work, check the 'Troubles?' section below, and send me a polite letter, and I'll see if I can help. Obviously, registered users get priority. Abusive letters (such as one I received from England) will get no response. People who write shareware and public domain software do so because they enjoy it - abuse will only result in LESS software being developed for public release. We can't hope to make our shareware profitable, but we do hope that we are respected for our efforts. End of sermon. Changes from Version 1.00 Version 1.01 is a minor update to version 1.00. Version 1.01 has been compiled with the AMOS V1.35 compiler, which means that it should run on AGA systems without problems. Also included in Version 1.01 is one small bug fix. With Verson 1.00, after "End Game" was selected from the menu, it was still possible to click on a card. This has been fixed. Classic Solitaire Object of the game The object of Classic Solitaire is to move all of the cards from the deck and playing area onto the piles marked "Suits". One pile of cards will be used for each of the four suits. If you manage to form fours piles (one for each suit) consisting of all 52 cards, you have won (which is easier said than done). Rules When the cards are dealt, you will see seven columns of cards, with a different number of cards in each column. Column one has one card, column two has two cards, and so on. The top card in each column is shown face up. You are permitted to move any face up card from one column to another providing that the card you are moving is one less in denomination, and of a different colour to the card you are moving it to. For example, you may move a black nine onto a red ten, or a red Queen onto a black King. Moving a card will move that card, and any other face up cards which are in the same column and below the card you are moving. Only a King (of any colour) may be moved to a column which is empty. Cards may be moved to a suit pile providing that the top card on the suit pile is of the same suit, and one less in denomination than the card you are moving. If the suit pile is empty, only an Ace may be moved there. In other words, you are trying to build four piles of cards, from Ace through to King in each suit. You may only move one card at a time to a suit pile. When the game is dealt, you will see the deck of cards with the top card of the deck shown face up. Cards may be moved from the deck to either the columns or a suit pile, using the same rules as listed above. Clicking on the deck will turn over the next card or third card in the deck, depending on the option selected in the "Settings" screen (Draw one is disabled for the Shareware Version). When you get to the end of the deck, clicking on the space will flip the deck over, and you can go through the deck again. The game is over when all cards have been moved to the suit pile, or there are no more valid moves. How to Play Only mouse clicks are required to play Classic Solitaire. To move a card from one position to another, click on the card that you wish to move, then click on the destination location. If you are moving a card to a suit pile, you can double click on the card you wish to move (when moving an Ace, Classic Solitaire will find the first available suit pile and put the Ace there). To flip over the next available card in the deck, click on the deck. To turn over the deck when the deck is finished, click on the space where the deck was. Menus A number of menu items are available with Classic Solitaire. Clicking on the right mouse button will make the menus appear. The menus have been programmed to appear wherever the mouse pointer is currently located. Available menu items are coloured dark green and will change colour to light green when they are selected. A grey menu item means that the item is not available The available menu Bar looks something like this: ----------------------- | Solitaire | Options | ----------------------- Under the "Solitaire" menu item, there is a submenu wich looks similar to this: -------------- | Solitaire | -------------- | End Game | | New Game | | About | | Credits | | Quit | ----------- End Game Select this to End the current game. New Game Select this menu item to begin a new game (when the previous game has been ended). This menu item is not available when playing a current game. About Displays information about Classic Solitaire Credits My credits screen - I've got people to thank! Quit What can I say? Quit means exit, scram, Outahere, vamoose, goodbye, or "Ausgang" for my German speaking friends. Under the "Options" menu bar item, there is a sub menu which looks similar to this: ------------- | Options | -------------- | Sound | | Settings | ---------- Sound (On, Off) Selecting "Sound" will pop up a sub menu to allow you to turn the sound on or off. The current status is marked by a tick. Settings Use this menu item to change the settings for Classic Solitaire. This menu item is not available until the current game is completed. The Settings Screen Items which can be altered from the settings screen are: Sound Buttons are available to turn the sound on or off (this will alter the sound menu items described above). The pitch of the bell which sounds when a card is selected (Bell 1) and the pitch of the bell which sounds when the card is placed (Bell 2) can be adjusted using slider bars. The volume of the sound can also be adjusted using a slider bar. Draw One or three - determines how many cards are to be flipped when clicking on the deck. If draw three is selected, every third card will be available. If draw one is selected, every card will be displayed as you click on the deck. (Draw one only is available in the Shareware Version). Passes One, Three or Many - controls the number of times that Classic Solitaire will allow you to go through the deck. ("Many" is disabled in the Shareware Version). Pointer None, Outline or Card - this setting determines how the mouse pointer will look after clicking on the first card. The standard mouse pointer is used by itself, or in conjunction with a card outline, or an image of the selected card. Title On or Off - if this option is set "On", the title screen will be shown when starting Classic Solitaire. When set to "Off" the title will be skipped (Disabled in the Shareware Version - I'm going to make you sit through the title unless you register!!). Backs Clicking on the "Backs" button allows you to select which of the 13 card backs you wish to display during your game. Once selected, this back will be used until you "Quit" (in the case where you don't save your settings), or until you select another card back. To select a card back, just click on the back you want. To use random card backs (ie,have Classic Solitaire choose one at random for you) click on the box marked "Random". (The ability to select card backs is disabled in the Shareware Version - the "Random" option applies). Default Clicking on this button resets everything back to the default values. Defaults are: Sound - On Bell1 - 50 Bell2 - 60 Volume - 32 Title - On Draw - One Passes - Many Backs - Random Pointer - Outline (This button is disabled in the Shareware Version). Save This button saves your solitaire settings to disk. They are automatically loaded and used next time. (Disabled in the Shareware Version). Use This button allows you to use your settings, without saving them to disk. They will be lost when you "Quit" from Classic Solitaire. The Shareware version If you have already registered, then ignore this section. The shareware version of Classic Solitaire differs from the Registered Version in a number of ways: 1. Some features have been disabled in the shareware version. Registered users have: - unlimited passes through the deck (the shareware version allows only one or three passes through the deck); - the option to choose the card back which they would like displayed (the shareware version chooses them at random); - the ability to skip the title screen (although it's such a good title screen, I don't know why anyone would want to skip over it...); - the option to draw one or draw three cards from the deck ( the shareware version only allows you to draw three cards) 2. The shareware version has a message which flashes up at random while playing the game, to remind you (just in case you need reminding) that the version of the game you are playing is Shareware. This does not come up on the registered version. 3. Registered versions of Classic Solitaire contain the name of the person who registers in the title screen, and the "About" screen (so everyone who registers has their own personal copy of the game). 4. The Shareware version of Classic Solitaire is not supported. In other words, if there is a problem, I'll fix it in the Registered version, and registered users will receive the fix. 5. The Shareware version of Classic Solitaire is 'crunched' on the disk, to reduce the amount of space required for coverdisks, PD libraries, Bulletin Boards and so on. The process of uncrunching causes the coloured lines on the screen when you start the game. Registered users will receive an 'uncrunched' version of the game. Troubles? Most problems seem to be caused by low memory. If you notice that the screen is not refreshing correctly, or that the menu bar doesn't disappear, you've got memory problems. Most games these days are designed to work in 1Mb minimum, and this game is no different. If you have 1Mb or more and the game is still presenting problems (especially after you have been playing the same game for some time), then the memory may be fragmented. Try closing down some other programs, or closing down the game and restarting it. The other problem which I have heard of can occur on Workbench 2 and Workbench 3 systems. On these systems, it is possble to change the default font to something other than 'Topaz 8'. This game was written using the default Topaz 8 font, so if you notice that text does not fit properly in boxes or on the screen, you may need to alter your Workbench setting and restore 'Topaz 8' as the default font. Registration Details If you have already registered, then ignore this section. There are two options you have if you wish to Register. You may: 1. Register for Classic Solitaire only You have the option of registering for Classic Solitaire only, which will provide you with the Registered version of the game, any changes or bug fixes, and the next major upgrade. This means you will receive all versions 1.xx and version 2.00, if I write it. I'm hoping that the game is so good that there will never be a need for version 2...... 2. Register for the complete package This must be the best value in Amiga card games of all time! Users who register for the complete package will receive registered versions of all of the card games in the set, any changes or bug fixes for all games in the set, and the next major upgrade for each game in the set. In addition, I'll also send you registered versions of any new card games I add to the set. This means that you will receive all version 1.xx and version 2.00 (if and when they are written) for all games currently in the set, and registered versions of any new games which I add to the set. For details on which card games are currently supplied with the set, see the section below titled "The complete package". The price.... To register for either Classic Solitaire only, or for the complete package, send the appropriate amount to: Perry Rosenboom Box 333 Wantirna South Victoria, 3152 AUSTRALIA To make registration easier, you can send local currency (cash please) in the following amounts: Classic Solitaire Only Complete Package Australia $10.00 $20.00 New Zealand $15.00 $30.00 England £5.00 £10.00 United States $10.00 $20.00 Germany Dm 10,00 Dm 20,00 Canada $10.00 $20.00 Please send cash only, as our banks act like robbers and can charge us $6.00 to change a cheque! Cheques in Aus$ drawn on an Australian Bank are also acceptable. Prices for each individual country are based mainly on the current exhange rate that the country has with Australia. Why so inexpensive for the complete package? Because the high price of quality Amiga games prevents many Amiga owners from buying games. I plan to make my millions by asking for a fair registration fee from fellow Amiga Users, and registering thousands of users, instead of ripping off a few people. Also, I've tried to make the whole process as painless as possible by putting in local currency values for countries where I know some of my previous games have been. I understand that not everyone happens to have a few Australian dollars sitting in their cookie jar! Well, that's the plan, and those are the reasons - The rest is up to you! Distribution of Classic Solitaire and other boring terms and conditions The SHAREWARE Version of Classic Solitaire may be freely distributed, providing this documentation file accompanies the game. Neither the Game or this documentation may be altered in any way without the Author's written permission. No more than a reasonable fee for copying and distribution should be charged for the Shareware Version of Classic Solitaire. Registered Versions of Classic Solitaire are provided only to the registered user and are not to be copied or distributed under any circumstances, unless prior permission has been provided in writing by the Author (after all, a great deal of time has gone into writing this game). The title screen and the "About" screen clearly states whether the game you are playing is the shareware version or registered version. The Complete Package At the time of writing this documentation, one game has been fully completed. However, I intend to produce a package with a minimum of SIX games. These will include Classic Solitaire (Klondike), Cruel, Tut's Tomb, Tri Peaks, Golf, and Cleopatra. If you have some thoughts on particular games which you would like to see included in the package, then please write to me! Thanks My sincere thanks go to the following people: Therese and James (my wife and son) for putting up with the amount of time I spend writing card games, shoot'em up's and thinking games. A two year old can really test the error handling qualities of a piece of software! Andrew Kreibich for finding bugs (not that I really want to thank people for finding bugs), and for his ideas and some of the code (such as the button routine). Rene Katoll (Germany) for his many faxes, letters and the translation of this document into German. Ulla Katoll (Germany) for designing the Solitaire icon for this game (the icon is Copyright © 1992, Ulla Katoll and is used with permission). Classic Solitaire is written using AMOS and compiled with the AMOS Compiler, both of which are © Europress. Thank you to all who register. As with my other games, I'll name you all in the next release of the game. Copyright Classic Solitaire is Copyright © 1992, 1993 by Perry Rosenboom, as are the card backs and the cards themselves (you wouldn't believe how long it took to draw them!). If you would like a special version for release on a coverdisk, then please write to me. If you program in AMOS and would like to use the cards that I've designed for your own games, then please let me know when you register.