slackbuilds_ponce/system/caprice32/usage.txt
Dimitris Zlatanidis ee23eb60af system/caprice32: Added (CPC Emulator).
Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
2014-11-14 07:53:09 +07:00

233 lines
5.8 KiB
Text

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.