Caprice32 - Amstrad CPC Emulator
(c) Copyright 1997-2004 Ulrich Doewich

http://sourceforge.net/projects/caprice32/

..........................................................................

WHAT IS IT?
~~~~~~~~~~~

Caprice32 is a software emulator of the Amstrad CPC 8bit home computer
series. The emulator faithfully imitates the CPC464, CPC664, and CPC6128
models. By recreating the operations of all hardware components at a low
level, the emulator achieves a high degree of compatibility with original
CPC software. These programs or games can be run unmodified at real-time
or higher speeds, depending on the emulator host environment.


..........................................................................

USAGE
~~~~~

This is considered and alpha release, as the emulator in its current
state lacks a lot of user friendliness (i.e. it lacks a graphical user
interface).

Open cap32.cfg in a text editor (Notepad for example) and edit values as
necessary. Refer to the next section for an explanation of what it all
means. Make especially sure the rom path reference is correct otherwise
the emulator will fail to start!

To load a disk, snapshot or tape image simply specify the complete path
to the file on the command line. You can pass more than one type of file
at the same time - simply separate them with spaces. Paths and filenames
that contain spaces need to be enclosed by quotes.


..........................................................................

THE CONFIG FILE
~~~~~~~~~~~~~~~

[system]

model
        Defines the CPC model to emulate CPC464, 664 or 6128
        Range:   0-2
        Default: 2

ram_size
        RAM size in 64K increments
        Range:   64-576
        Default: 128

speed
        emulation speed in 25% increments
        Range:   2-32
        Default: 4

keyboard
        keyboard layout to use
        Range:   0 = original CPC
                 1 = French CPC
                 2 = Spanish CPC
        Default: 0

[video]

scr_width
        width of video mode to use for fullscreen display
        Range:   320-
        Default: 800

scr_height
        height of video mode to use for fullscreen display
        Range:   200-
        Default: 600

scr_bpp
        bits per pixel of video mode to use
        Range:   8,15,16,24,32
        Default: 8

scr_style
        rendering style
        Range:   0 = scanlines
                 1 = normal size, no scanlines
                 2 = double width
                 3 = half size
                 4 = half size with hardware flip
                 5 = Super Eagle
                 6 = Scale2x
                 7 = Advanced Scale2x
                 8 = TV 2x
                 9 = bilinear filter (in software)
                10 = bicubic filter (in software)
                11 = dot matrix
                12 = OpenGL, no scanlines
                13 = OpenGL, 25% scanlines
                14 = OpenGL, 50% scanlines
                15 = OpenGL, 75% scanlines
                16 = OpenGL, 100% scanlines
        Default: 0

scr_oglfilter
        controls whether or not to apply filtering in OpenGL modes
        Range:   0-1
        Default: 1

scr_fps
	controls FPS counter display
        Range:   0 = hide
                 1 = show
        Default: 0

scr_tube
        colour or green (monochrome) monitor
        Range:   0 = colour
                 1 = green
        Default: 0

scr_intensity
        colour intensity control
        Range:   5-15
        Default: 10

scr_remanency
        blends the last and current frame together to reduce screen
        flicker in apps/demos that flip screens quickly to simulate more
        colours
        Range:   0-1
        Default: 0

scr_window
        start in windowed or fullscreen mode
        Range:   0 = fullscreen
                 1 = window
        Default: 1

[sound]

enabled
        control sound emulation
        Range:   0-1
        Default: 1

playback_rate
        sound playback frequency in kHz
        Range:   0 = 11025
                 1 = 22050
                 2 = 44100
                 3 = 48000
                 4 = 96000
        Default: 2

bits
        bits per sample
        Range:   0 = 8
                 1 = 16
        Default: 0

stereo
        mono or stereo output
        Range:   0 = mono
                 1 = stereo
        Default: 1

volume
        sound volume in percent
        Range:   0-100
        Default: 80

pp_device
        controls emulation of the DigiBlaster on the CPC printer port
        Range:   0-1
        Default: 0

[control]

kbd_layout
        the PC keyboard layout
        Range:   0 = US
                 1 = French
                 2 = Spanish
        Default: 0

[file]

drvA_path
        path to a DSK file, or PATH+ZIP for a ZIPped up DSK

drvA_file
        name of the DSK file

drvA_zip
        indicates whether or not we're dealing with a compressed DSK
        image
        Range:   0-1


..........................................................................

KEYS
~~~~

F1       switch between windowed / fullscreen mode
Ctrl+F3  PLAY button on virtual tape deck
F5       reset
Ctrl+F8  toggle joystick emulation on / off
F10      quit
F12      toggle regular / full speed
Ctrl+F12 show / hide FPS (Frames Per Second) counter

..........................................................................

SOURCE CODE AVAILABILITY
~~~~~~~~~~~~~~~~~~~~~~~~

The most recent source code release is always available from the
Caprice32 project page on SourceForge.net - see the URL at the top.


..........................................................................

COMMENTS OR READY TO CONTRIBUTE?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you have suggestions, a bug report or even want to join the
development team, please feel free to use one of the many contact methods
presented on the Caprice32 project page on SourceForge.net - see the URL
at the top.