This is a very preliminary HOWTO document to get started with the CD-i
Emulator program. It is accurate as of version 0.5.2. See also the
RELNOTES document.

1. Obtain CD-i system ROM files. You can upload them from a CD-i player
with the cdilink program or get them elsewhere. Note that these ROM
files are copyrighted and cannot be freely distributed, but using them
for emulation purposes should be allowed as long as you own the CD-i
player they where obtained from. Put these files in the "rom" directory.

2. Obtain one or more CD-i disc image files using IsoBuster, CloneCD
or other software. The present version of cdiemu supports only "raw"
disc image files. Nearly all CD burning or grabbing software can produce
such files; sometimes you have to select the "track-at-once" format.
These files can be put anywhere, but it's probably easiest to put them
in the "disc" directory intended for this purpose.

3. Start the emulator by double-clicking the wcdiemu.exe file in Explorer
or use Start | Run and type "wcdiemu" followed by Enter.

4. Open a CD-i disc image file using File | Open. You can also use the
File | Select menu choice to select from a list of previously opened
files.

5. Press the "Start" button or use the Emulate | Start menu choice.
This will start the emulation. If you have a limited edition, emulation
is limited to three minutes between CD-i player resets and you cannot save
the contents of NVRAM such as high scores and other CD-i title settings.

6. Many emulator settings can be changed via the menu bar or the dialog
under the Options | Settings menu choice. Some settings, however,
can only be changed from the command line. You can use a DOS prompt,
but it is usually easier to use Start | Run.

7. Using an unrecognized option will display the cdiemu usage message:

	CD-i Emulator version 0.5.2 for Windows
	Usage: wcdiemu OPTION...
	Function: Emulates CD-i player on Windows
	Options:
	   -joypoll RATE        Polls joystick at RATE Hz; default is 25
	   -joyswing NUM        Joystick swing NUM pixels; default is 24
	   -joydead PERC        Joystick dead zone PERC %; default is 20%
	   -joysteps NUM        Joystick min to max in NUM steps; default is 3
	   -disc FILE           Emulates CD-i disc from FILE; default is none
	   -sys[tem] FILE       Builds system using FILE; default is cdisys.bld
	   -rom[files] FILE...  Specifies ROM files to use; default is *.rom
	   -term[inal] NAME     Connects terminal to port NAME
	   -rules FILE          Reads rule file; default is cditypes.rul
	   -m[odel] MODEL       Specifies CD-i model type to emulate
	   -ext[end] EXT        Specifies CD-i extension type to emulate
	   -dvc[art] DVC        Specifies CD-i DV cartridge type to emulate
	   -playcdi             Immediately plays CD-i application (no player shell)
	   -set NAME[=VALUE]    Sets variable for system building
	   -pal                 Specifies PAL video mode (768x560, 50Hz)
	   -ntsc                Specifies NTSC video mode (720x480, 60Hz)
	   -trace               Displays trace output
	   -debug               Invokes debugger immediately
	   -run FILE            Runs debugger commands from FILE
	   -b[oot]v[erbose]     Boots player verbosely on serial port
	   -b[oot]si[lent]      Boots player without messages (CD-i 60x only)
	   -b[oot]sh[ell]       Boots OS-9 shell on serial port (CD-i 60x only)
	   -test[plug]          Simulates test plug (boots service shell)
	   -setdef[aults]       Sets default settings
	   -no*                 Ignores option or default setting; * means all

8. You can play with the various options to see what happens.

Have fun!
