summaryrefslogtreecommitdiff
path: root/system/caprice32/usage.txt
diff options
context:
space:
mode:
Diffstat (limited to 'system/caprice32/usage.txt')
-rw-r--r--system/caprice32/usage.txt233
1 files changed, 233 insertions, 0 deletions
diff --git a/system/caprice32/usage.txt b/system/caprice32/usage.txt
new file mode 100644
index 0000000000..a5235753a3
--- /dev/null
+++ b/system/caprice32/usage.txt
@@ -0,0 +1,233 @@
+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.
+