This is a very preliminary HOWTO document to get started with the CD-i
Emulator program. It is accurate as of version 0.5.3-beta2. 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 "raw"
disc image files and CHD (Compressed Hunks of Data) files compatible
with MAME/MESS. Nearly all CD burning or grabbing software can produce
raw files; sometimes you have to select the "track-at-once" format.
You can produce CHD files with the MAME/MESS "chdtool" program.
Disc image 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-v053b2.exe file
in Windows Explorer.

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.

This beta version will function as a limited edition unless you have
already activated an unlimited edition v0.5.2 on your machine or you're
using a Philips Mono-I player system ROM (200 F1, 210 F1, 220 F2).

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.3-beta2 for Windows (Limited edition)
   Usage: wcdiemu-v053b2 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
      -keydelta DELTA[,DELTA]  Keyboard delta value(s) for pointer
      -writewav FILE           Write WAV audio to specified file
      -writeavi FILE           Write AVI movie to specified file
      -writepng FILE           Write PNG images to specified files
      -writesilent             Write silent movie (no audio)
      -writerate RATE          Write movie file with RATE frames/sec
      -writescale SCALE        Write movie file with scaled down by SCALE
      -writeview VIEW          Write movie file from VIEW; default is window
      -disc FILE               Emulates CD-i disc from FILE; default is none
      -select[disc] [SEARCH]   Emulates CD-i disc selected with SEARCH
      -nvram FILE              Loads CD-i NVRAM from FILE; default is MODEL.nvr
      -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
      -start                   Start emulation immediately (default is to wait)
      -startdisc               Start emulation when a disc is found
      -playcdi                 Immediately plays CD-i application (no player shell)
      -record FILE             Records input to specified file
      -playback FILE           Plays back input from specified file
      -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
      -wait                    Waits after fast frames (default)
      -skip                    Skips frames to adjust speed (default)
      -no*                     Ignores option or default setting; * means all

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

Have fun!
