    --
Readme file for   qCards  Solitaire 1.0  1/15/1998

Solitaire is a 100% graphical game for the TI-92 calculator, it takes about 8K of memory(total).  

Author:  Graham Anderson
email:  ande2115@tc.umn.edu

****Starting*****
Type :    solitare()      or       qcards\solitare()
After launching solitare, it will take about 10 seconds to shuffle the cards.  Then the cards will be dealt out.  There are 7 columns, 1 pile and 4 suit stacks.  
****Keys used****
arrow keys:  used for selecting a card or cards.
F1-F7: used to move cards to a column.  F1 for the left column, F7 for the rightmost column.
F8     : used to move a card to the suit stack.
APPS:  press this key to shuffle through the pile.  It goes 3 cards at a time.  When you get to the bottom of the pile you must press APPS again to reset the pile.
LN  :  automatically moves all the cards it can from the columns to the suit stacks.
ESC:  Typing this brings up a menu.
            1. Continue
            2. New Game ---- shows your stats
            3. Quit --------- make sure you always quit this way(to save memory)
            4. Help
            5. About -------- shows version #; should be 1.0
      **When this menu is showing you can press Diamond-ON to turn off the
                  calculator and continue the game later.

****Game Play Notes****
If more cards are in a column than will fit in the display, an arrow will appear indicating that there are more cards off the screen.
If there is an "up arrow" at the top of a column, but you can't access the cards, that means the cards above the arrow are face down, and cannot be selected.

The game is won when all the cards are sequentially stacked in the lower-right corner.  
LN may be useful for this.

****Installation****
	Make sure that all the files are installed in the folder "qcards".  The graph link will do this automatically.  It would be best if only "qcard" variables are stored in that folder.

Note for people who want to install more than 1 "qcard" program:
	It is very possible that more "qcard" programs will be released that should be placed in the "qcards" folder.  You should replace all variables with the newest versions(see date at top of readme file).

****Problems? Comments?****
Send to:     ande2115@tc.umn.edu

****For TI-92 basic programmers****
Please contact me if you wish to write a "qcard" program--or modify a utility routine or var.

Included vars: (pack release 1 [one])
main:      solitare
Picture:  bck,blank,clb,dmd,ec,hrt,pci,spd,wci
Prgm:     boxstr,drwcrd,qinit,shuffle,wsls,winit
Func:      dli,sface,ssuit


****FAQ's****
What's up with "qcards"?
Since there several programs I wrote that use cards, I decided that it would save memory if they could be integrated.  A "qcard" program is any game that uses these set of pictures and utility programs.   I chose "q" because it comes after "m".

Why can I move any card to the empty columns?
I don't know the official rules for sure, so you can make up your own.   As far as I know, you're only supposed to move Kings to the empty columns, but if all four kings are placed, then you can move any card there.