ReadMe for "I've Got Money!" Apple II Version by Bill Buckels Introduction "I've Got Money!" is an Apple II program that was distributed in the early 1990's by Class Software in Winnnipeg, Canada in both an English and French Version. It was intended for use as "CourseWare" in Canadian Classrooms for teaching Elementary School children the arithmetic required to use coins to "make change". The French Version of "I've Got Money!" is called "J'ai des sous!". History "I've Got Money!" was originally developed for use on the IBM-PC by French Canadian "CourseWare" developers Denis Coulombe and Robert Boivin on behalf of Centre de recherche appliquée pour l'ordinateur (CRAPO) in 1989 and marketed to schools across Canada as part of a six program set called "Collection Les Petites espadrilles". Note: Espadrilles are casual flat sandals originating from the Pyrenees. In Quebec French, however, espadrille is the usual term for running shoes. The Apple II version was written by Canadian Software Developer Bill Buckels on the IBM-PC in the C programing language using the Manx Aztec C 6502 Cross-Compiler. It was completed in mid-1991. Bill did not have the source code for the IBM-PC version of the program and it wouldn't have helped much anyway. The IBM-PC was a much more capable and sophisticated platform than the Apple II, so producing "I've Got Money!" for the Apple II required a complete rewrite "from the ground-up". The Manx C compiler provided a rudimentary Graphics Library, but came nowhere close to what Bill needed to complete "I've Got Money!" and the 3 other programs in the "Collection Les Petites espadrilles" that he had undertaken to write. So he set to work to create the graphics and the sound routines that the Apple versions needed to behave as closely as possible to their IBM-PC counterparts. The IBM-PC graphics of the day that CRAPO used (4 Color CGA Mode) were vastly different from Apple II graphics (which were a coarser resolution), and each and every screen and graphics image needed to be redrawn, and reformatted for the Apple II. Using the Graphics from the IBM-PC version as a starting point, Bill developed his own Apple II graphics file formats and programmed his own set of conversion tools which he ran on the IBM-PC to produce the Apple II graphics after creating and editing these in IBM-PC format to suit the Apple II display. He did this in conjunction with writing his Manx C graphics library, since both tasks were complimentary. When the graphics images and graphics and sound library routines were completed he moved forward to writing the program. Not only did the Apple II have less capable graphics than the IBM-PC; it also ran more slowly with only 128K of memory, some of it unusable, and with slower disk access and a smaller floppy disk size. To overcome all of this Bill broke his Manx C Apple programs into small modules called "overlays" which ran in very little memory, and he used the upper ram bank of the Apple II to store his graphics libraries and other data to avoid loading from disk where possible. Since the Manx C compiler translates its programs into machine language which runs as quickly as can be on the Apple II, no optimization or additional "tweaks" were required, except to script the game levels using external scripts (also of Bill's design) which further saved on disk space and program memory, and which avoided slow processor intensive operations that would otherwise have been needed. The finished result runs more slowly than its IBM-PC counterpart, but for all practical purposes, "I've Got Money!" for the Apple II has all the same functionality. System Requirements "I've Got Money!" requires an Apple IIe with 128K of memory and a floppy disk. It runs under the PRODOS 8 Operating System. It can also be run from a disk image file in an Apple II emulator. It has been tested in Windows XP using Apple II Oasis and AppleWin, and probably works in others. Starting "I've Got Money!" "I've Got Money!" comes with PRODOS 8 on the distribution disk so no PRODOS Startup Disk is required. Put the "I've Got Money!" disk in the floppy drive and boot the computer. After the program loads, follow the instructions. If you are running "I've Got Money!" in an emulator, follow the same basic steps. If you are using the AppleWin emulator from Windows XP Explorer and have File Associations set to use AppleWin to load disk images, just click on the disk image. If you are using Apple II Oasis select the disk image from the Apple II Disk Manager and send to emulator by right clicking on the disk image. Other emulators should be basically the same if they work with PRODOS 8 disk images. If you are using an Apple that boots from a hard disk and will run PRODOS 8 programs, just run MONEY.SYSTEM on the "I've Got Money!" disk. Note: If you need to restart "I've Got Money!", it will start more quickly since the graphics are already loaded into the upper ram bank. Keys and Navigation The Arrow Keys are used to navigate the menus and to select choices during activities (Game Play). The [RETURN] Key or the Space Bar can be interchangeably used to enter selections. The Escape Key is used to return to the Main Menu and to Exit the program. The Sound Toggle Key - [CTRL] S toggles the sound on or off at the Main Menu or during any of the activities. The 1 Key - Pressing the number 1 at the Main Menu or during Learning Activity 1 will set the high limit for Learning Activity 1 to 69 cents. This is "grade 1". The 2 Key - Pressing the number 2 at the Main Menu or during Learning Activity 1 will set the high limit for Learning Activity 1 to 99 cents. This is "grade 2". Note: Each time the Main Menu is displayed the default high limit of 69 cents is reset. There should be no need to press the 1 key unless the 2 key has been pressed and needs to be reset back to 69 cents from 99 cents before starting Learning Activity 1. The AlphaNumeric Keyboard keys are used where required to enter information during activities (Game Play) in all programs in the "Collection Les Petites espadrilles" including "I've Got Money!". When entering amounts the [RETURN] Key must be pressed after typing the numbers. A mouse is not supported. Splash and Title Screens When "I've Got Money!" starts, or when the Escape Key is pressed at the Main Menu the Class Software Splash screen is displayed. Press [RETURN]. When the Title Screen displays press [RETURN] for the Main Menu or press the Escape Key to exit the program. Main Menu Screen "I've Got Money!" has 3 Learning Activities (Games) which can be selected from the Main Menu by moving the Piggy-Bank Cursor with the Arrow Keys to the desired activity then started by pressing the [RETURN] Key. Each Learning activity is a Game formatted as a series of addition questions based on summing coin values to totals of less than one dollar. When each series of Learning Activities is complete, the Student is presented with a musical reward. Activities followed by musical rewards is the basic format of all the programs in the "Collection Les Petites espadrilles". The fourth Main Menu choice exits the Main Menu and returns to the Title Screens. It is the equivalent of pressing the Escape Key. Sound can be toggled on or off at the Main Menu or during any of the activities by pressing [CTRL] S. Coins Used in "I've Got Money!" There are 4 denominations of Canadian coinage used in "I've Got Money!": 1¢, 5¢, 10¢, and 25¢. In everyday speech they are respectively called the penny, nickel, dime, and quarter, although none of these names are official. These denominations correspond to those of United States coinage. The historical sizes of these are identical to those of U.S. coins due to both nations using the Spanish dollar as the basis of their money. In Canada, it is common to find U.S. 1¢, 5¢, 10¢, and 25¢ coins in circulation at par, and vice versa. In late 1937 the issue of the Canadian coins of the reign of King George VI was struck. The coins' current designs date from this period and are as follows: 1 Cent - A twig with two maple leaves. (Designer: George Kruger-Gray). 5 Cents - A beaver sitting on a log. (Designer: George Kruger-Gray). 10 Cents - The Nova Scotian racing yacht Bluenose. (Designer: Emmanuel Hahn) 25 Cents - A caribou's head. (Designer: Emmanuel Hahn) Activity 1: Make Change Game Play This activity interactively demonstrates the making of change of a required amount. A random group of coins will come-out of the Piggy-Bank on the left side of the screen and be displayed at the top left of the screen for each screen in the activity. To the right of the screen is a menu of each of the 4 coins (penny, nickel, dime, quarter). Any of these can be selected by moving the Piggy-Bank cursor using the Up Arrow and Down Arrow Keys, then pressing the [RETURN] Key. When the selected denominations total a greater coin denomination, change will be made. When the selected denominations equal the coins on the left side of the screen, the next game screen will be displayed. Activity 2: Enter Amount Game Play This activity interactively demonstrates summing coin values (coin addition). At the top of the screen a group of coins will be displayed. Amounts are entered using the numeric keys followed by pressing the [RETURN] Key. When the amount is correctly entered, the next game screen will be displayed. Activity 3: Enter Denomination Game Play This activity interactively demonstrates making a purchase using the 4 coin denominations by entering their amounts until the purchase amount is reached, and also demonstrates the making of change during the purchase. At the top of the screen a purchase amount and an item for sale will be displayed. Coin denominations are entered using the values 1, 5, 10, or 25 followed by pressing the [RETURN] Key. When the denominations entered total a greater coin denomination, change will be made. When the total of the entered denominations equal the purchase price, the item will be placed in the wagon at the bottom of the screen, and the next game screen will be displayed. End of ReadMe