234 lines
5.8 KiB
Plaintext
234 lines
5.8 KiB
Plaintext
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.
|
|
|