+=========================+
| Ti-Boy SE - Alpha 0.0.2 |
+=========================+
A Nintendo Game Boy emulator for the TI-83+SE, TI-84+, and TI-84+SE graphing calculators.
Coded entirely by calc84maniac.
Presented by Outside the Box Programming in association with Omnimaga.

+---------------------
| Table of Contents
+---------------------
  1. What is this project?
  2. Features
  3. How to convert ROMs to APPs
  4. Save files
  5. Controls
  6. List of working/non-working games
  7. PAQ - Potentially Askable Questions
  8. Special Thanks
  9. Version History

+---------------------------
| 1. What is this project?
+---------------------------
  This is an emulator for the original grayscale Game Boys, although a bit incomplete (hence the Alpha version).
  Do not expect it to be able to run all games at full compatibility. Many games won't even run at all.
  And it's possible that some games will crash the emulator completely and cause a RAM clear.
  Also - do not run this on a TI-nSpire! It will crash!
  
+---------------
| 2. Features
+---------------
  * Three different zoom levels - 50%, 75%, and 100% (the Game Boy's screen resolution is 160x144 pixels, while the calculator's is 96x64).
  * Grayscale at the 75% and 100% zoom levels.
  * Three different palettes when in black-and-white mode.
  * Intuitive panning at 75% and 100%, using the numpad.
  * Sprite tracking at 75% and 100% (so it can automatically pan with your character).
  * Two different sprite tracking modes - center mode and platformer mode.
  * Two channels of sound if you plug headphones into the data port.
  
+----------------------------------
| 3. How to convert ROMs to APPs
+----------------------------------
  1. Download a Game Boy ROM from the Internet (I'm not telling you how, just use a search engine) or rip it from a cartridge yourself.
  2. Rename it to whatever you want the APP to be called on your calculator. (Example: naming it Pokemon.gb will make it be named Pokemon oncalc)
  3. Drag the ROM onto the batch file included in this package.
  4. Wait for the files to copy and for WabbitSign to create your APP.
  
+-----------------
| 4. Save files 
+-----------------
  Some games use save files. There are two different possible sizes: 8KB and 32KB.
  In each case, the save files will be saved in one or more 8KB appvars.
  Before you start the emulator, you must either have an appvar unarchived or have 8500 bytes of free RAM. It will give you a memory error otherwise.
  When you exit a game which uses a 32K save file, some of the appvars will be auto-archived.
  If you want to auto-archive all of the appvars, hold CLEAR while exiting.
  
+---------------
| 5. Controls
+---------------
  Calculator controls [WabbitEmu controls]
  Note: In WabbitEmu, pressing B will open the APPS menu.

  Game controls:
    Arrow keys: D-Pad
    2ND [LShift]: A
    ALPHA [LCtrl]: B
    ENTER: Start
    + [numpad +]: Select
  Emulation controls:
    ON [F12] Exit.
    CLEAR+ON [RShift+F12]: Exit and archive all save file appvars.
    STO> [X]: Turn sound on.
    LN [S]: Switch between 75% and 100% zoom.
    LOG [N]: Turn grayscale on/off.
    - [numpad -]: Select light palette for black-and-white.
    * [numpad *]: Select normal palette for black-and-white.
    / [numpad /]: Select dark palette for black-and-white.
    Numpad: Panning controls for 75% and 100% zoom. If pressed at 50% zoom, changes zoom mode.
    .: Selects 50% zoom.
    (-) [-]: Negative, not minus! Advances sprite tracker by one sprite. When zoomed in, press this button repeatedly until it pans to your character.
    0: Turn sprite tracking off.
    MODE [Esc]: Switch between center mode and platforming mode while tracking a sprite.
    
+----------------------------------------
| 6. List of working/non-working games
+----------------------------------------
  Great compatibility:
    * Tetris
    * The Legend of Zelda - Link's Awakening
    * Metroid II - Return of Samus
    * Kirby's Dream Land
    * Harvest Moon GB
    * Ultima: Runes of Virtue
    * Bugs Bunny - Crazy Castle
    * Bugs Bunny - Crazy Castle 3

  Good compatibility (has a few issues):
    * Super Mario Land 2: 6 Golden Coins
    * Pokemon Red Version
    * Bomberman GB
    * Mega Man - Dr. Wily's Revenge
    * Game & Watch Gallery

  Not working or not playable:
    * Super Mario Land
    * Super Mario Land 3: Wario Land
    * Kirby's Dream Land 2
    * Bubble Bobble
    * Donkey Kong Land
    * Battle City
    * Bubble Ghost
    * Bugs Bunny - Crazy Castle 2
    * Cool Spot
    * Faceball 2000
    * Mystic Quest
    * Spot : The Cool Adventure
    * Spy vs Spy - Operation : Boobytrap
    * Stranded Kids
    * The Simpsons - Bart & The Beanstalk
    * The Simpsons - Bart vs. The Juggernauts
    * Worms

  Everything else:
    * Feel free to test it out in WabbitEmu!
    
+------------------------------------------
| 7. PAQ - Potentially askable questions
+------------------------------------------
  Have a question not listed here? Ask at the forums: http://www.omnimaga.org/index.php?board=41.0
  
  Q. Why doesn't my ROM work?
  A. Sorry, nothing I can do about that now. Try to find a different one.
     This alpha release was made so people can play the games which are already compatible.
  
  Q. Why did my calculator crash?
  A. Did you try the app in WabbitEmu first? Sorry, I can't guarantee complete stability at this point.
  
  Q. Why did I get a memory error?
  A. Try freeing at least 8500 bytes of RAM before using the emulator.
  
  Q. How do I get a calculator ROM for WabbitEmu?
  A. Search on ticalc.org for Rom8x.
  
  Q. Why is WabbitEmu sort of buggy?
  A. The version I included is an unofficial release, because the official release is unable to run TI-Boy SE.

  Q. Where is the WabbitEmu and WabbitSign source code?
  A. http://svn.revsoft.org/wabbitemu , http://www.revsoft.org/wabbit.zip
  
  Q. I deleted an APP, and now the emulator is messed up!
  A. This, unfortunately, is due to a glitch in the TI-OS. Resend the emulator and you should be fine.
     Alternatively, you can install the OS patch located in the fix_defrag folder (make sure to read its readme!)
  
  Q. How do I hear the sound?
  A. Go to Radioshack and buy a 2.5mm-male to 3.5mm-female adapter. Then plug one end into your calculator's data port and plug headphones into the other end.
     Note that you should only plug them in after the emulator is running, because otherwise it will make the TI-OS unresponsive until you remove them.
  
  Q. how do i tern on my claculater
  A. ...
  
+---------------------
| 8. Special Thanks
+---------------------
  * Nintendo, for being so awesome.
  * Nitro2k01 (from gameboydev.org), for all of his help and support with understanding the Game Boy's hardware and software.
  * Spencer (from revsoft.org), for updating WabbitEmu to support the obscure hardware features I used, and also for SPASM and Wabbitsign.
  * Michael Vincent, for inspiring me with Emu8x.
  * FloppusMaximus and BrandonW, for making the defrag fix possible.
  * Omnimaga, for providing a place to showcase my project and receive feedback. :)
  * The entire TI calculator community, for suggestions and motivation.
  
+----------------------
| 9. Version History
+----------------------
  Alpha 0.0.1
    * First release.
  Alpha 0.0.2
    * Temporary workaround for bad app signing on some systems.
    * OS patch included to fix bad defragmenting.
    * Readme updated to include WabbitEmu controls.
    * Sample graphics demo ROM and APP included.