Classic99 is an incomplete emulator - therefore it's currently a manual process to get it to load
something. Here's what you do.

TI Console ROMS
---------------
These are required in order to run the emulator at all. Put the files 994AROM.BIN and 994AGROM.BIN into the
MODS\ subdirectory. Edit the file 'TIDATA' which should be in the same folder as CLASSIC99.EXE. (Use
Notepad or similar.) Search for these lines:

; *** Console ROM and GROM - these are required!
C 0000 2000 mods\994AROM.BIN
G 0000 6000 mods\994AGROM.BIN

Make sure they look like that (ie: the 'C' and 'G' lines do NOT start with a semicolon (;). )
If you have ROMs other than 994AROM.BIN and 994AGROM.BIN you will find plenty of examples how to set them
up, but you will need to know what the files actually are inside.

When you run CLASSIC99.EXE, you'll see the Master Title Screen (with the color bars), and will be able to
press a key and select TI BASIC.


Cartridge ROMS
--------------
Installing a cartridge ROM is similar to the console ROMs. You should only ever enable ONE cartridge at a
time, results are otherwise unpredictable (but usually only the last cartridge listed will work, even if
they all show up in the list).

Copy your ROM files into the MODS\ directory. Next load up TIDATA in your editor. You can search for the
cartridge, and if it already exists, simply remove the semicolons from the G, C and D lines (whichever
exist) to enable that one. Make sure all of the other cartridges DO have semicolons to disable them. IE:

; *** Parsec - Works
G 6000 6000 MODS\PARSECG.BIN
C 6000 2000 MODS\parsecc.bin

; *** Picnic Paranoia - Works
;C 6000 2000 MODS\PICPARNC.BIN
;X 6000 2000 MODS\picparnd.bin

Parsec is enabled, and Picnic Paranoia is DISABLED.

If the ROMs you have are not listed already, you will need to work out what they are. The TI uses three
types of ROM in cartridges: GROM (G), ROM (C) and ROM bank 2 (Classic99 uses 'X', many ROM filenames use
'D'), and thankfully it's pretty standard. Read through CLASSIC99.TXT for instructions on the TIDATA file
layout.

Save the file, and run CLASSIC99.EXE. Press a key on the title page and select the cartridge from the list.


Disk Images (*.DSK)
-------------------
These are not ROMs, although the emulation community has taken to calling anything used with an emulator a
ROM. These are images of diskettes made popular by PC99 and V9T9. Classic99 does not currently handle disk
images very well (perhaps not at all, I haven't tested it in a while). Classic99 prefers to use files on
the hard drive as the TI File System lends itself wonderfully to expansion and we can reduce the
limitations of the original disk system this way. ;) But, eh, I'll add it in later.


Arc303 Files
------------
Arc303 is the TI's equivalent of ZIP files - they are compressed files that usually contain more than one
other file.

Usually these end with an '@' character to indicate they are archived. You will first need to obtain a copy
of Archiver 303 (I believe it's legal for me to post it, so I will). You will also need to set up the
emulator for disk access.

First, create a folder in the Classic99 folder for the disk. You can have up to 9 folders right now.
Typically I use names such as DSK1, DSK2, etc, which match the TI convention.

Edit the TIDATA file, and for each folder you wish to use, enter a line like follows:

#disk 1 t DSK1\

#disk tell the emulator you are creating a disk folder
'1' tells it which disk (1-9)
't' tells it to write TIFILES style files here. This is preferred. 'v' for V9T9 works although is less
tested, and 'r' for raw files is still in the code, but writing will often fail. This mode is not required
when reading a file - Classic99 will autodetect the type.
DSK1\ is the folder name to use.

You must also ensure that Classic99 is loading the emulated Disk ROM. Ensure that this line is enabled:

; *** Special header file for Classic99 disk DSR
C 4000 0130 mods\AMI99DSK.BIN

And also ensure that AMI99DSK.BIN is in the MODS\ folder.

Finally, you will need the Editor/Assembler OR 'SuperCart' to run ARC303. They're both the same GROM, one
just includes RAM. On Classic99, ALL Editor/Assemblers are SuperCarts. ;) Anyway.. ensure that you have the
Editor/Assembler or SuperCart GROM file in the MODS\ folder, and enabled as the cartridge in TIDATA.

Copy the ARC303G file into the disk folder that you wish to use. Also copy the archived file (@) into any
of the disk folders.

The example assumes you are putting everything into DSK1. If not, just substitute the correct drive number.

Start CLASSIC99.EXE. Select Editor/Assembler from the main menu. Next select '5 RUN PROGRAM FILE' from the
Editor/Assembler menu. (Thus the term 'E/A #5'). Enter 'DSK1.ARC303G'.

Press a key to pass the Shareware notice, then select '2) Extract Files'. Enter your source drive (1), and
the name of the '@' file for Source Filename. Select your output drive (may still be 1), and for 'Extract
all files?' you will usually say 'Y'. If you select the same source and output drive, it will also ask
'Swap Disks?', of course with Classic99 you may say 'N'.

You'll see 'BACK / REDO / Any Key to Begin', just hit the space bar and the files will be extracted. You
can then quit the archive program and move on to running the files themselves.


TI BASIC files
--------------
No cartridges are required to be enabled.

Select TI BASIC from the main menu. The system will report 'TI BASIC READY' and provide a cursor.

You will almost certainly need CPU THROTTLING on - it's under Options. The keyboard repeat is just too
touchy.

Enter 'OLD DSK1.FILENAME', where 'DSK1' is the disk folder you have the file in, and 'FILENAME' is the name
of the file. Note that the TI likes everything in uppercase, but it often doesn't matter with Classic99.

Once it loads successfully, 'RUN' will start it up. (For programs that you don't have to type in, turning
CPU throttling back off at this point makes slow programs more bearable.)


EXTENDED BASIC files (XB)
-------------------------
You must have Extended BASIC enabled as the cartridge in TIDATA.

Select Extended BASIC from the main menu. The system will report '* READY *' and provide a cursor.

You will almost certainly need CPU THROTTLING on - it's under Options. The keyboard repeat is just too
touchy.

Enter 'OLD DSK1.FILENAME', where 'DSK1' is the disk folder you have the file in, and 'FILENAME' is the name
of the file. Note that the TI likes everything in uppercase, but it often doesn't matter with Classic99.

Once it loads successfully, 'RUN' will start it up. (For programs that you don't have to type in, turning
CPU throttling back off at this point makes slow programs more bearable. In XB it usually will not affect
the speed of sprites, but it will improve the responsiveness!)


PROGRAM IMAGE files (E/A#5)
---------------------------
You must have Editor/Assembler or SuperCart enabled as the cartridge in TIDATA.

Select Editor/Assembler from the main menu. Select '5  RUN PROGRAM FILE' from the menu. For 'File Name?',
enter 'DSK1.FILENAME', where DSK1 is the disk you have the file(s) on, and FILENAME is the first file
listed. Program images were limited to 8k, so for programs larger than 8k, multiple files were created by
adding 1 to the last character of each name. Some programs numbered the files (ie: POPEYE1, POPEYE2,
POPEYE3), but many just let the last letter increment (ie: LASSO, LASSP, LASSQ).

Program files will autostart after being loaded.


OBJECT FILES (E/A#3)
--------------------
It's very rare to come across these as Program Images were faster, smaller, and easier to load, however,
just in case...

You must have Editor/Assembler or SuperCart enabled as the cartridge in TIDATA.

Select Editor/Assembler from the main menu. Select '3  LOAD AND RUN' from the menu. For 'File Name?', enter
'DSK1.FILENAME', where DSK1 is the disk you have the file(s) on, and FILENAME is the file you are currently
loading. It's possible, though even more rare, to have to load more than one file.

If the program does not autostart after loading the file(s), hit Enter on the 'File Name?' prompt to enter
a blank line. You will be prompted with 'PROGRAM NAME?', which unfortunately you need to know. However,
most E/A#3 files use 'START'.


USING TI PROGRAMS
-----------------
Many programs refer to 'REDO', 'BACK', etc, keys that are not immediately obvious. The TI used FCTN and the
number keys for these special terms, so on Classic99 it's Alt and the number key. They are laid out as
follows:

1 - DELETE
2 - INSERT
3 - ERASE
4 - CLEAR       ( Stops a BASIC or XB program)
5 - BEGIN
6 - PROCEED
7 - AID
8 - REDO
9 - BACK
= - QUIT        ( Restarts the TI)

Arrow Keys:
E - Up
S - Left
D - Right
X - Down

Extra characters:
~ - W
[ - R
] - T
_ - U
? - I
' - O
" - P
| - A
{ - F
} - G
\ - Z
` - C

