system/caprice32: Added (CPC Emulator).

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

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.
+