********************************************************************************
Herg's Solitaire for Gameboy Advance
Last updated 9/27/2003
********************************************************************************
If you have any comments, criticism, or suggestions, email me - herg@bigfoot.com
********************************************************************************

********************************************************************************
Games
********************************************************************************
Klondike
Freecell
Tripeaks
Pyramid
King's Corner
Yukon
Scorpion
Aces Up
Golf
Canfield
Spider
Double Freecell
Sir Tommy
Carpet
Stonewall
Cruel
Montana*
Topsy Turvy Queens

*Montana written by SmileyDude

********************************************************************************
Controls
********************************************************************************
R+L:            redeals cards
R/L+select:     changes game
R/L:            scroll down/up
start:          brings up options menu
d-pad:          moves pointer
A:              main action
B:              secondary action
sel+start+A+B:  jump out to main menu (Pogoshell,FAW,LW,etc)
sel+start:      awake from sleep mode

********************************************************************************
Statistics Screens
********************************************************************************
right/left:	view stats for next/previous game
A:		deal cards to play currently displayed game
start/B:	exit statistics without starting new game

********************************************************************************
Cursor Movement modes
********************************************************************************
Set pointer speed to 0 for Jump mode control

Normal mode:    works like a computer mouse pointer
Jump mode:      jumps to the closest card/hole in the direction pressed

********************************************************************************
Background / Color Selection
********************************************************************************
LEFT and RIGHT selects color component to modify, UP and DOWN adjusts the value
To return to random color selection, decrease all colors to the lowest value

While in the color select menu, you can change background design by holding L
and pressing left or right on the control pad

Steps to add your own background designs
1-Create a 240x160 pixel image of 16 shades of gray
  The easy way to convert from other color modes is using Photoshop.  Change to 
  Indexed Mode, Custom, and load the background.act palette included in the
  backgrounds archive.  Dither to taste, and save as a 4bit BMP.
2-Run addbkg <bmpfile> <romfile>
  ex. addbkg bkg_solid.bmp "Herg's Solitaire.gba"

You can also change cardbacks by holding R and pressing left or right on the 
control pad

Steps to add your own cardback designs
1-Create a 24x32 pixel image of 16 colors (only 15 may actually be used)
  The easy way is to use Photoshop to change to Indexed Mode, Local (Perceptual)
  with 15 colors, and dither to your preference, and save as a 4bit BMP.
2-Run addcrdbk <bmpfile> <romfile>
  ex. addcrdbk card_red.bmp "Herg's Solitaire.gba"

Make sure to use the latest "addbkg" and "addcrdbk" that is included in the zip file.
If you don't have it, go to http://www.geocities.com/hergtoler/gbdev.html.

There are more backgrounds and cardbacks in the graphics archive.  This is a 
separate download from the game.  Only step 2 needs to be done to add these to the rom.

********************************************************************************
Link Transfer
********************************************************************************
1-Start the receiving Gameboy without a cartridge inserted and the 2P end of the
  link cable connected.
2-With the 1P end connected to the sending Gameboy, select Send Game Via Link.
3-Once the transfer has finished, you can disconnect the cable.  The game and the
  currently selected background are sent to a second Gameboy Advance and will 
  remain in memory until the power is turned off.
